CLI

Brainbase CLI

The Brainbase CLI (brainbase) packs, shares, and installs agent templates across coding harnesses — Claude Code, Codex, and Kafka. It connects your local agent folder to the Brainbase platform so you can author an agent declaratively, push it to the cloud, pull a teammate's changes back down, and publish reusable skills and templates to the registry.

Separate control-plane and registry routing

Agent and orchestration operations use the Brainbase /v2/cli control plane. Registry operations and tracked harness model traffic continue through the registry and model gateway. The service URLs can be overridden independently; see Environment variables.

bash

npm install -g @brainbase-labs/cli
brainbase login
brainbase help

Start here

Installation

Install the CLI and verify it's on your PATH.

Quickstart

Authentication

Browser login and long-lived PATs for CI.

Agent manifest

Agent metadata, runtime provider/model, and components.

What you can do

Agents & linking

Bind a folder to a cloud agent; pull and push changes.

Templates

Pack a working agent into a versioned, installable template.

Skills

Install skills from GitHub, git, or the registry.

Orchestrations

Pull and push multi-agent graphs in one command.

Harnesses

How components map onto Claude Code, Codex, and Kafka.

Syncing & tracking

Keep a folder in sync and route LLM traffic for observability.

Command reference

Every command, grouped by area, lives in the command reference. Run brainbase help to print the same summary in your terminal.