JSPM – codebase-cli@2.0.0-pre.51

Package Exports

codebase-cli
codebase-cli/dist/cli.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (codebase-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

codebase

An AI coding agent for builders.
Lives in your terminal. Reads your project, writes code, runs commands, ships work.

Powered by pi · The agent loop, provider adapters, and session protocol come from pi-mono.

Two ways to run it

Bring your own LLM. Drop an API key in your shell and go — Anthropic, OpenAI, Groq, OpenRouter, Mistral, Ollama, any OpenAI-compatible endpoint.

ANTHROPIC_API_KEY=sk-ant-... codebase
# or
OPENAI_API_KEY=sk-... codebase

Or sign in once via codebase.design and try open-weight models instantly with no key setup — MiniMax, Qwen, Llama, and others routed through our inference proxy. One auth, every model.

codebase auth login
codebase

Install

Requires Node.js ≥ 20.

# one-liner (macOS / Linux)
curl -fsSL https://codebase.design/install.sh | sh

# Windows (PowerShell)
irm https://codebase.design/install.ps1 | iex

# any platform
npm i -g codebase-cli

Quick start

cd your-project
codebase

Type. Hit enter. The agent reads files, runs tests, edits code, and shows you what it did. Slash /help for the rest.

A few things worth knowing:

/model — pick a model interactively (live list of what your account can hit)
/plan — Q&A before the agent touches anything
!cmd — run a shell command without spending a turn
@path — pin a file into the next prompt
\<Enter> — multi-line input
Ctrl-C stops the current turn, twice fast exits

Builder-focused defaults

Any LLM, not just Anthropic. Provider choice is config.
45+ tools that all live behind one small interface — adding one is mechanical.
Effect-based permissions instead of tool-name allowlists.
Single immutable state driven by a typed reducer — the whole UI is one render of one value.
Multi-process safe OAuth with lockfile-coordinated token refresh — run 10 instances of codebase at once and they share a single refresh per hour.
Plain npm i -g, single binary, no bundler lock-in.

.settings/ — orientation: tenets, architecture, extending, testing
CLAUDE.md — quick reference for AI agents working in this repo
docs/MIGRATION_v1_to_v2.md — upgrading from the Go v1 binary
/help in the CLI — every slash command and shortcut

License

MIT. Built on pi-mono (MIT).

codebase-cli