npm install --global @corvio/cli@beta
# 已有密钥:适合 Codex、Claude Code、OpenClaw 和 CI
export CORVIO_API_KEY='cvu_...'
# 或批准一次性浏览器链接
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一个人类控制面,每个本地项目一个 Agent。
CORVIO_API_KEY 始终优先,且不需要浏览器。交互式用户只需批准一次设备链接;随后 agents connect 会验证本地 provider,把当前设备与项目幂等绑定到一个 Agent,安全保存且不打印一次性凭证,并在 systemd 或 launchd 可用时安装受监督的本地评论监听器。普通操作会依次采用显式 Workspace、对话或项目延续关系、账号选择、个人默认 Workspace,或唯一可访问候选;真正歧义时会关闭默认并返回候选。两种认证路径都不会共享浏览器 token 或 Local Agent 导入凭证。collaboration status 会把监听器的精确本地监督状态与 project、Skill 前置条件分开报告;它不能证明当前宿主会话已加载 Skill 或远程 MCP,只有监听器也不会激活普通前台编码任务的协作。关机或休眠的设备仍无法被远程唤醒。服务端只收到不可逆的项目指纹,不收到本地路径。最终权限始终是 Corvio membership、grant、Node ACL 与 provider 原生项目权限的交集。
Agent 与 CI
通过宿主的密钥存储注入 CORVIO_API_KEY。不要把它放进 prompt、参数、仓库或 Markdown 文件夹。
项目身份
每个 provider、设备与项目对应一个稳定 Agent。重复连接保持幂等;连接另一项目会创建独立的非默认 Agent。
触发边界
默认只有所有者能调用项目 Agent;允许 Workspace 成员调用或授予无限制宿主权限都必须另行显式确认。
实时 authority
当前项目 Agent 获得精确 Corvio 上下文,并使用 Codex、Claude Code 或 Copilot 的原生权限。仍可用 --agent 和 --workspace 显式覆盖。
使用稳定句柄,不要重新拼装状态。
corvio ask --prompt "哪些发布风险反复出现?" --json --no-input
corvio ask --prompt "请给它们排序" --conversation-id <id> --json --no-input
corvio search "季度发布风险" --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 "已更新发布风险。" --json --no-input
corvio agent closeout --document-id <document_id> --thread-id <thread_id> --body "已实现并验证。" --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把经过审查的工作流安装到你的 Agent 宿主中。
Codex、Claude Code、OpenClaw 和兼容 Agent Skills 的工具都能安装同一个托管 Skill。可搜索的元数据直接列出调研、报告、计划、会议、项目和调试等触发场景;Skill 被选中后,把 Corvio 查询和写回嵌进宿主原有工作流。CLI 只能检查本地前置条件,不能证明当前宿主会话已经加载 Skill 或远程 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