Install Daintree
System requirements, downloading and installing Daintree on macOS, Windows and Linux, the startup check for Git and Node.js, and installing the agent CLIs Daintree launches.
System requirements
Daintree runs on macOS, Windows, and Linux and bundles its Electron runtime. Its setup checks these four tools on your PATH; selected agents can add stricter prerequisites:
| Tool | Requirement | Why |
|---|---|---|
| Git | Required | Worktrees, diffs, and every review surface are built on it. No minimum version is enforced beyond Git being present and runnable. |
| Node.js | Required, v18.0.0 or later | Installs agent CLIs through npm and backs several agent runtimes. |
| npm | Recommended | Ships with Node.js. Missing npm produces a warning, not a block. |
GitHub CLI (gh) | Recommended | Provides an optional token-import route for the GitHub provider in Code Forge. Issues, pull requests and CI status use provider APIs. A warning, not a block. |
To launch a coding agent, install at least one agent CLI and make it available on your PATH. Terminals, browsers, and other workspace tools are usable without one. See Installing agent CLIs below, and AI Agents for the full roster of 17 built-in agents.
Remote Hosts, which runs a window's projects and agents on another machine, needs macOS or Linux on the machine you sit at to reach a Mac, a Linux machine or a cloud machine; on Windows it reaches Linux distributions in WSL on the same PC. A host can be a headless x64 or arm64 Linux server with no display. See Set Up a Linux Host.
.nvmrc and engines floor. See Build From Source if that's the path you're on.The startup Git check
A missing Git used to surface as a raw spawn git ENOENT part way into your first
clone. Daintree now probes for the two required tools, Git and Node.js, shortly after first
paint and shows a global banner when one is missing or too old: Git is
missing, Node.js is out of date, or Required tools are
missing when more than one is absent. The banner says what will fail until it is
fixed (Git operations, agent launches) and shows the exact install command underneath. A Missing required tools entry also lands in your inbox once per session, so the
warning survives a higher-priority banner taking the slot.
The check re-runs when you come back to the Daintree window, so installing Git while Daintree is open clears the banner without a restart. The probe is deliberately off the boot path: it spawns subprocesses and re-reads your PATH, and neither belongs in front of first paint.
The one-click install button (Install Git, Install Node.js) is not available everywhere:
- macOS. Runs
brew install git(orbrew install node). When the probe finds that Apple's Command Line Tools are what's missing, the button reads Open installer instead: it runsxcode-select --install, which hands off to Apple's own GUI installer, and the banner changes to Finish the macOS installer, then re-check. - Windows. Runs the winget install.
- Linux. Daintree offers commands for your distribution: apt on Debian and Ubuntu, dnf on Fedora and RHEL, pacman on Arch, and zypper on SUSE. An unknown distribution gets a manual install guide. Commands that require
sudomust run in your own terminal so you can answer the password prompt; use the copy control or View install guide. See the Linux release changes.
The button also disappears if the package manager it would call isn't itself on your PATH. Homebrew is not a given on macOS and winget is absent from plenty of Windows images, and a button that can only fail is worse than no button. A finished install is confirmed by a fresh probe, not by the installer's exit code; if the tool still isn't usable the banner turns into Couldn't install Git (or whichever tool it was) with a Retry.
Download & install
Download the latest release for your platform. Architecture (x64 vs arm64) is a separate question from the packaging format. Pick the format you want; Daintree sorts out the architecture:
| Platform | Format | Architecture |
|---|---|---|
| macOS | DMG / ZIP | Apple Silicon (arm64), Intel (x64), or Universal |
| Windows | NSIS installer (direct download) / Microsoft Store | NSIS: x64 + arm64 / Store: x64 |
| Linux | AppImage / DEB | x64 + arm64 |
Most people want the DMG on macOS and the NSIS installer on Windows.
Open the .dmg file and drag Daintree into your Applications folder. On first launch, macOS may ask you to confirm the app, since it comes from an identified developer.
There are two ways to install on Windows:
- Direct download (NSIS installer). Run the
.exeand follow the prompts. Separate x64 and arm64 installers are published; each installs per-user (no admin rights needed) and updates itself in the background. - Microsoft Store. Install Daintree as a Store app (x64). Windows handles updates instead of Daintree's in-app updater.
Windows is fully tested and supported.
Daintree reads the Windows registry (HKLM and HKCU Environment keys) at startup and supplements your PATH with common tool locations. Tools installed via npm, Git, Scoop, Chocolatey, Volta, pnpm, fnm, and nvm-windows show up without restarting your terminal session.
For the integrated terminal, Daintree uses PowerShell 7 (pwsh.exe) if it's on your PATH, falls back to Windows PowerShell 5 (powershell.exe), and finally to cmd.exe.
Linux builds are x64 and arm64 and require glibc 2.34 or later, such as Ubuntu 22.04, Debian 12, Fedora 35 or RHEL 9 and newer. Daintree runs under X11 and Wayland.
The DEB package is the option to use on Ubuntu and Debian-based distributions. It handles desktop integration, AppArmor sandbox configuration, and PATH setup for you:
sudo apt install ./daintree_*.deb The DEB installer creates a /usr/bin/daintree symlink and loads the AppArmor profile that the Chromium sandbox needs on Ubuntu 24.04+.
The AppImage is an alternative for distributions that provide the required system libraries and Chromium sandbox support:
chmod +x Daintree-*.AppImage
./Daintree-*.AppImage XDG_SESSION_TYPE at startup and turns on native Wayland rendering, window decorations, and IME input support. No flags or environment variables required.Linux uses the native OS title bar rather than a custom frameless window, so Daintree follows your desktop environment's window decoration theme.
Installing agent CLIs
Daintree runs AI coding agents as CLI processes: it doesn't bundle any of them. Install the ones you plan to use, or let the setup wizard run these commands for you. The commands below reflect Daintree's checked-in installation options. Some are manual commands; a script piped to a shell is shown for you to copy, not executed by the wizard.
Claude Code
npm install -g @anthropic-ai/claude-code Then authenticate with claude auth login. For one-off use without a global install, run npx @anthropic-ai/claude-code instead.
Codex CLI
npm install -g @openai/codex Then authenticate with codex auth login.
OpenCode
npm install -g opencode-ai@latest OpenCode also installs through platform-specific methods:
curl -fsSL https://opencode.ai/install | bash Also available via Homebrew:
brew install opencodescoop bucket add extras
scoop install extras/opencode Also available via Chocolatey:
choco install opencodecurl -fsSL https://opencode.ai/install | bash Also available via Homebrew, or Paru on Arch:
brew install opencode
paru -S opencode-binCursor Agent
curl https://cursor.com/install -fsS | bashirm 'https://cursor.com/install?win32=true' | iexcurl https://cursor.com/install -fsS | bashOnce it's installed, run cursor-agent login to authenticate.
Kiro
curl -fsSL https://cli.kiro.dev/install | bash Confirm the install with kiro-cli --version, then sign in through Kiro's login flow. The Kiro CLI documentation has the rest.
Copilot
npm install -g @github/copilot Confirm the install with copilot --version, then sign in:
copilot login The Copilot CLI documentation has the rest.
node --version before you install.Linux release requirements and packaging: platform test fixes.