coda-ai

TotalClaw 作者 totalclaw

用于阅读 Coda.io 文档和页面的 CLI。列出文档、列出页面、读取 markdown/json/html 中的内容。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~auniik-coda-ai

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~auniik-coda-ai/file -o auniik-coda-ai.md

## 概述（中文）

用于阅读 Coda.io 文档和页面的 CLI。列出文档、列出页面、读取 markdown/json/html 中的内容。

## 原文

# 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)

```bash
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:

```bash
coda-ai logout
```

## Commands

### List Documents

```bash
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

```bash
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

```bash
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