Your second brain, from the terminal.

Ask Corvio, work with documents and files, and sync local Markdown from an agent or shell.

@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 agents connect --provider codex --project . --json
corvio collaboration status --json --no-input
corvio auth status --json
corvio capabilities --json
corvio update check --json

One human control plane. One Agent per local project.

CORVIO_API_KEY always takes precedence and never needs a browser. Interactive users approve one device link, then agents connect verifies the local provider, idempotently binds this device and project to one Agent, stores its one-time credential without printing it, and installs a supervised local comment listener when systemd or launchd is available. Ordinary operations resolve the explicit Workspace first, then conversation or project continuity, the account selection, the personal default, or a single authorized candidate; a true ambiguity fails closed and returns candidates. Neither path shares browser tokens or Local Agent import credentials. collaboration status reports the listener's exact local supervision separately from project and Skill prerequisites; it cannot prove that the current host task loaded the Skill or Remote MCP, and a listener alone does not activate ordinary foreground coding work. A powered-off or sleeping device still cannot be remotely awakened. The server receives an opaque project fingerprint, not the local path. Effective authority is always the intersection of Corvio membership, grants and node ACLs with the provider's native project permissions.

Agent and CI

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

Project identity

Each provider, device, and project gets one stable Agent. Reconnecting is idempotent; connecting another project creates a separate, non-default Agent.

Trigger boundary

Only the owner can invoke a project Agent by default. Workspace-member invocation and unrestricted host access require separate explicit confirmation.

Live authority

The current project's Agent receives exact Corvio context and uses native Codex, Claude Code, or Copilot permissions. Explicit --agent and --workspace overrides remain available.

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 <workspace_id/document_id> --output launch-plan.md --json --no-input
corvio docs update <workspace_id/document_id> --file launch-plan.md \
  --expected-revision <revision> --change-summary "Updated launch risks." --json --no-input
corvio agent closeout --document-id <document_id> --thread-id <thread_id> --body "Implemented and verified." --status resolved --json --no-input
corvio files upload --file ./research.pdf --json --no-input
corvio files get <asset_id> --content --json --no-input
corvio files operation <operation_id> --wait-until-terminal --timeout-seconds 1200 --json --no-input
corvio sync init --dir ./knowledge --root-node-id <node_id> --json --no-input
corvio sync plan --dir ./knowledge --json --no-input

Install the reviewed workflow in your Agent host.

Codex, Claude Code, OpenClaw, and Agent Skills-compatible tools can install the same hosted Skill package. Its searchable metadata names concrete research, reporting, planning, meeting, project, and debugging triggers; after selection, the Skill adds Corvio at decision points in the host's existing loop. The CLI can inspect local prerequisites but cannot prove that the current host task loaded the Skill or Remote MCP.

# Choose one host; add --global only for a user-level install
npx --yes skills@1.5.23 add https://corvio.ai/developers/skills/corvio-operate-workspace/corvio-operate-workspace.zip --agent codex --skill corvio-operate-workspace --yes
npx --yes skills@1.5.23 add https://corvio.ai/developers/skills/corvio-operate-workspace/corvio-operate-workspace.zip --agent claude-code --skill corvio-operate-workspace --yes
npx --yes skills@1.5.23 add https://corvio.ai/developers/skills/corvio-operate-workspace/corvio-operate-workspace.zip --agent github-copilot --skill corvio-operate-workspace --yes

corvio auth status --json --no-input
corvio agents connect --provider codex --project . --json --no-input
corvio collaboration status --json --no-input
corvio capabilities --json --no-input
corvio update check --json --no-input

Your second brain, from the terminal.Your second brain, from the terminal.