CLI reference: AI

The atbridge.ai CLI for the AI surfaces. Part of the CLI reference; the tools these expose over MCP are in the MCP tool reference.

connect — @bridge AI Chat

Device-side state for the in-Thunderbird AI. Available on Personal and Pro (and during the Free trial). The general AI Chat is unmetered; email-contextual actions (connect invoke — improve/summarise a draft) count toward your monthly cap on Personal and are unlimited on Pro. The backend gatekeeps the secure-storage key-unwrap step.

Command	What it does
connect activate --provider <p>	Store an LLM API key (encrypted on disk; key never sent to our server)
connect status	Whether @bridge AI Chat is active on this device
connect invoke	Run one fast action (rate-limit → unwrap → decrypt → LLM)
connect chat	One turn of a multi-turn conversation (reads JSON on stdin)
connect deactivate	Tear down on this device (server + local files; --keep-local)
connect test	Smoke-test configured providers (real chat + tool round-trip, pass/fail + latency)

compose — @bridge Branded Email

Command	What it does
compose render --spec <file>	Render a block spec to a branded email and draft/send it (--mode, --identity)
compose theme	Get / set / reset the saved brand theme (brand, colors + fonts)
compose templates list	List the starter templates plus your saved ones
compose templates show <name>	Print a template’s spec to fill in
compose templates save <name>	Save a template (--from-last or --spec) — Pro/Enterprise
compose templates delete <name>	Delete one of your saved templates

mcp

Command	What it does
mcp (no subcommand)	Run the MCP stdio server for an AI client
mcp detect	Report which clients (Claude Desktop / Cursor) are wired in (--allow-writes to preview the writes-enabled config)
mcp setup --client <id>	Write the atbridge.ai entry into a client’s config (--allow-writes)
mcp tools	List the registered tool names (read always; writes under --allow-writes)

See the MCP tool reference for the tools this exposes, or /llms-mcp.txt for the plain-text version an agent can ingest directly.

skill

Deterministic, no-LLM actions for common asks. Personal + Pro; Free during the trial. The same skills appear as slash commands in the @bridge AI Chat pane.

Command	What it does
skill list	List every available skill
skill run <name>	Run one skill (--args '{…}' --pretty)

atbridge skill run today --pretty