BCCLI

An AI coding agent in your terminal.

BCCLI works inside your project folder. It reads the code, edits files, runs commands and tests, and asks before it changes anything. Use it with BotConnector Cloud, your own provider keys, or a model on your own machine.

npm install -g @botconnector/bccli

Needs Node.js 22 or newer. Works on Windows, macOS and Linux.

You stay in control of every change

Permission prompts. Before an edit or a shell command BCCLI shows what it will do. Answer once, for the session, or for everything.
Four modes. Shift+Tab switches between default, accept edits, plan (read only) and allow all.
Undo per turn. /undo restores the files the agent changed in its last turn, including new files it created.
See the diff. /diff shows what changed in the repository, including untracked files.

> add email validation to signup.js

⎿ Read  signup.js
⎿ Edit  signup.js
  + if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(email)) throw new Error('invalid email')
  Allow edit to signup.js?  [y] yes  [a] always  [s] yes to all  [n] no

What it can do

Work on real projects

Read, write and edit files, search with grep and glob, run shell commands, fetch web pages and search the web.

Use any model

BotConnector Cloud, OpenRouter, OpenAI, Gemini, DeepSeek, Groq, Ollama Cloud, and local Ollama or LM Studio. Switch with /model.

Keep sessions

History is saved per project folder. Start over with /new, go back with /resume, export with /export.

Delegate

Subagents take side tasks: explore for read-only research, general for everything else, or your own in .bccli/agents.

Extend

Add MCP servers with /mcp or bccli mcp add. Skills and custom commands load from .bccli and .claude.

Script it

bccli -p "task" runs one task without prompts, for CI and scripts. Tools that need permission are denied unless you allow them.

Commands

Command	What it does
`bccli`	Start an interactive session in the current folder.
`bccli -p "task"`	Run one task and print the result (scripts and CI).
`bccli -c` · `bccli -r`	Continue the last session, or pick one.
`bccli -m provider/model`	Choose the model, e.g. `bc-cloud/glm-5.3-flash` or `ollama/qwen2.5-coder:7b`.
`bccli models`	List models from every provider you have a key for.
`bccli login [provider]`	Save an API key.
`bccli mcp list \| add \| remove`	Manage MCP servers.
`/status` · `/doctor`	Inside a session: current model and mode; a health check of keys, connection, MCP and tools.
`/memory` · `/init`	Add project instructions to `AGENTS.md`, or let the agent write one for you.

All commands: type / in a session. Quickstart · Install guide · Looking for the open-source agent harness? See Switchboard.

Releases

Platform	Version	Artifact	Size	Status
Windows / Linux x64	0.4.9	`npm install -g @botconnector/bccli`	—	stable
macOS arm64 / x64	0.4.9	`npm install -g @botconnector/bccli`	—	stable