docbin

Upload files to docbin from the command line.

Built for pushing large documents (build logs, reports, generated files) without pasting their contents into a chat or an MCP tool call.

Install

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

Auth

Generate an API key at https://docbin.app/settings#api-keys and export it:

export DOCBIN_TOKEN=dbk_your_key_here

Usage

docbin push <file> [--name <doc>] [--visibility <v>] [--expires <e>] [--type <html|md|mdx|code>] [--language <l>]

--name <existing> adds a new version to a doc you already own; omit it for a new doc. Content type is inferred from common file extensions, including .md, .mdx, .html, and code/log files. Use --type to override it.

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

Commands

docbin list                       # your docs (--json for machine-readable output)
docbin get <name|handle/name>     # print content (--meta to show metadata, --version <n> for a specific version)
docbin update <name> <file>       # add a new version to an existing doc
docbin delete <name> --yes        # delete a doc (--yes required to confirm)
docbin search <query>             # find docs (--json for machine-readable output)
docbin markdown                   # print the markdown syntax reference (--web for the page url)
docbin preview <type> <path>      # start a local preview server for html, md, mdx, or code

docbin markdown prints docbin's full markdown syntax reference to stdout, ready to pipe or read by an agent. docbin markdown --web prints the URL of the same reference as a web page instead.

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