Operations

Starting the terminal

npm run tauri dev        # development mode
npm run tauri build      # production build

Checking service connectivity

The terminal shows connection status for Brain and Harness in the header. A red indicator means the service is unreachable — the terminal continues to work without it.

Managing session history

Session history is stored locally at ~/.agent-terminal/history.db (SQLite).

To clear history, delete the database file and restart the terminal. A new empty database is created on next launch.

Reviewing transcripts

Voice transcripts from Agent Wispr appear in the Transcripts tab. Each transcript shows:

• raw text from Wispr
• classified intent
• send/discard action

Transcripts are not automatically sent — you review and approve each one.

Recovering from guard blocks

If the pre-send guard blocks a message:

1. Review the guard reason shown in the Composer tab
2. Adjust the message or context
3. Retry

Guard blocks are not errors — they are expected behavior for out-of-scope or malformed requests.