{
  "name": "CoBridge",
  "description": "CoBridge 把团队资料整理成 Agent 可读取的上下文入口。",
  "canonicalUrl": "https://cobridge.ai/",
  "recommendedReadOrder": [
    "https://cobridge.ai/llms.txt",
    "https://cobridge.ai/docs/cli-skill",
    "https://cobridge.ai/release-notes"
  ],
  "pages": [
    {
      "title": "官网首页",
      "url": "https://cobridge.ai/",
      "purpose": "理解 CoBridge 的产品模型：资源索引、上下文包、权限和 Agent 读取流程"
    },
    {
      "title": "CLI / Skill 文档",
      "url": "https://cobridge.ai/docs/cli-skill",
      "purpose": "查看 Agent 接入、CLI 命令、JSON 输出和 Skill 规则"
    },
    {
      "title": "Release Notes",
      "url": "https://cobridge.ai/release-notes",
      "purpose": "查看官网、产品工作台和 Agent 接入能力的公开更新"
    }
  ],
  "install": [
    {
      "command": "npm install -g cobridge-cli",
      "purpose": "安装真实的 cobridge 命令"
    },
    {
      "command": "npx cobridge-cli-skill@latest install",
      "purpose": "安装 Agent 使用的 CoBridge CLI Skill"
    },
    {
      "command": "codex plugin marketplace add walnut-a/CoBridge --ref main --sparse .agents/plugins --sparse plugins/cobridge",
      "purpose": "把 CoBridge 插件 marketplace 加入 Codex"
    },
    {
      "command": "codex plugin add cobridge@cobridge",
      "purpose": "安装 Codex 内置浏览器使用的 CoBridge 插件"
    }
  ],
  "commands": [
    {
      "command": "cobridge help --json",
      "purpose": "查看当前 CLI 可执行命令清单"
    },
    {
      "command": "cobridge help <group> --json",
      "purpose": "按分组查看当前 CLI 可执行命令"
    },
    {
      "command": "cobridge help --all --json",
      "purpose": "查看当前 CLI 合同中的全部可执行命令"
    },
    {
      "command": "cobridge version check --skill-version <skill-version> --json",
      "purpose": "检查 CLI 是否建议或要求更新当前 Skill"
    },
    {
      "command": "cobridge auth login --no-browser --json",
      "purpose": "生成浏览器授权链接，让 Agent 在无登录态时完成 workspace 授权"
    },
    {
      "command": "cobridge auth status --json",
      "purpose": "查看当前 Token public id、本地来源，以及可用时的服务端工作区身份"
    },
    {
      "command": "cobridge auth status --profile <name> --json",
      "purpose": "轮询或查看指定本地 profile 的授权状态，不受当前 profile 影响"
    },
    {
      "command": "cobridge auth token source --json",
      "purpose": "查看当前认证来源、profile 和 pending device login 状态，不输出明文 token"
    },
    {
      "command": "cobridge auth token source --profile <name> --json",
      "purpose": "查看指定 profile 的本机认证来源和 pending 授权状态"
    },
    {
      "command": "cobridge auth profile list --json",
      "purpose": "查看本机保存的 CoBridge CLI profile 和当前使用的 profile"
    },
    {
      "command": "cobridge auth profile use <name> --json",
      "purpose": "切换本机 CoBridge CLI profile，用于访问不同账号或工作区"
    },
    {
      "command": "cobridge open <url-or-reference> --json",
      "purpose": "读取 CoBridge object / pack 地址或 cobridge:// 引用指向的内容"
    },
    {
      "command": "cobridge project list --json",
      "purpose": "查看当前 workspace 下的项目列表和资源、上下文包数量"
    },
    {
      "command": "cobridge context resolve <query> --project <project-id> --intent <intent> --json",
      "purpose": "按用户意图和关键词匹配资源与上下文包，只返回元数据和推荐动作"
    },
    {
      "command": "cobridge resource list --json",
      "purpose": "读取当前账号可访问的资源列表"
    },
    {
      "command": "cobridge resource pull <object-id> --json",
      "purpose": "读取指定资源的内容、来源、版本和结构化描述"
    },
    {
      "command": "cobridge resource preview <object-id> --json",
      "purpose": "返回已有资源的产品内预览地址"
    },
    {
      "command": "cobridge resource share <object-id> --public --json",
      "purpose": "按用户明确要求为已有资源开启公开分享并返回分享地址"
    },
    {
      "command": "cobridge resource download <object-id> --dir <dir> --json",
      "purpose": "把当前资源资产保存到用户指定的本地目录"
    },
    {
      "command": "cobridge resource download <object-id> --version <version-id> --dir <dir> --json",
      "purpose": "把指定历史版本的资源资产保存到用户指定的本地目录"
    },
    {
      "command": "cobridge resource upload <file> --project <project-id> --json",
      "purpose": "上传本地 HTML、Markdown 或 Skill zip 文件为资源，并返回产品内预览地址"
    },
    {
      "command": "cobridge resource upload <file> --project <project-id> --public --json",
      "purpose": "上传本地文件为资源，开启公开分享，并返回侧栏已打开的在线预览地址"
    },
    {
      "command": "cobridge resource update <object-id> <file> --json",
      "purpose": "把本地文件更新到已有资源上，并生成新的资源版本"
    },
    {
      "command": "cobridge resource update <object-id> <file> --summary <text> --json",
      "purpose": "更新已有资源并记录本次版本说明"
    },
    {
      "command": "cobridge resource update <object-id> <file> --public --json",
      "purpose": "更新已有资源并按明确要求开启公开分享"
    },
    {
      "command": "cobridge resource link <url> --project <project-id> --json",
      "purpose": "创建外部链接资源"
    },
    {
      "command": "cobridge resource versions <object-id> --json",
      "purpose": "查看资源历史版本列表"
    },
    {
      "command": "cobridge resource version <object-id> <version-id> --json",
      "purpose": "读取某个资源历史版本快照"
    },
    {
      "command": "cobridge pack list --project <project-id> --json",
      "purpose": "读取项目下上下文包的介绍、使用说明和资源数量"
    },
    {
      "command": "cobridge pack read <pack-id> --json",
      "purpose": "读取上下文包里的资源引用、说明、版本和权限边界"
    },
    {
      "command": "cobridge pack create <pack.md> --project <project-id> --json",
      "purpose": "用 Markdown 说明创建上下文包"
    },
    {
      "command": "cobridge pack update <pack-id> --file <pack.md> --json",
      "purpose": "更新上下文包说明"
    },
    {
      "command": "cobridge pack add-resource <pack-id> <object-id> --json",
      "purpose": "把资源加入上下文包"
    },
    {
      "command": "cobridge pack remove-resource <pack-id> <object-id> --json",
      "purpose": "从上下文包移除资源引用"
    }
  ],
  "agentRules": [
    "不确定当前 CLI 支持哪些命令时，先运行 cobridge help --json 或 cobridge help <group> --json。",
    "Agent 使用 CLI 前先带上当前 Skill version 执行版本检查。",
    "看到 CoBridge URL、share link 或 cobridge:// 引用时，优先使用 cobridge open 读取。",
    "用户只描述目标内容时，先用 context resolve 按名称和简介匹配资源与上下文包。",
    "根据用户意图选择 preview_url、share_url、JSON 元数据或下载到本地目录的文件路径。",
    "需要核对历史内容时，先列出 resource versions，再读取指定 resource version。",
    "所有 Agent 场景统一读取 JSON 输出，不解析自然语言。",
    "无登录态时优先用 cobridge auth login --no-browser --json 生成授权链接，不要让用户在对话里粘贴 Token。",
    "Token secret 只允许放在本机凭据或环境变量里。",
    "当前 CoBridge CLI 先用 npm install -g cobridge-cli 安装，CoBridge CLI Skill 用 npx cobridge-cli-skill@latest install 安装，用 npx cobridge-cli-skill@latest update 更新；默认会自动更新当前 Agent 已安装位置。固定目录可用 npx cobridge-cli-skill@latest update --dir ~/.agents/skills，固定 Codex 可用 npx cobridge-cli-skill@latest update --target codex。",
    "Codex 需要用内置浏览器访问 CoBridge 正式账号数据时，先运行 codex plugin marketplace add walnut-a/CoBridge --ref main --sparse .agents/plugins --sparse plugins/cobridge，再运行 codex plugin add cobridge@cobridge。",
    "普通用户不需要配置 endpoint；公开 npm CLI 默认连接 https://cobridge.ai 上的 CoBridge 生产 Agent API。",
    "CoBridge CLI Skill 的安装和更新只写入 Agent 使用说明，不会自动改 CoBridge 数据。",
    "任意下载来的第三方 Skill 安装和第三方脚本执行属于高风险动作，需要用户明确确认。"
  ]
}