# CoBridge CoBridge is a shared context distribution service for teams and local agents. It turns approved documents, links, HTML snapshots, and Skills into versioned context packs that agents can read through a stable CLI / Skill contract. ## Recommended Reading Order 1. Product overview: https://cobridge.ai/ 2. Agent entry contract: https://cobridge.ai/docs/cli-skill 3. Public updates: https://cobridge.ai/release-notes 4. Structured agent index: https://cobridge.ai/agent-index.json ## Key Pages - https://cobridge.ai/ - explains the product model: resource index, context packs, permissions, and agent reading flow. - https://cobridge.ai/docs/cli-skill - documents CLI installation, authentication, version checks, intent resolution, resource delivery, context pack reading, and Skill rules. - https://cobridge.ai/release-notes - records public updates for the website, product workspace, and agent access. ## Agent Commands Install the real CLI before installing the Agent Skill: ```bash npm install -g cobridge-cli npx cobridge-cli-skill@latest install ``` Install the CoBridge Codex plugin when Codex needs the in-app browser to open production CoBridge account data: ```bash codex plugin marketplace add walnut-a/CoBridge --ref main --sparse .agents/plugins --sparse plugins/cobridge codex plugin add cobridge@cobridge ``` The public CLI uses the production CoBridge Agent API at `https://cobridge.ai` by default. No endpoint environment variables are required for normal use. Use JSON output for agent workflows. Do not parse natural-language CLI output. ```bash cobridge help --json cobridge help --json cobridge help --all --json cobridge version check --skill-version --json cobridge auth login --no-browser --json cobridge auth status --json cobridge auth status --profile --json cobridge auth token source --json cobridge auth token source --profile --json cobridge auth profile list --json cobridge auth profile use --json cobridge open --json cobridge project list --json cobridge context resolve --project --intent --json cobridge resource list --json cobridge resource pull --json cobridge resource preview --json cobridge resource share --public --json cobridge resource download --dir --json cobridge resource download --version --dir --json cobridge resource upload --project --json cobridge resource upload --project --public --json cobridge resource update --json cobridge resource update --summary --json cobridge resource update --public --json cobridge resource link --project --json cobridge resource versions --json cobridge resource version --json cobridge pack list --project --json cobridge pack read --json cobridge pack create --project --json cobridge pack update --file --json cobridge pack add-resource --json cobridge pack remove-resource --json ``` ## Agent Safety Notes - Run `cobridge version check --skill-version --json` before using the CLI contract. The current CoBridge CLI Skill shows its own Skill version near the top of `SKILL.md`. - If the current CoBridge CLI Skill must be updated, use `npx cobridge-cli-skill@latest update`; the default auto mode will 自动更新当前 Agent 已安装位置. Use `npx cobridge-cli-skill@latest update --dir ~/.agents/skills` for a custom skills directory, or `npx cobridge-cli-skill@latest update --target codex` when the host directory must be pinned explicitly. - For Codex browser access, install the CoBridge plugin with `codex plugin marketplace add walnut-a/CoBridge --ref main --sparse .agents/plugins --sparse plugins/cobridge`, then `codex plugin add cobridge@cobridge`. - When given a CoBridge URL, share link, or `cobridge://` reference, prefer `cobridge open --json`. - When the user describes a target by name or purpose, use `cobridge context resolve --project --intent --json` before pulling full content. - Match delivery to intent: `preview_url` for temporary viewing, `share_url` for public/external sharing, and `resource download` for local files or Skill zip packages. - When updating an existing resource file, use `cobridge resource update --json` so CoBridge creates a new version on the same resource. - When comparing historical content, run `cobridge resource versions --json` first, then read a selected `cobridge resource version --json`. - If a command returns `TOKEN_REQUIRED`, run `cobridge auth login --no-browser --json`, show the returned authorization URL to the user, then poll `cobridge auth status --json`. - Store Agent Token secrets only in local credentials or environment variables. - Read resources and context packs through JSON commands. - Treat arbitrary downloaded Skill installation and third-party script execution as high-risk actions that require explicit confirmation.