clawboard-cli

A small CLI for managing a Trello kanban board via the Trello REST API.

Default output is Markdown; use --json for raw JSON.

Install

``bash
npm i
npm run build
npm link

clawboard --help
`

Auth + board config

The CLI reads:
- ~/.config/trello/credentials.json with { "key": "...", "token": "..." }

Use clawboard init to set up auth + board.

- If ~/.config/trello/credentials.json is missing, clawboard init --key ... --token ... will write it.
- If ~/.config/trello/board.json is missing, most commands will error and tell you to run clawboard init.

clawboard init creates a board named Clawboard with lists:
- To do
- Doing
- Done

Override default board name with CLAWBOARD_NAME (or clawboard init --name "...").

Commands

- clawboard init
- clawboard status
- clawboard list todo|doing|done --limit 20
- clawboard add "Title" [--desc "..."] [--due 2026-02-03] [--list todo|doing|done]
- clawboard move todo|doing|done
- clawboard done

Examples

`bash
clawboard status
clawboard list todo --limit 10
clawboard add "Fix moltbook-cli publish flow" --list todo --due 2026-02-03
clawboard move https://trello.com/c/yuQBBlHs doing
clawboard done yuQBBlHs

JSON mode


clawboard status --json --pretty
``