Skip to main content

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.

Updated
Reviewed

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:

ToolRequirementWhy
GitRequiredWorktrees, diffs, and every review surface are built on it. No minimum version is enforced beyond Git being present and runnable.
Node.jsRequired, v18.0.0 or laterInstalls agent CLIs through npm and backs several agent runtimes.
npmRecommendedShips with Node.js. Missing npm produces a warning, not a block.
GitHub CLI (gh)RecommendedProvides 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.

Note
Node.js v18 is the setup checker's baseline for external tooling, not a guarantee that every agent supports it. Building Daintree from source uses Node 22.23.2, matching the repository's .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 (or brew install node). When the probe finds that Apple's Command Line Tools are what's missing, the button reads Open installer instead: it runs xcode-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 sudo must 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:

PlatformFormatArchitecture
macOSDMG / ZIPApple Silicon (arm64), Intel (x64), or Universal
WindowsNSIS installer (direct download) / Microsoft StoreNSIS: x64 + arm64 / Store: x64
LinuxAppImage / DEBx64 + 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 .exe and 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.

Note
The two builds update differently. The direct-download installer updates itself in the background. The Microsoft Store build hands the update cycle to Windows, so Daintree's in-app updater is disabled; when a new version lands you get an inbox notification with a link to the Store. See Updates for how the background update flow and release channels work.

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
Warning
If the AppImage fails at startup on Ubuntu 24.04 or later, check the terminal output for a sandbox or user-namespace error. The DEB package includes Daintree's AppArmor profile and is the supported route described here. The AppImage uses a static runtime and does not require FUSE 2. Avoid disabling the Chromium sandbox to get past a startup error.
Tip
Wayland is detected automatically. Daintree reads 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 opencode
scoop bucket add extras
scoop install extras/opencode

Also available via Chocolatey:

choco install opencode
curl -fsSL https://opencode.ai/install | bash

Also available via Homebrew, or Paru on Arch:

brew install opencode
paru -S opencode-bin

Cursor Agent

curl https://cursor.com/install -fsS | bash
irm 'https://cursor.com/install?win32=true' | iex
curl https://cursor.com/install -fsS | bash

Once 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.

Note
Daintree's Kiro install helper currently carries macOS and Linux commands. Kiro also provides a native Windows 11 installer; follow the Kiro guide for its current setup instructions.

Copilot

npm install -g @github/copilot

Confirm the install with copilot --version, then sign in:

copilot login

The Copilot CLI documentation has the rest.

Note
Daintree's setup check only enforces its general Node.js 18 baseline. The Copilot CLI sets its own Node.js requirement, which can be higher, so check its documentation and node --version before you install.
Warning
Daintree marks Gemini CLI as deprecated in its agent registry. Existing sessions still have documented launch and resume behavior; see the Gemini integration guide. For a new Google CLI setup, see Antigravity. Provider availability and account eligibility are separate from what Daintree can launch.
Tip
Daintree detects which agent CLIs are on your PATH and adjusts the UI to match. To see what it found, open Settings > CLI agents. The ten built-in agents not covered above (Aider, Antigravity, Grok, Goose, Amp, Crush, Qwen, Kimi, Open Interpreter, and Mistral) each have their own page under AI Agents.

Linux release requirements and packaging: platform test fixes.