diri
Native macOS orchestrator for coding agents — run Claude Code, Codex, Cursor, Gemini and shells in parallel across git worktrees and remote hosts
What is it?
What it is
Native macOS orchestrator for coding agents that runs multiple agents (Claude Code, Codex, Cursor, Gemini, and any shell) in parallel, each in its own terminal PTY, with live status detection and tmux‑like persistence.
Why it exists
To provide developers with a single interface that can launch, monitor, and manage many coding agents simultaneously, giving trusted status feedback, session persistence across app restarts, and the ability for agents to orchestrate other agents.
Who should use it
macOS developers using AI coding agents (Claude Code, Cursor, Gemini) who need to manage multiple parallel agent sessions across different git worktrees or remote hosts with persistent terminal sessions.
Who should avoid it
Linux or Windows users (current builds are macOS only), users who do not use terminal-based coding agents, and developers looking for a cross-platform tool (as the engine port is still in progress).
How it works
A quick walkthrough in plain English
How diri works
Step 1 of 3
You interact with it
Open diri, send a request, or connect it to your stack.
Features
Advantages
- Open source (Apache-2.0)
- Active Rust ecosystem
- Self-hosted deployment options
Disadvantages
- Requires operational ownership for self-hosted setups
- Community support varies by project maturity
Installation
cloud
not available
docker
not available
native
brew install --cask cristicretu/diri/diri Or download the latest DMG from Releases, open it, and drag diri to Applications.
compose
not available
FAQ
How do I install diri on macOS?
You can install diri using Homebrew with the command `brew install --cask cristicretu/diri/diri`. Alternatively, download the latest DMG from the Releases page, open it, and drag the diri app to Applications. The app is a universal build for Apple Silicon and Intel, signed and notarized, and will update itself automatically.
What operating systems does diri support?
diri currently runs on macOS 15 or newer. A Rust port of the engine is in progress for Linux and Windows, but the released app only supports macOS.
How can I add support for a new coding agent?
Agent support is data-driven. Copy an existing JSON manifest from `Sources/DirijorCore/Resources/manifests/`, adjust the spawn command, resume logic, key approvals, and screen rules, and place it in the same directory. No Swift or Rust code changes are required.
What happens to my sessions when I quit the app?
Sessions are owned by the background daemon `dirijord`, which persists PTYs and session logs. Quitting the app does not kill sessions; reopening diri restores all active and completed sessions, and a daemon restart resumes them.
How do I build diri from source?
You need both Rust and Swift toolchains. First, run `swift build && swift test` in the root to build the engine, then `cd diri && cargo build` to build the app. Finally, run `cargo run -p diri-app` to start. For a full bundle, use `diri/scripts/package.sh` and install locally with `diri/scripts/install-local.sh`. Refer to `diri/PACKAGING.md`, `diri/UPDATING.md`, and `diri/NODE.md` for detailed instructions.
Featured in Videos
YouTube tutorials and walkthroughs for diri
Alternatives
Similar projects ranked by category, topics, and text overlap.
