coda

1# Coda
2 
3## Purpose
4Read and write the user's Coda workspace: list docs, list tables in a doc, read table rows, add rows to a table. Use when the user mentions Coda, a Coda doc, or a Coda table.
5 
6## Tooling
7All commands go through `bin/coda.py`:
8 
9```bash
10bin/coda.py auth                                        # verify the token (whoami)
11bin/coda.py docs --limit 25                             # list docs
12bin/coda.py tables --doc DOC_ID                         # list tables in a doc
13bin/coda.py rows --doc DOC_ID --table TABLE_ID          # read rows from a table
14bin/coda.py add-row --doc DOC_ID --table TABLE_ID --cells '{"Task":"Ship","Done":false}'  # add a row
15```
16 
17Table arguments accept table IDs or names. Use `tables` to resolve names first.
18 
19## Auth
20- Provider id: `coda` (credential is collected as `custom.coda`)
21- Collection: personal API token via the secure credential flow (`credentials.request_api_access`); created at coda.io/account (API settings)
22- Allowed hosts: `coda.io`
23- Status check: `bin/coda.py auth` (must return `"ok": true`)
24 
25## Operating Rules
261. `add-row` is a write: confirm the exact cells and destination table with the user before sending, unless standing permission exists.
272. Reading (docs, tables, rows) needs no confirmation.
283. Coda API tokens can be read-only or read-write; if `add-row` returns a permission error, the token needs write scope: tell the user rather than retrying.
29…