CoBridge CLI Skill

Current Skill version: 2026-05-22T08:45:00Z

Install the real CoBridge CLI first:

npm install -g cobridge-cli

No endpoint variables are required for the default production service. https://cobridge.ai is already the built-in CoBridge production Agent API endpoint.

Install the CoBridge CLI Skill:

npx cobridge-cli-skill@latest install

By default, install/update uses auto mode. It will 自动更新当前 Agent 已安装位置. Fresh installs prefer the shared Agent skills directory (~/.agents/skills), while updates reuse the current cobridge-cli installation when one already exists. This avoids creating a second copy under ~/.codex/skills when your active Skill lives under ~/.agents/skills.

Install or update a specific Agent skills directory:

npx cobridge-cli-skill@latest install --dir ~/.agents/skills
npx cobridge-cli-skill@latest update --dir ~/.agents/skills

Update an already installed CoBridge CLI Skill:

npx cobridge-cli-skill@latest update
npx cobridge-cli-skill@latest update --target codex

After installation, use the browser authorization flow:

cobridge auth login --no-browser --json

Open the returned authorization URL, confirm the workspace, then run cobridge auth status --json until it reports authenticated: true. Use COBRIDGE_TOKEN or cobridge auth login --token <token> --json only for CI, containers, or explicit advanced-user setup.

For a specific workspace, copy the workspace-scoped command from CoBridge account settings or run:

cobridge auth login --profile <name> --workspace <workspace-id> --no-browser --json
cobridge auth status --profile <name> --json
cobridge auth login --workspace <workspace-id> --no-browser --json
cobridge auth login --workspace-name <workspace-name> --no-browser --json

Pending authorization state exposes workspace_id through cobridge auth status --json, cobridge auth status --profile <name> --json, and cobridge auth token source --json when a workspace was requested or resolved. When only the workspace name is known, use --workspace-name; the CLI will use an existing CLI token to resolve that name into a workspace-scoped authorization URL when possible. Do not read browser session storage, browser cookies, Supabase browser tokens, or Chrome profile databases to discover workspace ids. If you need to show candidates first, run cobridge workspace list --json to list workspace names and ids.

Before using CoBridge commands from an agent, run:

cobridge version check --skill-version 2026-05-22T08:45:00Z --json

The CLI and Skill versions are timestamp-based and can move independently. A CLI implementation update does not require a Skill update unless the command surface, command semantics, or agent operating rules changed.