Agent Commander Setup Guide

3-Step Setup Summary: (1) Run the one-line agentcmd installer on macOS, Windows 11, Linux, or WSL to start the background service and print a QR code; (2) Download Agent Commander on iOS or Android and scan the QR code to pin your SHA-256 TLS certificate (works over local LAN and remote Tailscale); (3) Pick a project folder and any one of the 3 supported agents (Claude Code, Codex, or Antigravity) to send your first task.

1

Install Agent Commander on your computer

Perform this on the computer you want to use to run Agents.

Which operating system does your computer use?

Terminal · macOS
curl -fsSL https://github.com/phidinhtho/agentcmd/releases/latest/download/install.sh | bash
Open Terminal Press Command + Space, type “Terminal”, and open the application.
Paste command and press Enter Copy the command above, paste into Terminal, and wait for the installer to finish. No sudo is needed.
Wait for the QR code to appear. If you see an ACTION NEEDED section, follow the instructions shown before pairing.
PowerShell · Windows
irm https://github.com/phidinhtho/agentcmd/releases/latest/download/install.ps1 | iex
Open PowerShell Open Start, type “PowerShell”. Paste the command above and press Enter.
Follow installer prompts If prompted to grant permissions or network access, follow the instructions shown.
Wait for the QR code to appear. If you see an ACTION NEEDED section, follow the instructions shown before pairing.
Terminal · Linux
curl -fsSL https://github.com/phidinhtho/agentcmd/releases/latest/download/install.sh | bash
Open Terminal Paste the command above and press Enter to begin installation.
Keep Agent running after logout If the installer prompts you to run enable-linger, run the exact command shown.
Wait for the QR code to appear. If you see an ACTION NEEDED section, follow the instructions shown before pairing.
Terminal · WSL
curl -fsSL https://github.com/phidinhtho/agentcmd/releases/latest/download/install.sh | bash
Open Terminal in WSL Run the command inside your WSL Linux shell, not in PowerShell.
Enable systemd if not present WSL requires systemd to run background services. If reported missing, follow the instructions shown and rerun.
Wait for the QR code to appear. If you see an ACTION NEEDED section, follow the instructions shown before pairing.
2

Install the mobile app and pair

Your phone is where you assign tasks, track results, and answer your Agent.

Download Agent Commander

Open the app store on your phone.

For first-time pairing, connect both devices to the same local network or use Tailscale below.

Open app → Connect → scan QR

Scan the code displayed on your computer to pair.

Code expired? Run agentcmd auth show on your computer to get a new code.

Take your work with you with Tailscale

Set up once to use Agent Commander outside your home network.

Download Tailscale
1 Install on both devices

Install Tailscale on computer and phone. Sign in with the same account to put both on the same Tailscale network.

2 Connect and pair

Turn on Tailscale on both devices. On your computer, run agentcmd auth show to get a new QR code and scan it in the app.

3 Test before heading out

Turn off phone Wi-Fi, turn on cellular data and Tailscale. Open Agent Commander, confirm you can still reach your computer.

Keep your computer powered on, awake, online, and running Agent Commander with Tailscale. View connection guide
3

Create a project and assign your first task

Choose a working directory on your computer, then describe what you want the Agent to do.

  1. 1
    Open project creation form From Home, tap New conversation. In the PROJECT section, tap + New project.
  2. 2
    Fill in details and tap Save Enter Project name, select the Working folder on your computer. Choose Default model: Agent, model, and effort level (if any).
  3. 3
    Send your first request The app returns to the conversation with your newly created project. Type your request into Message the agent…, then tap Send.
ILLUSTRATION · FIRST TASK
My website Project directory on computer
Read the project and explain the directory structure to me. Do not change source code yet.

Start with a clear, easy-to-verify request.

Before creating a project: install and sign in to any one of the three on your computer: Claude Code CLI, Codex CLI, or Antigravity. You can install your chosen agent after Agent Commander; then run agentcmd service restart to detect the CLI.

Need help with any step?

Send your app version and an error description. Do not send pairing codes or conversation content.

Contact support