usecork

The command-line client for Cork boards. It gives agents with a shell a fast way to upload local images and add cards without putting file bytes into a conversation.

npm install -g usecork   # installs the `cork` command (Node 20+)
cork login               # opens Cork's device sign-in in your browser
cork boards
cork upload <boardId> ./reference.jpg ./moodboard/*.png

Without a global install, run any command through npx -y usecork <command>.

cork login                              device sign-in (OAuth)
cork login <token>                      use an API token instead
cork boards                             list boards
cork boards new <name> [--private]      create a board, prints its URL
cork upload <boardId> <path>... [--tag t]...
cork add <boardId> image <url|path> [--caption text] [--tag t]...
cork add <boardId> url <url> [--note text] [--tag t]...
cork add <boardId> note "text" [--variant plain|heading|callout] [--format markdown]
cork add <boardId> chart <path.csv> [--form bar|line|...] [--x col] [--y col]...
cork restyle <boardId> [--layout clusters|editorial|masonry|grid] [--theme paper|studio|...]
cork comment <boardId> "text"
cork open <boardId>                     opens the share URL in a browser

Credentials are stored in ~/.config/cork/credentials.json (mode 0600) and refreshed automatically. --api <url> or CORK_API points the CLI at another Cork API. Output is JSON; add --json for compact output.