Installation
Aegis is currently optimized for local development and private workstation use.
Requirements
- Node.js 26.x
- npm 11.x matching the project runtime
- Git
- macOS or Linux
- local storage for the Aegis data directory
Install
npm ci
npm run build
npm test
Start The Dashboard
npm run launch:dashboard
The launcher builds the TypeScript project, starts the local API and worker, waits for /health, and opens the dashboard.
Local Service
For a macOS launchd service, see Local macOS service.
Configuration
Choose a stable data directory for Aegis state, run workspaces, artifacts, and secret metadata:
export AGENT_HARNESS_DATA_DIR="$HOME/.aegis"
Common environment variables:
AGENT_HARNESS_HOSTAGENT_HARNESS_PORTAGENT_HARNESS_DATA_DIRAGENT_HARNESS_WORKFLOW_DIRAGENT_HARNESS_SKILL_DIRAGENT_HARNESS_TOKENAGENT_HARNESS_WORKER_MODEAGENT_HARNESS_AGENT_TOKEN
Binding beyond localhost requires token authentication.
Use AGENT_HARNESS_AGENT_TOKEN only when a headless agent client needs scoped read or steering access.
After Aegis is installed and running, continue with Prepare a project for Aegis and Add model providers.