Quickstart

Install the FORG agent, activate your license, and see your first signal in the dashboard — in under 5 minutes.

1. Install

Run the official installer script, which detects your platform and installs the correct forg binary to /usr/local/bin:

curl -fsSL https://forg.pro/install | sh

2. Activate

Copy your license key from forg.pro/dashboard → Settings → License. License tokens use the format lic_<20hex>.

forg activate lic_a3f9e2c1b84d7f6e0a2c

# device fingerprint: a3f9e2c1b84d...
# Device name [mymac]:
#   ✓ Claude Code
#   ✓ Cursor
#
# FORG OS activated. 2 tool adapter(s) installed.
# forg: session started (a3f9e2c1)

Activation contacts forg.pro/agent/v1/activate, verifies the license, writes the identity bundle to your OS keychain, auto-detects installed AI tools, and immediately starts a monitoring session.

3. Start a session

forg activate starts a session automatically. For subsequent sessions, use forg on:

forg on
# forg: session started (a3f9e2c1)

# Optionally declare a goal:
forg on --goal "Build the auth flow"
# forg: session started (a3f9e2c1)
# forg: goal → Build the auth flow

See the Adapters guide for per-adapter setup details.

4. Verify

Run forg status to confirm your license is active and a session is running:

forg status

# user_id:        usr_a3f9e2c1b84d7f6e0a2c
# device:         a3f9e2c1b84d...
# engine:         https://engine.forg.pro
# license worker: https://api.forg.pro
#
# session:        a3f9e2c1 (active)
# goal:           Build the auth flow
#
# Installed adapters:
#   ✓ Claude Code (free)
#   ✓ Cursor (free)

5. Use your AI tool normally

Open Claude Code (or whichever adapter is installed) and start coding. FORG runs entirely in the background — you don't need to change your workflow.

When you're done, end the session and request a summary:

forg done

6. View your data

Navigate to forg.pro/dashboard to see your sessions and signals in real time. Signals typically appear within 2–3 seconds of the tool call completing.

The dashboard shows:

• Token and cost usage over time, with per-model breakdown
• Active sessions and full session history
• Rule triggers and anomaly alerts
• Per-adapter and per-project attribution

Troubleshooting