Skip to main content

Using Codebolt

Reference documentation for every feature. Read pages as you need them — this isn't meant to be read cover-to-cover.

If you're looking for a step-by-step walkthrough of a specific task, try Guides & Tutorials instead. If you're writing code against Codebolt, see Build on Codebolt.

Feature map​

The interface​

The app is divided into a few durable areas:

  • Project panel — file tree, search, git status, codemap entry.
  • Chat tabs — one or more conversations, each bound to an agent and model. See Chat Overview.
  • Status bar — connection, active agents, diagnostics.
  • Command palette (Ctrl+K) — inline edits and quick actions. See Inline edit and Ctrl+K.
  • Settings — providers, agents, guardrails, themes, profiles. Per-workspace and per-user layers.

See The Interface for the detail.

Chat​

The main way you interact with agents. Key features:

  • Tabs and history. Multiple parallel conversations, each with its own thread.
  • Checkpoints. Every change is rollback-able via shadow git, without touching your real git. See Checkpoints and rollback.
  • @-mentions and context. Explicitly add files, symbols, or past turns to the prompt. See Context and @-mentions.
  • Ctrl+K inline edit. Edit a selection in place without opening a chat. See Inline edit.
  • Model picker per tab. Different tabs can use different models, even different providers.

Agents​

Codebolt ships with default agents and supports more from the marketplace. Agents are real processes; each runs isolated.

  • Built-in agents — a generalist, a reviewer, a planner, and a few specialists. See Built-in agents.
  • Marketplace — install community-authored agents. See The marketplace.
  • Portfolios — curate which agents are available in which workspace. See Agent portfolios.
  • Debugging — inspect a running or failed agent. See Debugging an agent.

Tools & MCP​

Agents use tools to do things. Three flavours, all invoked through the same interface:

CLI and TUI​

Not everyone wants a desktop app. The CLI provides the same surface over a terminal, and the TUI gives you a full-screen terminal interface. See CLI & TUI.

Multi-agent usage​

Running swarms and flows. The design side lives under Build on Codebolt; the running side is here:

Integrations​

LLM providers, local models, git, browser control, mail, calendar, chat widget. See Integrations.

Account​

Sign-in, teams, usage, billing. See Account.

When something goes wrong​

See Troubleshooting. If you're filing a bug, Reporting bugs has the template.