Quick Start

This guide walks you from zero to a running agent session. Assumes you’ve completed Installation.

1. Start the Control Plane

If you’re running locally:

edgeplane-tower --serve --bind 127.0.0.1:8008

If you have a deployed instance, set EP_BASE_URL to point to it.

export EP_BASE_URL="http://localhost:8008"   # or your deployed URL

Verify connectivity:

edgeplane health --json

Exchange your credentials for a revocable session token that’s never written to agent config files:

edgeplane auth login          # creates ~/.edgeplane/session.json
edgeplane auth whoami         # confirm identity

After this, EP_TOKEN is no longer needed in the environment — edgeplane picks up the session automatically.

edgeplane run claude          # Claude Code
edgeplane run codex           # OpenAI Codex CLI
edgeplane run gemini          # Google Gemini CLI

edgeplane run validates your environment, fetches the onboarding manifest, and launches the agent with EdgePlane wired in as an MCP server.

Inside the running agent, or via the CLI:

edgeplane status

Or open the TUI for a full fleet view:

edgeplane tui

The TUI gives you real-time agent status, domain/mission/task drill-down, a live event feed, and a pending approvals queue.