Install and connect
Before installing
macOS
Before installing Daktyl Connect, put these on PATH:
Node 18+ (a current LTS release is recommended)
brew install node
tmux
brew install tmux
at least one agent CLI on PATH: claude codex agy cursor-agent opencode
Choose your agent; for example, one of:
npm install -g @openai/codex
npm install -g opencode-ai
npm install -g @anthropic-ai/claude-code
On macOS, if Homebrew is absent, first run:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Then run the shellenv command Homebrew prints, in this terminal.
Claude Code is optional. If present, the installer registers its channel plugin.
If absent, plugin registration is skipped; the other agent seats still work.
Sign in to the agent you choose before starting it. Prerequisites are never installed automatically.
Linux or WSL
Before installing Daktyl Connect, put these on PATH:
Node 18+ (a current LTS release is recommended)
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
. "$HOME/.nvm/nvm.sh" && nvm install --lts
tmux
Debian/Ubuntu: sudo apt-get update && sudo apt-get install -y tmux
Fedora: sudo dnf install -y tmux
Arch: sudo pacman -S tmux
at least one agent CLI on PATH: claude codex agy cursor-agent opencode
Choose your agent; for example, one of:
npm install -g @openai/codex
npm install -g opencode-ai
npm install -g @anthropic-ai/claude-code
Claude Code is optional. If present, the installer registers its channel plugin.
If absent, plugin registration is skipped; the other agent seats still work.
Sign in to the agent you choose before starting it. Prerequisites are never installed automatically.
Install
curl -fsSL https://app.daktylconnect.com/install.sh | sh
This installs the daktyl CLI and registers the channel plugin when Claude Code is present.
Nothing needs root and nothing is added to a system path you do not own.
The installer checks prerequisites before changing anything. At the end, copy its
In this terminal command to update your current terminal's PATH: the
curl | sh child cannot change its parent shell. The command uses your actual install path.
Future terminals read the PATH line it adds to your shell startup file.
Connect the machine
daktyl connect
connect is the one verb: it signs you in, registers this computer, and starts its
daemon — skipping whatever is already done. If you are not signed in it prints a QR code to scan
with the app, which pairs the machine to your account. Run it again any time; it is idempotent.
daktyl account login --manual prints a URL
you can open anywhere and paste the token back.Check it
daktyl status # hub health, who you are signed in as, registered machines
daktyl doctor # read-only health check of this machine
daktyl fleet # every agent and seat across the fleet
Register a project
A project is a directory an agent may be launched into. Register the one you are standing in:
daktyl project add # registers $PWD
daktyl project ls
Start an agent
daktyl create # guided: name, harness, model, permissions, project
daktyl create --harness codex --project my-repo # every question a flag answers is not asked
A fully flagged invocation is scriptable and needs no terminal. From then on the agent is on your phone: chat, calls, status, approvals.
Keep it current
daktyl update # self-update the CLI + plugin from the hub (sha256-verified)
daktyl update --check # report what is available, change nothing
Windows
Daktyl Connect runs under WSL. In PowerShell: wsl --install, restart, open your WSL
terminal, then run the two commands above. Native Windows support comes later.
Remove it
daktyl uninstall