coda-ai

CLI to read Coda.io content for AI agents.

Workflow

1. docs → list all documents
2. pages → list pages in a doc
3. read → get page content

Setup (once)

npm install -g coda-ai@0.2.2

# Auth (Coda API token)
echo "CODA_API_TOKEN=YOUR_TOKEN" > .env
coda-ai auth --from-file .env

coda-ai whoami # verify auth

Credentials & Storage

• Stored at: ~/.coda-ai/config.json (written with 0600 permissions)
• Remove stored credentials:

coda-ai logout

Commands

List Documents

coda-ai docs --compact        # only id + name in toon format (recommended for AI Agents)
coda-ai docs                  # full data in toon format
coda-ai docs --format json    # full data in json
coda-ai docs --format table   # human-readable table

Returns: All docs sorted by most recent update. Use id field for next step.

List Pages

coda-ai pages --docId <docId> --compact        # only id + name, toon format (recommended for AI Agents)
coda-ai pages --docId <docId> --format json    # full data in json
coda-ai pages --docId <docId> --format tree    # visual tree
coda-ai pages --docId <docId>                  # full data in toon format (default)

Returns: Page hierarchy. Use pageId for next step.

Read Content

coda-ai read --docId <docId> --pageId <pageId>  # markdown (default, recommended for AI Agents)
coda-ai read --docId <docId> --pageId <pageId> --format json    # structured data in json
coda-ai read --docId <docId> --pageId <pageId> --format html    # html export

Reference

Full docs: https://github.com/auniik/coda-ai#readme