DocsInstallationQuickstart
2-Minute Setup

Installation & Setup

Two simple steps to get started: install the Chrome extension and run the one-time local agent command in your terminal.

1

Install the Chrome extension & sign in

Add Trace from the Chrome Web Store and pin it to your browser toolbar. Click the Trace icon in your browser to open the side panel and sign in.

Install from Chrome Web Store
2

Run the connection command on your machine

After signing in, the side panel displays the Connect screen. Copy and paste the setup command into your local terminal to connect the agent:

$
curl -fsSL https://raw.githubusercontent.com/tracedevtools/Forge-release/main/install.sh | bash
Trace Side Panel — Connect Local Agent
Setup ScreenSide Panel

Connect Local Agent

Run this one-time command in your terminal to pair the Chrome extension with your filesystem.

Terminal (macOS / Linux / Windows)
curl -fsSL https://raw.githubusercontent.com/tracedevtools/Forge-release/main/install.sh | bash
Waiting for local agent connection...
Port: 127.0.0.1:9090Auto-detects upon install
The Trace side panel setup screen auto-detects your local agent as soon as the command runs.
Automatic handshake: As soon as the command finishes, the side panel connects automatically and opens the main chat screen.

You're all set! What to explore next

Now that your agent is connected, check out how workspaces, reasoning models, and multi-agent swarms work:

Workspaces & Projects
Greenfield vs. existing folders
Models & Reasoning
Claude, GPT, DeepSeek, and BYOK
Encountered an issue during setup?
Check our Troubleshooting Guide for fixes on port permissions, macOS gatekeeper alerts, and agent resets.