Install and connect

One command installs it; one more puts the machine on your phone.

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.

Headless box with no browser? 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