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; local session and guard workflows continue, while dependent memory or execution actions report the missing service.
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:
- Review the guard reason shown in the Composer tab
- Adjust the message or context
- Retry
Guard blocks are not errors — they are expected behavior for out-of-scope or malformed requests.
◆Local session state
Session history, context items, and transcripts are stored locally. If Brain, Harness, or account services are configured, those integrations can also process the requests you explicitly send to them.