https://github.com/daintreehq/daintree
A delegation environment for orchestrating AI coding agents. Manage Claude, Gemini, and Codex sessions across git worktrees with integrated terminals, context injection, and workflow automation.
https://github.com/daintreehq/daintree
ai-agents claude codex developer-tools electron gemini git-worktrees ide
Last synced: 13 days ago
JSON representation
A delegation environment for orchestrating AI coding agents. Manage Claude, Gemini, and Codex sessions across git worktrees with integrated terminals, context injection, and workflow automation.
- Host: GitHub
- URL: https://github.com/daintreehq/daintree
- Owner: daintreehq
- License: other
- Created: 2025-11-28T04:38:21.000Z (7 months ago)
- Default Branch: develop
- Last Pushed: 2026-06-07T08:55:04.000Z (14 days ago)
- Last Synced: 2026-06-07T09:16:11.739Z (14 days ago)
- Topics: ai-agents, claude, codex, developer-tools, electron, gemini, git-worktrees, ide
- Language: TypeScript
- Homepage: https://daintree.org
- Size: 102 MB
- Stars: 41
- Watchers: 2
- Forks: 6
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
README
A habitat for your AI coding agents.
Run several agents in parallel, each in its own worktree, isolated and observable, with you still in the loop.
## Install
Builds for macOS, Windows, and Linux live at [daintree.org/download](https://daintree.org/download). macOS ships as a signed-and-notarized DMG in `arm64`, `x64`, and universal variants. Linux ships as `AppImage` and `.deb`. Windows ships as a sideloadable `.appx` while the Microsoft Store listing is in review. Homebrew and winget recipes are coming.
## The problem
- **Agent fatigue.** Five terminals, three agents, no clue who's stuck.
- **Worktree sprawl.** Every agent wants its own branch. Managing five at once is its own job.
- **Review is the bottleneck.** Generation is fast. Supervising what came back is what eats the day.
Daintree is the macro-orchestration layer for this workflow. The longer version of the pitch is in [docs/vision.md](docs/vision.md).
## Daintree Assistant
Daintree is built for running a large number of AI coding agent terminals in parallel across many git worktrees. That's the main job of the app. The **Daintree Assistant** sits on top of that and drives it for you. It runs on the agent CLI you already have, whether that's Claude Code, Gemini CLI, Codex, or GitHub Copilot CLI, so there's no extra subscription. From there it can spawn new agent terminals in any worktree, broadcast a single prompt to many at once, watch their progress, inject context, run git operations, and report back. Anything you can trigger from Daintree's action palette, the Assistant can trigger too.
Under the hood it's a sandboxed agent session. When the backend is Claude Code, it attaches to a local `daintree` MCP server that exposes the action system at the authorization tier you grant. It also connects to a live `daintree-docs` server so it can answer how-to questions about Daintree on the side.
What that looks like in practice:
- Spawn six Claude Code terminals across six worktrees and broadcast the same prompt to all of them.
- Watch every agent panel and tell you which ones are waiting on input and which finished.
- Run any Daintree action by name: switch projects, dock panels, kick off a dev server, run a git op.
- Subscribe to events so it pings you when the agent in `bugfix/foo` stops responding.
## Features
- **Fleet Broadcasting.** One prompt fans out to N agents. Target filtering, live draft preview, per-agent edits before send.
- **Worktree Dashboard.** Every branch in one view. Auto PR and issue detection, dev-server lifecycle, commit composer.
- **Context Injection.** Select files, ship structured context into any agent's terminal. Built on [CopyTree](https://github.com/gregpriday/copytree).
- **MCP Server.** Agents call Daintree actions directly. Per-tier authorization, audit log, idempotency.
- **Action Palette + 14 themes.** Over 300 keyboard-first actions and a palette-based theme system with accessibility tokens.
- **Notification Center.** Agents run unattended. The inbox tells you what needs you and what can wait.
- **Voice input.** OpenAI Realtime dictation for quick prompts. Optional, needs an API key.
A screenshot-driven feature grid lands in the next pass.
## Works with
Claude Code, Gemini CLI, Codex, GitHub Copilot CLI, Cursor, Aider, OpenCode, Goose, Crush, Qwen Code, Open Interpreter, Mistral Vibe, Kimi Code, Kiro, and Amp.
## Build from source
Clone, install, then run the package command for your platform. Builds land in `release/` by default; pass `-c.directories.output=` to electron-builder if you want them somewhere else.
```bash
git clone https://github.com/daintreehq/daintree.git
cd daintree
npm install
```
| Platform | Command | Output |
| -------- | ----------------------- | -------------------------------------- |
| macOS | `npm run package:mac` | `.dmg`, `.zip` (arm64, x64, universal) |
| Windows | `npm run package:win` | `.appx`, `.msix` |
| Linux | `npm run package:linux` | `.AppImage`, `.deb` |
The `postinstall` step rebuilds `node-pty` for Electron automatically. If you see PTY errors, run `npm run rebuild`.
For AI features, open **Settings** (bottom-left sidebar) and configure your GitHub token and per-agent defaults.
## Install agent CLIs
Daintree works with whatever agent you've already installed. **Settings → Agents** has a one-click installer for each platform — or follow the canonical install docs:
| Agent | Install docs |
| --- | --- |
| Claude Code | [code.claude.com/docs/en/setup](https://code.claude.com/docs/en/setup) |
| Gemini CLI | [geminicli.com/docs](https://geminicli.com/docs) |
| Codex CLI | [github.com/openai/codex](https://github.com/openai/codex) |
| Cursor Agent | [cursor.com/cli](https://cursor.com/cli) |
| GitHub Copilot CLI | [docs.github.com/…/install-copilot-cli](https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli) |
| Crush | [github.com/charmbracelet/crush](https://github.com/charmbracelet/crush) |
| Amp | [ampcode.com/manual](https://ampcode.com/manual) |
| OpenCode | [opencode.ai/install](https://opencode.ai/install) |
| Aider | [aider.chat/docs/install.html](https://aider.chat/docs/install.html) |
| Goose | [goose-docs.ai/docs/getting-started/installation](https://goose-docs.ai/docs/getting-started/installation) |
See [Works with](#works-with) for the full list of agents Daintree can launch.
## Documentation
- [Architecture](docs/architecture/): system design, IPC patterns, terminal lifecycle
- [Development guide](docs/development.md): setup, debugging, contribution workflow
- [Theme system](docs/themes/theme-system.md): theme pipeline, tokens, runtime
- [E2E testing](docs/e2e-testing.md): Playwright setup and patterns
- [Release process](docs/release.md): versioning and release workflow
## License
Apache 2.0. See [LICENSE](LICENSE) and [TRADEMARKS.md](TRADEMARKS.md) for the brand and marks policy.