CLI Commands

Complete reference for the adhdev command-line tool.

Global Commands

adhdev

Show help and available commands.

adhdev setup

Interactive setup wizard. Authenticates your machine with ADHDev Cloud.

adhdev setup
# Opens browser for device authentication
# Stores token in ~/.adhdev/config.json

adhdev daemon

Start the daemon process. Connects to your IDE(s) and the ADHDev server.

adhdev daemon
# Runs in foreground, press Ctrl+C to stop

adhdev status

Show current daemon status, connected IDEs, and system info.

adhdev status

Launch Commands

adhdev launch [target]

Launch or relaunch an IDE or CLI agent with CDP enabled.

# IDEs
adhdev launch cursor          # Launch Cursor (CDP port 9333)
adhdev launch antigravity     # Launch Antigravity (CDP port 9335)
adhdev launch windsurf        # Launch Windsurf (CDP port 9336)
adhdev launch vscode          # Launch VS Code
adhdev launch kiro            # Launch Kiro

# CLI Agents
adhdev launch gemini          # Launch Gemini CLI session
adhdev launch claude          # Launch Claude Code session
adhdev launch codex           # Launch Codex CLI session

Options:

Flag	Description
-w, --workspace <path>	Open specific workspace/folder
-n, --new-window	Open in a new window

WARNING

adhdev launch for IDEs will close the existing IDE process and reopen it with CDP enabled. Save your work first.

Provider Commands

adhdev provider list

List all loaded providers with their status.

adhdev provider reload

Hot-reload providers from disk without restarting the daemon.

Version & Upgrade

adhdev --version

Show current ADHDev version.

adhdev daemon:upgrade

Upgrade the daemon to the latest version.

adhdev daemon:upgrade
# Downloads and installs latest version