Getting Started

Get ADHDev up and running in under 5 minutes.

Cloud Version (adhf.dev)

The cloud version gives you remote access from anywhere — phone, tablet, or another PC.

1. Create an Account

Go to adhf.dev and sign in with GitHub or Google.

2. Install the Daemon

The daemon runs on your dev machine and connects your IDEs to the cloud dashboard.

macOS / Linux

curl -fsSL https://adhf.dev/install | bash

Windows PowerShell

irm https://adhf.dev/install.ps1 | iex

npm (all platforms)

npm install -g adhdev

3. Set Up Authentication

adhdev setup

This opens a browser window for device authentication. Follow the prompts to link your machine to your account.

4. Start the Daemon

adhdev daemon

The daemon will:

• Detect running IDEs automatically
• Connect to the ADHDev server
• Establish P2P connections for fast data transfer
• Start monitoring AI agent activity

5. Open the Dashboard

Go to adhf.dev — your connected IDEs should appear within seconds.

TIP

If your IDE doesn't appear, try launching it with CDP enabled:

adhdev launch cursor

---

Self-hosted Version (OSS)

Run everything locally — no cloud account needed.

Quick Start

npx @adhdev/daemon-standalone

That's it! Open http://localhost:3847 and your IDEs will appear automatically.

Options

# Custom port
npx @adhdev/daemon-standalone --port 8080

# LAN access (access from other devices on same network)
npx @adhdev/daemon-standalone --host

# Token authentication
npx @adhdev/daemon-standalone --token mysecret

# Don't open browser automatically
npx @adhdev/daemon-standalone --no-open

---

Launching IDEs with CDP

ADHDev connects to your IDE via Chrome DevTools Protocol (CDP). Most IDEs need to be launched with a specific CDP port.

# Launch (or relaunch) with CDP enabled
adhdev launch cursor          # Cursor on port 9333
adhdev launch antigravity     # Antigravity on port 9335
adhdev launch windsurf        # Windsurf on port 9336

# With a specific workspace
adhdev launch cursor -w ~/my-project

# New window
adhdev launch cursor -n

WARNING

adhdev launch will close and reopen the IDE to enable CDP. Save your work first!

Adding CLI Agents

CLI agents like Gemini CLI, Claude Code, and Codex CLI can be managed directly from the dashboard.

# Launch Gemini CLI session
adhdev launch gemini

# Launch Claude Code session
adhdev launch claude

# Launch Codex CLI session
adhdev launch codex

Once launched, you'll see an interactive terminal view in the dashboard where you can type commands and see output in real-time.

Next Steps

• Learn the Dashboard →
• Set up Remote View →
• Manage CLI Agents →
• Troubleshooting →