Guide
How Blitz behaves, whichever program you drive it from. The CLI, the service and the desktop app share one engine and one set of settings, so everything here applies to all three unless a page says otherwise.
- A workspace is a folder you opened in Blitz, and what Blitz keeps for it: its chats, notes, search index and your private settings for it, all in
~/.blitz, never in the folder. One owner holds it at a time (the service, or a CLI with--local). - A project is what’s in the repository: the code, and what’s committed with it for agents, such as
.blitz/settings.toml(project settings, which need your trust),.agents/AGENTS.md, and the project’s agents, skills and commands. - A repository is git’s. A workspace is usually a repository’s top folder, but can be a folder inside one.
So “workspace settings” are yours and private; “project settings” travel with the code and are trusted before they apply.
| Page | |
|---|---|
| Configuration | Where settings live, providers, API keys, per-workspace settings |
| Safety | Approvals, permission modes and rules, the sandboxes, checkpoints, the audit log |
| Models | Retries, fallback models, per-agent models, per-model settings, cost |
| Agents and tools | Using and switching agents, agency, a model per agent, writing your own, delegation, the tools |
| MCP servers | Adding a server’s tools, its approvals, prompts and resources, and what to do when one misbehaves |
| Extending | Project memory, hooks, custom commands, plugins |
| Workers | Prompts on a schedule, unattended, with only the permissions you give them |
| Workflows | Steps run in order, each one’s output the next one’s input: /name in the chat, or built on a canvas |
| Workspace health | Studio’s Overview: what the workspace holds, how its runs go, and each item’s grade, judged on the evidence |
| Evals | Cases that check your agents still answer as they should, from Studio or blitz eval in CI |
| Skills | Agent Skills, the skills policy, sandboxed scripts |
| Search | Web search providers, /search web and /search session |
| Images | Attaching screenshots and pictures |
| Language | The interface and reply languages |
| Logs and telemetry | The diagnostic log and OpenTelemetry |
| GitHub Action | Blitz in GitHub Actions: answering mentions, reviewing pull requests, issues into pull requests |