cursor-coda

Coda is the brain. Cursor is the hands.

Your project brief lives in Coda. Your client context lives in Coda. Your decisions, progress, and output live in Coda. The agent reads from it, writes back to it, and uses it as the source of truth for everything — before the first line of code is written and after the last.

This repo wires that connection into any project in one command.

What this is

A CLI that injects a set of scripts and Cursor rules into your project. Once installed:

• Cursor builds a manifest of your Coda docs at the start of every conversation
• The agent can read any page on demand — briefs, context, SOPs, anything
• The agent can write back — log decisions, update tracker tables, append to pages
• Nothing is stored locally. Everything lives in Coda.

You define what's in Coda. The agent figures out the rest.

Quick start

Inject into an existing project

npx cursor-coda

Create a new project folder

npx cursor-coda new my-project
cd my-project

What gets added

your-project/
├── scripts/
│   ├── coda-sync.mjs         # Full Coda API CLI (read + write)
│   └── coda-auto-sync.mjs    # Manifest builder
├── .cursor/rules/
│   ├── 01-coda-sync.mdc      # Always-on — builds manifest at conversation start
│   ├── 02-coda-content.mdc   # How to read Coda content on demand
│   ├── 03-coda-commands.mdc  # Full CLI reference for Cursor
│   ├── 04-coda-setup.mdc     # First-run setup guide
│   ├── 05-coda-write.mdc     # Write operations — pages, docs, rows
│   └── 06-coda-project.mdc   # Full project loop — read brief, build, log back
├── .coda/
│   └── config.json           # Which docs to index
└── GETTING_STARTED.md

Setup

1. Add your token

   Add to .env.local:

   CODA_API_TOKEN=your-token-here

   Get yours at coda.io/account#apiSettings

2. Configure your docs

   Edit .coda/config.json:

   {
     "token_env": "CODA_API_TOKEN",
     "sync": [
       { "doc": "Your Doc Name" }
     ]
   }

3. Build the manifest

   node scripts/coda-auto-sync.mjs --project-dir .

4. Open in Cursor — rules load automatically. Try:

   "show me what's in my Coda"

CLI reference

node scripts/coda-sync.mjs docs                          # list all docs
node scripts/coda-sync.mjs pages "Doc Name"              # list pages
node scripts/coda-sync.mjs export "Doc Name" "Page"      # read a page
node scripts/coda-sync.mjs tables "Doc Name"             # list tables
node scripts/coda-sync.mjs rows "Doc Name" "Table"       # list rows
node scripts/coda-sync.mjs columns "Doc Name" "Table"    # inspect schema
node scripts/coda-sync.mjs add-row "Doc" "Table" --data '{"Col":"val"}'
node scripts/coda-sync.mjs update-row "Doc" "Table" "row-id" --data '{"Status":"Done"}'
node scripts/coda-sync.mjs analytics "Doc Name"

Run node scripts/coda-sync.mjs --help for the full reference.

License

MIT