# Kabul

> Free, open-source app for macOS. Run Claude Code, Codex, Gemini, Qwen and local models in parallel, each on its own git worktree, and switch models without losing the conversation. Kabul drives the real agent CLIs (Claude Code, Codex, Antigravity, Gemini CLI, Qwen Code, OpenCode, Goose), keeps one conversation across models and accounts, lets a friend join the session and puts every session on your phone. Local-first, no telemetry, MIT licensed. Current version: 0.9.0.

Kabul is a desktop app (macOS 14+, Apple Silicon and Intel; Windows 10/11 in beta) built with Rust, Tauri and React. Each task gets its own workspace: a git worktree on its own branch with its own ports, terminal and chats. You bring your own agent subscriptions or API keys; Kabul has no server of its own and never reads your tokens.

- Website: https://kabul.dev/ (English) and https://kabul.dev/pt-BR/ (Português)
- Documentation: https://valteracetto.github.io/kabul/ (English) and https://valteracetto.github.io/kabul/pt-BR/ (Português)
- Source code and releases: https://github.com/valteracetto/kabul

## Site

- [Kabul, the full page in English](https://kabul.dev/index.md): what Kabul is, what it does differently, features, supported agents, phone app, quick start, performance, security, Kabul Cloud and FAQ
- [Kabul, a página completa em português](https://kabul.dev/pt-BR/index.md): the same page in Portuguese (Brazil)
- [Everything in one file](https://kabul.dev/llms-full.txt): the English page plus install steps, the agent support table and links to every docs page

## Docs

- [Quick start](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/quick-start.md): install Kabul, sign in to an agent and run the first task. Web: https://valteracetto.github.io/kabul/guide/quick-start
- [Installation](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/installation.md): requirements, the .dmg, the agent CLIs and building from source. Web: https://valteracetto.github.io/kabul/guide/installation
- [Windows (beta)](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/windows.md): what works on Windows 10 and 11 and what doesn't yet. Web: https://valteracetto.github.io/kabul/guide/windows
- [Concepts](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/concepts.md): repositories, workspaces (git worktrees), chats, harnesses and checkpoints. Web: https://valteracetto.github.io/kabul/guide/concepts
- [Agents and harnesses](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/agents.md): every supported agent CLI, how Kabul talks to it and what it supports. Web: https://valteracetto.github.io/kabul/guide/agents
- [Local models](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/local-models.md): LM Studio, Ollama, llama.cpp, vLLM and MLX, and how each model family is routed. Web: https://valteracetto.github.io/kabul/guide/local-models
- [Switching model or account](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/switching.md): the handoff that keeps the conversation when the model, provider or account changes. Web: https://valteracetto.github.io/kabul/guide/switching
- [MCP](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/mcp.md): one registry for the MCP servers of every CLI, on or off per session. Web: https://valteracetto.github.io/kabul/guide/mcp
- [Usage, costs and limits](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/usage.md): tokens and cost per workspace, model and account; limit windows and alerts. Web: https://valteracetto.github.io/kabul/guide/usage
- [Cloud and mobile](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/cloud-and-mobile.md): the phone app (PWA) over Tailscale, pairing and notifications. Web: https://valteracetto.github.io/kabul/guide/cloud-and-mobile
- [Collaboration](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/collaboration.md): inviting someone into a workspace as editor or observer. Web: https://valteracetto.github.io/kabul/guide/collaboration
- [Git and pull requests](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/git.md): diff, review comments, commit, push, PR checks and merge. Web: https://valteracetto.github.io/kabul/guide/git
- [Scripts and settings](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/scripts.md): setup, run and archive scripts, ports and per-repository settings. Web: https://valteracetto.github.io/kabul/guide/scripts
- [KABUL_* variables](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/environment.md): environment variables available to scripts and terminals. Web: https://valteracetto.github.io/kabul/guide/environment
- [Integrations](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/integrations.md): Linear, GitHub accounts and routines. Web: https://valteracetto.github.io/kabul/guide/integrations
- [Keyboard shortcuts](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/shortcuts.md): every shortcut in the desktop app. Web: https://valteracetto.github.io/kabul/guide/shortcuts
- [Dictation](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/dictation.md): talking to the agent instead of typing. Web: https://valteracetto.github.io/kabul/guide/dictation
- [Themes](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/themes.md): dark and light themes. Web: https://valteracetto.github.io/kabul/guide/themes
- [Performance and scale](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/performance.md): how Kabul handles 100 workspaces and 30 agents, with the measured budgets. Web: https://valteracetto.github.io/kabul/guide/performance
- [Security](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/security.md): threat model: local-first, the phone server, guests and secrets. Web: https://valteracetto.github.io/kabul/guide/security
- [FAQ](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/faq.md): common questions. Web: https://valteracetto.github.io/kabul/guide/faq
- [Contributing](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/guide/contributing.md): how to build, test and send a pull request. Web: https://valteracetto.github.io/kabul/guide/contributing

## Project

- [README](https://raw.githubusercontent.com/valteracetto/kabul/main/README.md): overview, screenshots and install
- [README em português](https://raw.githubusercontent.com/valteracetto/kabul/main/README.pt-BR.md): the README in Portuguese
- [Changelog](https://raw.githubusercontent.com/valteracetto/kabul/main/CHANGELOG.md): what changed in each version
- [Security policy](https://raw.githubusercontent.com/valteracetto/kabul/main/SECURITY.md): how to report a vulnerability privately
- [Contributing](https://raw.githubusercontent.com/valteracetto/kabul/main/CONTRIBUTING.md): layout, commands, commits and CI
- [Acknowledgments](https://raw.githubusercontent.com/valteracetto/kabul/main/ACKNOWLEDGMENTS.md): created by Valter Acetto, built with Claude

## Optional

- [Documentação em português](https://raw.githubusercontent.com/valteracetto/kabul/main/docs/pt-BR/guia/inicio-rapido.md): start of the Portuguese guide; every English page has a Portuguese twin under docs/pt-BR/guia/
- [License (MIT)](https://raw.githubusercontent.com/valteracetto/kabul/main/LICENSE)
- [Sitemap](https://kabul.dev/sitemap.xml)