boldcreate-acp
v0.2.0
Published
ACP (Agent Client Protocol) adapter that lets editors such as Zed and JetBrains run the BoldCreate coding agent
Maintainers
Readme
boldcreate-acp
Bring the BoldCreate coding agent into your editor. Chat with BoldCreate, let it read your code, run commands, and edit files — all from inside the editor you already use.
Overview
boldcreate-acp is a small bridge that connects your editor to the BoldCreate CLI using the Agent Client Protocol (ACP).
Your Editor ◄──── ACP ────► boldcreate-acp ◄────► BoldCreate CLI- The editor shows the chat UI, agent dropdown, and tool calls.
boldcreate-acptranslates between the editor's ACP messages and the BoldCreate CLI.- The BoldCreate CLI owns your sign-in, runs the model, and does the work in your project folder.
Supported Editors
| Editor | Setup | After install | |---|---|---| | Zed | Automatic | Agent panel → + → BoldCreate | | JetBrains IDEs (IntelliJ, PyCharm, WebStorm, etc.) | Automatic | AI Chat → pick BoldCreate |
Prerequisites
- Node.js 22 or newer — download from nodejs.org
- An editor from the list above
- A BoldCreate account — you'll sign in from your editor on first use
That's it. The installer handles the BoldCreate CLI for you.
How to Install
Open a terminal and run:
npm install -g boldcreate-acpThat one command does three things automatically:
- Installs the BoldCreate CLI if it isn't already on your machine.
- Adds a BoldCreate entry to every supported editor it finds.
- Keeps your existing editor settings and customisations intact (never overwrites, only adds/updates).
Close your editor before installing so it doesn't hold the files open on Windows.
How to Use
- Open your editor (Zed, or JetBrains).
- Open the agent panel:
- Zed → Agent panel → + → BoldCreate
- JetBrains → AI Chat → pick BoldCreate
- The editor asks you to sign in — click Authenticate. Your browser opens, you sign in to BoldCreate, and the chat is ready.
- Start chatting. Ask BoldCreate to read a file, fix a bug, write tests, review your diff, or anything else.
Example things to try
/review → review the uncommitted changes in your project
/explain src/app.ts → get a plain-English explanation of a file
Fix the bug in auth.js that causes login to fail on empty passwords
Write unit tests for the price calculatorFeatures
🤖 The full BoldCreate agent, inside your editor
- Reads and writes files in your project
- Runs shell commands with your approval
- Follows your project's
.boldcreate/settings.json, skills, and plugins - Remembers the conversation across messages
- Streams the answer live (text, thinking, tool calls, file diffs)
🔀 Pick your agent, model, and reasoning per chat
Three dropdowns in every chat:
- Agent — Agent (edits code), Ask (answers only), Plan (plans first), plus any agent files in your project
- Model — every model your account can use
- Reasoning — None, Low, Medium, or High
⚡ Slash commands (type / in the chat)
| Command | What it does |
|---|---|
| /help | List every command |
| /login, /logout, /status | Manage your BoldCreate sign-in |
| /agents, /model, /thinking | Switch the agent, model, or reasoning level |
| /review, /explain, /diff | Review changes, explain code, see uncommitted diffs |
| /skills, /plugins, /mcp | Use your installed skills, plugins, and MCP servers |
| /new, /retry, /export | Start fresh, retry, export the chat as Markdown |
| /doctor, /repair | Check or re-register the editor setup from inside a chat |
🔒 Secure by design
boldcreate-acpnever touches your tokens — the CLI owns them (encrypted in~/.boldcreate, key in the OS keychain).- All editor arguments are validated before reaching the CLI; no shell injection.
- The CLI installer only runs from an HTTPS URL (
boldcreate.ai) with no shell metacharacters allowed.
🛡️ Preservation-first installs
- Your existing editor settings are never overwritten — the installer only changes the
BoldCreateentry. - User-added fields (your own
description,icon, env vars) are kept intact. - The previous settings file is saved as
<file>.bakon every change, and older backups as<file>.bak.<timestamp>(up to 3 kept per file). - Re-running the install on an already-configured machine shows "already up to date, nothing changed" instead of touching files.
🩺 Built-in diagnostics
boldcreate-acp status # what's installed, nothing modified
boldcreate-acp verify # end-to-end validation (optional --fix)
boldcreate-acp update # update the BoldCreate CLI in placeHow to Update
Close your editor first (so no files are held open), then:
npm install -g boldcreate-acp@latestThe installer detects what's already there and only updates what's changed. Your editor settings, sign-in, custom agents, and skills are all preserved.
To update just the BoldCreate CLI:
boldcreate-acp updateHow to Uninstall
# Remove BoldCreate from your editors' settings (keeps the CLI and your sign-in)
boldcreate-acp setup --remove
# Then uninstall the package
npm uninstall -g boldcreate-acpYour .bak files are left in place so you can restore your original editor settings if you want.
Troubleshooting
| Problem | Fix |
|---|---|
| EEXIST or EPERM during install on Windows | Close every editor (Zed, VS Code, JetBrains) and any running boldcreate-acp process, then re-run npm install -g boldcreate-acp |
| "Node.js is too old" in the editor's agent log | Install Node.js 22+ from https://nodejs.org, then run boldcreate-acp setup |
| BoldCreate doesn't appear in the editor | Run boldcreate-acp setup manually, then restart the editor |
| "Not signed in" on every chat | Type /login inside the chat, or run boldcreate login in a terminal |
| Anything else | Run boldcreate-acp doctor for a full checklist with fix instructions |
Environment Variables
| Variable | Purpose |
|---|---|
| BOLDCREATE_ACP_COMMAND | Explicit path to the boldcreate CLI binary |
| BOLDCREATE_ACP_SKIP_SETUP=1 | Skip automatic editor configuration during npm install -g |
| BOLDCREATE_ACP_SKIP_CLI_INSTALL=1 | Skip automatic CLI download during npm install -g |
| BOLDCREATE_ACP_TELEMETRY=1 | Opt in to local-only telemetry at ~/.boldcreate/acp-telemetry.jsonl (nothing is sent anywhere) |
| BOLDCREATE_INSTALL_URL | Mirror URL for the CLI installer script (must be HTTPS) |
Links
License
MIT
