@topy-ai/ceo-cli — TOPY.AI's AI CEO in your terminal

TOPY.AI writes and maintains founders' business plans and keeps their CEO records. This package brings the same tools to a terminal (ceo-cli). They are the tools of TOPY's remote MCP server, https://topy.ai/mcp, so the CLI, Claude, ChatGPT and your own agents follow the same rules.

| Package | What it is | |---|---| | @topy-ai/ceo-cli | this CLI, ceo-cli | | @topy-ai/ceo-mcp | a local stdio MCP server, ceo-mcp, for clients that only run local servers | | @topy-ai/ceo-skills | the AI CEO skills for Claude Code, Codex, Cursor, Gemini CLI and other agents |

Install and sign in

npm i -g @topy-ai/ceo-cli        # or run any command with npx @topy-ai/ceo-cli …
ceo-cli login                   # opens topy.ai to approve this device (read-only: --read-only)
ceo-cli whoami

Instead of signing in you can export an API key from Dashboard → API keys: export TOPY_API_KEY=topy_….

Use it

ceo-cli tools                                   # every tool, by group, with its risk
ceo-cli help plan_generate                      # a tool's arguments
ceo-cli projects_list
ceo-cli plans_list --project <project-id>
ceo-cli plan_get --plan-id <id> --section 3
ceo-cli plan_revise_analyze --plan-id <id> --change-request "raise £250k instead of £200k, hire a CTO in Q2 2027"
ceo-cli plan_status --job-id <job-id>
ceo-cli decision_create --title "Price at £49/month" --decision "…" --rationale "…"

A tool that changes something prints a preview first and asks Go ahead? [y/N]. Nothing changes until you say yes; in scripts, pass --yes only when the change was already agreed. Generating a plan costs 50 TOPY credits and the preview shows your balance. --json prints the raw result.

| Risk | Meaning | |---|---| | R0 | reads | | W1 | changes something you can change back | | W2 | spends TOPY credits | | W4 | deletes for good |

Workflows

ceo-cli prompts                                 # idea-to-business-plan, revise-plan, investor-ready-check, …
ceo-cli prompt revise-plan --change "push launch to Q3 2027"

Connect an AI assistant

• Claude / ChatGPT (web and desktop) — add a custom connector with the URL https://topy.ai/mcp and sign in to TOPY when asked.
• Claude Code — claude mcp add --transport http topy https://topy.ai/mcp
• Cursor and other clients with remote MCP — server URL https://topy.ai/mcp (OAuth).
• Clients that only run local servers — after ceo-cli login (or with TOPY_API_KEY set):

{ "mcpServers": { "topy": { "command": "npx", "args": ["-y", "@topy-ai/ceo-mcp"] } } }

ceo-cli mcp runs the same server from this package.

Skills for your agent

npx @topy-ai/ceo-skills install           # Claude Code, Codex, Cursor, Gemini CLI, … (asks which)
npx @topy-ai/ceo-skills list              # the catalogue

Settings

| Variable | Default | | |---|---|---| | TOPY_API_KEY | — | use this key instead of the saved sign-in | | TOPY_BASE_URL | https://topy.ai | another TOPY server | | TOPY_CONFIG_DIR | ~/.config/topy | where the sign-in is kept (credentials.json, mode 600) |

ceo-cli logout revokes this device's access. Connected apps and devices are listed under Dashboard → API keys, where they can be disconnected.