Installation

Install Docktree via our installer script or Homebrew.

Installer Script (macOS / Linux)

The recommended way to install Docktree is via our installer script:

Option A: Run in a subshell (recommended)

curl -fsSL https://docktree.dev/install.sh | sh

Option B: Evaluate in current shell (modifies PATH immediately)

eval "$(curl -fsSL https://docktree.dev/install.sh)"

Homebrew (macOS / Linux)

Alternatively, you can tap and install via Homebrew. Note that Homebrew 4.4+ requires trusting unsigned custom taps:

brew tap Bnjoroge1/tap
brew trust Bnjoroge1/tap
brew install docktree

Verify the installation

docktree --version

AI Agent Skills

If you use AI coding agents (such as Claude Code, Codex, Cursor, OpenCode, or OMP/Pi), you can install Docktree skills to teach them how to drive the Docktree CLI (e.g. using the --json flag, handling errors, and managing worktree lifetimes):

npx skills add Bnjoroge1/Docktree

Note: Under the hood, these are standard Docker containers at the end of the day. Because Docktree delegates directly to the standard Docker engine, all existing tools, agent diagnostics, and container inspect tasks your agents are already familiar with will work seamlessly.

To install globally for a specific agent (e.g. Claude Code):

npx skills add Bnjoroge1/Docktree -g -a claude-code

Prerequisites

Docker with the Compose plugin (docker compose must be available) running on a daemon such as Docker Desktop, OrbStack, or Colima
Git (worktree support is built-in)
A project using Docker Compose with a docker-compose.yml or compose.yml

Next steps

Read the quick start guide to spin up your first worktree stack.