Skip to main content

Quick Start

This is the intended standalone first-run flow.

1. Clone and install

git clone https://github.com/joshl26/agentterminal
cd agentterminal
npm install

2. Start the desktop app

npm run tauri dev

3. Open the Composer tab

Type a goal in the Composer input. The pre-send guard runs automatically before dispatch.

4. Check the Runs tab

If Agent Harness is configured, your task appears in the Runs tab with live status.

5. Browse session history

The History tab shows all past sessions and turns, stored locally in SQLite.

6. Configure Brain and Harness (optional)

Set the environment variables for Brain and Harness endpoints:

BRAIN_API_URL=http://localhost:3001
HARNESS_CONTROLLER_URL=http://localhost:5001
HARNESS_TOKEN=<your-token>

No services required for first run

The terminal works without Brain or Harness on first run. You will see the Composer, History, Context, Transcripts, and Runs tabs — services add enrichment and delegation on top.