Configuration

Environment Variables

All config lives in .env.local at the project root. Both values are auto-generated on first launch:

ACCESS_KEY=<your-access-key>        # Auth key for the dashboard
CREDENTIAL_SECRET=<auto-generated>  # AES-256 encryption key for stored credentials

To reset your access key, delete the ACCESS_KEY line from .env.local and restart. A new key will be generated.

Data Directory

All persistent data is stored in data/ as JSON files:

FileContents
sessions.jsonChat sessions and message history
agents.jsonAgent configurations
credentials.jsonEncrypted API keys
tasks.jsonTask board items
schedules.jsonCron schedules
secrets.jsonOrchestrator service keys
settings.jsonApp settings (user name, preferences)
providers.jsonCustom provider configs
skills.jsonUploaded skills
connectors.jsonChat platform connector configs

Backup

Back up the entire data/ directory to preserve your configuration. The .env.local file contains your encryption key — without it, encrypted credentials cannot be decrypted.

Settings UI

Open Settings from the gear icon in the sidebar header:

  • User Preferences — Global instructions injected into all agent system prompts
  • Orchestrator Engine — Choose the LangGraph provider, model, and credentials for orchestration routing

Ports

The dev server defaults to port 3456. To change it, edit the dev script in package.json:

"dev": "next dev --hostname 0.0.0.0 -p 4000"