Skip to main content

Configuration

Agent Terminal is configured via environment variables. No config file is required for the default setup.

Core variables

VariablePurposeDefault
BRAIN_API_URLAgent Brain MCP server URLunset (disabled)
HARNESS_CONTROLLER_URLAgent Harness controller URLunset (disabled)
HARNESS_TOKENBearer token for Harness authunset
DATABASE_PATHSQLite history database path~/.agent-terminal/history.db

Pre-send guard

The guard is a pure TypeScript function in src/preSendGuard.ts. It runs synchronously before every outgoing message with no side effects and no async calls.

Guard rules are hardcoded. They block:

  • messages exceeding the configured token budget
  • requests with no resolved Brain context when Brain is configured
  • patterns explicitly flagged in the guard rule set

Wispr integration

To enable voice transcript ingestion from Agent Wispr:

  1. Enable the Terminal integration toggle in Agent Wispr Settings
  2. The Wispr app will POST transcripts to POST /api/wispr/ingest on the terminal backend
  3. Transcripts appear in the Transcripts tab for review before sending

Guard is immutable at runtime

The pre-send guard cannot be disabled or bypassed at runtime. Modify src/preSendGuard.ts in source and rebuild to change guard behavior.