Guides & Tutorials

Task-oriented walkthroughs. Each guide answers a specific "how do I do X?" with numbered steps and a concrete outcome. Not reference documentation — if you want that, Using Codebolt and Reference have it.

How to use this section

Find the guide closest to your goal and follow the steps. Guides assume:

• You've finished Quickstart and first-run checklist.
• You have a provider configured and a project open.
• You're comfortable reading code — most guides show small config/code snippets.

Index

First steps

Things everyone should try once.

• Build your first agent — a minimal custom agent, level 0 (remix) to level 1 (framework).
• Publish an agent to the marketplace
• Connect a local model — Ollama or llama.cpp
• Set up git integration

Everyday workflows

Real tasks people actually do with Codebolt.

• Code review with an agent
• Bulk refactor with checkpoints
• Write tests from a spec
• Debug a hung agent
• Use Ctrl+K for inline edits

MCP & tools

Extending what agents can do.

• Install a third-party MCP server
• Build your first MCP server
• Write a simple hook

Multi-agent

Patterns in practice.

• Build a code-review swarm
• Build a plan-execute-review flow
• Design a debate pattern

Providers and models

Getting your LLMs set up.

• Use OpenAI
• Use Anthropic
• Use Ollama locally
• Bring your own provider

Advanced

For when you're ready to dig in.

• Replay an agent run
• Query the event log
• Self-host for a team

Suggesting a guide

If you've figured out how to do something that isn't here, a guide is the easiest way to contribute back. Keep it small, concrete, and one-outcome.