diridiri runs Claude Code, Codex, Cursor, Gemini and 16 other terminal agents side by side in one native window. It tells you which agents are working, which ones need you, and which are done. Every agent can get its own git worktree, and every change lands in one place to review.
Start here
| Page | What you get |
|---|---|
| Install | macOS and Linux packages, updates, and where diri keeps its data. |
| Quickstart | Your first agent session, start to finish. |
| Keyboard shortcuts | Every binding, grouped by task. |
How diri fits together
diri has three parts. You mostly see the first one.
| Part | What it does |
|---|---|
| The app | The window: sidebar, terminals, changes, notes, settings. Closing it never stops an agent. |
| The Engine | A background process that owns every session, its status, worktrees and history. The app and the CLI both talk to it. |
| Holders | One small process per session that owns the terminal. Agents keep running when the app or the Engine restarts. |
Agents you start inside diri can reach the Engine too, through the built-in MCP server. That is how one agent starts helpers, hands them tasks, waits for results and merges their branches.
Work with many agents
- Sessions: status, notifications, the sidebar, history, and what survives a restart.
- Worktrees and review: give each task its own checkout, then review and bring the changes back.
- Notes: plans and to-do lists you can hand to agents.
- Recipes: save a task and rerun it in one click.
- Accounts and usage: switch accounts and see what you spend.
Automate
- MCP server: what agents can do with diri, and how to connect any agent.
- MCP tool reference: every tool and argument, generated from the server itself.
- dirijor CLI: script sessions, worktrees and notes from a terminal.
- Supported agents: what each agent supports, and how to add your own.
Use these docs from an agent
Every page has a Markdown version: add .md to its path, for example /docs/mcp.md. llms.txt lists them all and llms-full.txt has the whole set in one file. To let an agent search the docs itself, add the docs MCP server:
Terminal
claude mcp add --transport http diri-docs https://diri.sh/mcp