@cervoapp/cli

Node CLI for Cervo auth, terminal capture/search flows, and the local stdio bridge.

Install

Global install:

npm install -g @cervoapp/cli
# or
pnpm add -g @cervoapp/cli

One-shot usage:

npx @cervoapp/cli --help
# or
pnpm dlx @cervoapp/cli --help

Quick start

Authenticate against production:

cervo auth login

cervo auth login prints an 8-character verification code in the terminal. Enter that code in the browser approval page before approving the CLI session.

Target the dev/local deployment explicitly when needed:

cervo auth login --env dev

Browser-login tokens now expire automatically by default.

If you also want to wire the local bridge into Codex and Claude Code immediately:

cervo auth login --install all

Inspect local auth state or the active remote token:

cervo auth status
cervo auth whoami

For custom/self-hosted setup or CI, save the MCP URL and token directly:

cervo auth set --url 'https://<your-host>/mcp/v1' --token 'cpat_...'

You can also keep multiple local profiles and switch between them:

cervo auth set --profile work --url 'https://<your-host>/mcp/v1' --token 'cpat_...'
cervo auth profiles list
cervo auth profiles use work

Verify MCP connectivity, expected tools, and effective token scopes:

cervo mcp doctor

Browse, search, inspect, and capture from the terminal:

cervo list --limit 10
cervo list --collection space_123 --limit 5
cervo list --capture-type pdf --date-after 1735689600000
cervo lucky 'meeting notes' --human
cervo lucky 'openai agents' --source --human
cervo tags list --human
cervo tags show capture_123 --human
cervo related capture_123 --human
cervo explore capture_123 --depth 2 --human
cervo retry capture_123
cervo archive capture_123
cervo restore capture_123
cervo collections captures space_123 --limit 5 --human
cervo search 'openai agents' --limit 5
cervo show <captureId> --source
cervo collections update space_123 --name 'Research'
cervo collections delete space_123
cervo capture text 'A note from the terminal'
echo 'A piped note' | cervo capture --note inbox

cervo lucky and cervo explore are CLI-composed workflows built on top of the canonical MCP tools. They do not add new server-side MCP tool names.

Install or remove the local stdio bridge in supported developer clients:

cervo mcp install codex
cervo mcp install claude-code
cervo mcp install all
cervo mcp uninstall codex

Run the local stdio bridge directly:

cervo mcp bridge

Secondary compatibility alias:

cervo-mcp

Local development from this monorepo

pnpm cli -- --help

That root script builds apps/cli and runs the local dist/index.js entrypoint.

Docs

• MCP API and transport docs: docs/api/mcp.md
• Monorepo/package layout: docs/engineering/monorepo.md

License

@cervoapp/cli is proprietary software.

You may install and use it solely to access and use Cervo services, subject to the terms in LICENSE.md, the Cervo Terms of Service, and the Cervo Privacy Policy.