Install and first run

This is the short path: install the terminal agent, sign in once, and open it inside the project you want it to work on.

1. Check the runtime

node --version

BCCLI needs Node.js 22 or newer.

2. Install

npm install -g @botconnector/bccli

The same command updates an existing install, because the default npm tag tracks the current stable release.

3. Sign in

bccli login

Credentials are saved per provider. To use a different provider later, pass its id: bccli login [provider].

4. Open a project

cd your-project
bccli

Start it inside the directory the agent should work on. BCCLI reads code, edits files, and runs commands from there — it is scoped to your project folder, not to the whole machine.

5. Confirm it works

Inside the session, type / to see the slash commands, and /model to see which model this session is using. If nothing comes back, the provider behind that model is not signed in on this machine; see BCCLI diagnostics.

What next

• BCCLI models — pick a provider and a model per run.
• Interactive session — how a session behaves once it is open.
• Install details — version pinning, prereleases, and PATH problems.