Context Bridge getting started

Context Bridge is currently installed from an approved local source checkout. Build the CLI with the pinned Rust toolchain, then use doctor before relying on a particular OpenCode, Claude Code, or Codex integration.

Install from a checkout

Use Cargo's locked install path so the installed binary matches the reviewed source tree. This command does not upload session content or start a service.

Get the source from the official Context Bridge repository:

12345git clone https://github.com/bas3line/Context-Bridge.git
cd /path/to/context-bridge
cargo install --path crates/cb-cli --locked
cb --version
cb doctor --verbose

doctor reports executable discovery, agent versions, and the guarded compatibility profile. Do not bypass an unverified profile by changing a vendor command or pointing the tool at private vendor storage.

Start a managed session

cb run keeps the interactive terminal attached to the chosen agent. It records observable project state and reconciles the repository after the agent exits; it does not parse terminal escape sequences or impersonate an agent UI.

12cd /path/to/project
cb run opencode

For OpenCode, the interactive session deck lets you choose a new session, an existing import, a continuation, or a local session list. Use cb sessions to list canonical bridge sessions and cb show <bridge-session-id> to inspect one.

Configure the local boundary

The data directory is local and configurable. Use cb config path to see the active configuration and CB_DATA_DIR when a machine needs a dedicated private storage location.

123cb config path
CB_DATA_DIR="$HOME/.local/share/context-bridge" cb sessions
cb config set security.redaction strict

Repository-local .context-bridge.toml files are deliberately restricted by default. Review one before using --trust-project-config, because that switch allows privileged settings such as storage, redaction policy, and executables.

Continue with Import and continue when the session already exists in OpenCode, or with Privacy and data when deciding what a local export may contain.