Skip to content

ctrlb v0.1.0

Latest

Choose a tag to compare

@adarshsrivastava11 adarshsrivastava11 released this 16 Nov 11:12
· 15 commits to main since this release
f18d438

ctrlb is the local CtrlB binary. It gives Claude Code and Codex session recall on your machine, and coordination between several agents with CtrlB Relay. It keeps its data in a SQLite file under ~/.ctrlb. It needs no account.

Install

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/ctrlb-hq/ctrlb-agent/releases/latest/download/install.sh | sh

The script downloads the binary for your system, verifies its SHA-256 and installs it in ~/.local/bin. Add that folder to your PATH if it is not there. Then initialize:

ctrlb init

To install this release by name, set the version on sh:

curl --proto '=https' --tlsv1.2 -fsSL https://github.com/ctrlb-hq/ctrlb-agent/releases/latest/download/install.sh | CTRLB_VERSION=v0.1.0 sh

Connect Claude Code

claude plugin marketplace add ctrlb-hq/ctrlb-agent
claude plugin install ctrlb-agent@ctrlb-agent

Put these two lines in your shell profile. They read the saved config and hold no key value:

export CTRLB_MCP_URL="$(python3 -I -c 'import json, os; print(json.load(open(os.path.join(os.environ.get("CTRLB_HOME") or os.path.expanduser("~/.ctrlb"), "config.json")))["mcp_url"])')"
export CTRLB_KEY="$(python3 -I -c 'import json, os; print(json.load(open(os.path.join(os.environ.get("CTRLB_HOME") or os.path.expanduser("~/.ctrlb"), "config.json")))["key"])')"

Open a new shell and start Claude Code. Check with ctrlb status.

Codex, several agents in one run, and the limits of local mode are in docs/local-mode.md.

Files

File System
ctrlb-darwin-arm64 macOS, Apple silicon
ctrlb-darwin-amd64 macOS, Intel
ctrlb-linux-amd64 Linux, x86-64
ctrlb-linux-arm64 Linux, ARM64
SHA256SUMS SHA-256 of each binary
install.sh Install script

SHA-256

5a5eaa79f066c3e7e5f22089b9394b95a7098be6a03e01491932dea063538fc9  ctrlb-darwin-arm64
2a1469d40a0a6debbc6cc39c1b7743c33ccdc07423d93ccd4c2eb054bf534338  ctrlb-darwin-amd64
d361aff8d7360a0c289adb85c4f39fc53ce8d90ad31705ec2896368ec905c6d3  ctrlb-linux-amd64
56a384af978b50c4aa3b869842a2020d6dde50535ae85e1be262101cf1d62185  ctrlb-linux-arm64