Use the Forge CLI

The @forge/cli tool brings Forge to your terminal — create runs and watch agents work live, deploy teams, and manage memory without opening the dashboard. It's ideal for local development and scripting.

Step 1: Install

npm install -g @forge/cli

Step 2: Authenticate

Run forge auth login and paste an API key from Settings → API Keys(or a consumer-app key from the Developer Portal). The key is stored in ~/.forge/config.json. In CI, set the FORGE_API_KEY environment variable instead.

forge auth login
forge auth whoami   # confirm you're signed in

Step 3: Create a run and watch it live

forge run create streams agent events into your terminal by default — each agent starts, thinks, and completes in real time, ending with a summary of outputs, duration, and cost.

forge run create \
  --team <team-id> \
  --title "Q3 Security Audit" \
  --brief "Review our Node.js API for OWASP Top 10 vulnerabilities"

# Don't wait — just print the run ID and exit
forge run create --team <id> --title "..." --brief "..." --no-follow

Step 4: Browse runs, teams, and memory

forge run list                 # recent runs
forge run logs <run-id>        # re-attach to a live run
forge run outputs <run-id>     # list artifacts

forge teams list               # public templates
forge teams deploy ./team.json # deploy a team from a manifest

forge memory set company_name "Acme Corp" --namespace global
forge memory list