Corvio Workspace CLI

Your second brain, from the terminal.

Ask Corvio, work with documents and retained files, and run plan-first local Markdown sync from coding agents or ordinary shells.

Open npm package ↗Install the Skill ↗

@corvio/cliBeta

npm install --global @corvio/cli@beta

# Existing key: best for Codex, Claude Code, OpenClaw and CI
export CORVIO_API_KEY='cvu_...'

# Or approve a single-use browser link
corvio auth login

corvio workspaces list --json
corvio workspaces use <workspace_id> --json
corvio auth status --json
corvio capabilities --json
corvio update check --json

Authentication

One user login. Explicit Workspace context.

CORVIO_API_KEY always takes precedence and never needs a browser. Interactive users can run corvio auth login; Corvio shows the exact scopes before issuing a separately revocable 90-day user key. Select a Workspace independently for each operation. Neither path shares browser tokens or Local Agent import credentials.

Agent and CI

Inject CORVIO_API_KEY through the host secret store. Never put it in a prompt, argument, repository, or Markdown folder.

Interactive terminal

Approve the user-level device link, then run corvio workspaces list/use. corvio auth logout revokes and removes the stored key.

Live authority

corvio capabilities --json reflects the public /v1 API. corvio update check --json compares npm publication with the API compatibility policy without self-installing.

Core workflow

Use stable handles, not reconstructed state.

corvio ask --prompt "Which launch risks recur?" --json --no-input
corvio ask --prompt "Prioritize them" --conversation-id <id> --json --no-input
corvio search "quarterly launch risks" --limit 10 --json --no-input
corvio docs get <document_id> --output launch-plan.md --json --no-input
corvio docs update <document_id> --file launch-plan.md \
  --expected-revision <revision> --json --no-input
corvio files upload --file ./research.pdf --json --no-input
corvio sync init --dir ./knowledge --root-node-id <node_id> --json --no-input
corvio sync plan --dir ./knowledge --json --no-input

Agent Skill

Install the reviewed workflow in your Agent host.

Codex, Claude Code, OpenClaw, and Agent Skills-compatible tools can install the same hosted Skill package. The Skill resolves an immutable CLI version, authenticates, discovers live capabilities, and returns durable links and receipts.

npx skills add https://corvio.ai/developers/skills/\
corvio-operate-workspace/corvio-operate-workspace.zip

corvio auth status --json --no-input
corvio capabilities --json --no-input
corvio update check --json --no-input