cli

npm: docbin

docbin push uploads a file straight to docbin from your shell. it exists for large documents - build logs, reports, generated files - that you do not want to paste into a chat or an MCP tool call, where the contents would stream through the model and time out.

install

npm i -g docbin
# or run without installing:
npx docbin push ./file.md

auth

generate an api key on the keys page and export it as DOCBIN_TOKEN:

export DOCBIN_TOKEN=dbk_your_key_here

push

docbin push <file> [--name <doc>] [--visibility <v>] [--expires <e>] [--type <t>] [--language <l>]

--name <existing> adds a new version to a doc you already own; omit it for a new doc. the other flags map to the same options as the web upload form.

docbin push ./notes.md --name notes
# https://docbin.app/you/notes (v2)

commands

docbin list                       your docs (--json)
docbin get <name|handle/name>     print content (--meta, --version <n>)
docbin update <name> <file>       add a new version
docbin delete <name> --yes        delete a doc
docbin search <query>             find docs (--json)

other hosts

set DOCBIN_API_ORIGIN to target a non-default host (defaults to https://docbin.app).