Acorno CLI

Command-line interface for Agent and automation access to Acorno over HTTP.

npm install -g @acorno/cli

export ACORNO_API_URL="https://api.example.com"
export ACORNO_API_TOKEN="your_acorno_token"

acorno health -o pretty
acorno auth status -o pretty
printf "%s" "$ACORNO_API_TOKEN" | acorno auth login --token-stdin
acorno agent capabilities -o pretty
acorno skill library -o pretty
acorno skill create --dir ./my-skill --source ai_created
acorno save https://example.com/a https://example.com/b
acorno clip create --kind link --url https://example.com
acorno clip create --url https://example.com/a --url https://example.com/b
acorno clip create --kind audio --audio-file ./note.mp3
acorno clip create --json ./clips.json
acorno clip source-platforms -o pretty
acorno clip recent --limit 8 -o pretty
acorno clip search --q "AI Agent" --limit 8 -o pretty
acorno clip list --limit 50 --all -o pretty
acorno clip update --id CLIP_ID --read
acorno clip update --id CLIP_ID,CLIP_ID_2 --archive --read --yes
acorno trash list -o pretty
acorno creator detail --id CREATOR_ID -o pretty
acorno creator feed --id CREATOR_ID --signal hot -o pretty

The CLI does not connect to PostgreSQL or require the Acorno app client. It sends HTTPS requests to the configured Acorno API and returns JSON by default.

For external Agents, prefer agent capabilities, clip recent, clip search, and clip agent-detail first. They use the /api/agent/* API surface with compact JSON payloads designed for progressive context loading.

Command Surface

Keep this list synchronized with acorno --help, docs/cli.md, and the CLI command tests.

health
version
auth status
auth login --token-stdin [--api-url URL]
auth logout
me
agent capabilities
skill library
skill installed
skill create --dir DIR [--source imported|ai_created] [--pinned] [--display-order N]
skill create --json FILE_OR_JSON [--source imported|ai_created] [--pinned] [--display-order N]
skill install --id SKILL_ID [--version-id VERSION_ID] [--pinned] [--display-order N]
skill enable --installation-id INSTALLATION_ID
skill disable --installation-id INSTALLATION_ID
skill pin --installation-id INSTALLATION_ID
skill unpin --installation-id INSTALLATION_ID
save URL [URL2...] [--title TEXT] [--note TEXT] [--tag A,B]
clip list [--limit N] [--cursor CURSOR] [--all] [--tag NAME] [--tag-id TAG_ID] [--source-platform NAME] [--read-status read|unread] [--starred] [--date YYYY-MM-DD]
clip recent [--limit N]
clip search [--q TEXT] [--limit N] [--tag NAME] [--source-platform NAME] [--read-status read|unread] [--date YYYY-MM-DD]
clip source-platforms
clip detail --id CLIP_ID [--article]
clip agent-detail --id CLIP_ID
clip article --id CLIP_ID
clip audio retranscribe --id CLIP_ID
clip create --kind link --url URL [--title TEXT] [--note TEXT] [--tag A,B]
clip create --url URL [--url URL2] [--title TEXT] [--note TEXT] [--tag A,B]
clip create --kind text --text TEXT [--source-url URL] [--tag A,B]
clip create --kind image --image-file PATH [--caption TEXT] [--tag A,B]
clip create --kind audio --audio-file PATH [--duration-ms N] [--tag A,B]
clip create --json FILE_OR_JSON
clip update --id CLIP_ID[,ID2] [--star|--unstar] [--archive|--unarchive] [--read|--unread] [--dry-run] [--yes]
clip tags --id CLIP_ID [--add A,B] [--remove A,B] [--attached-by human|ai|rule|import]
clip delete --id CLIP_ID[,ID2] [--dry-run] [--yes]
tag list [--limit N] [--q TEXT]
tag create --name NAME
tag update --id TAG_ID --name NAME
tag delete --id TAG_ID [--dry-run] [--yes]
trash list [--limit N]
trash restore --id CLIP_ID
trash purge --id CLIP_ID [--dry-run] [--yes] [--limit N]
trash empty [--dry-run] [--yes] [--limit N]
creator detail --id CREATOR_ID [--limit N]
creator feed --id CREATOR_ID [--limit N] [--cursor CURSOR] [--signal new|rising|hot|reheated]
job list [--limit N] [--clip-id CLIP_ID] [--stage STAGE] [--status STATUS]
job enqueue parse --clip-id CLIP_ID [--url URL] [--idempotency-key KEY]
job enqueue transcript --clip-id CLIP_ID [--idempotency-key KEY]
job enqueue search-index --clip-id CLIP_ID
job enqueue search-index --all [--limit N]
link inspect --url URL [--limit N]

Maintenance Checks

npm run test
npm run typecheck