Configuration

Escher desktop app settings, environment configuration, and integration preferences.

---

Desktop app settings

Settings are accessible from the Escher desktop app via the gear icon (⚙) in the top-right corner, or at Settings → Configuration.

General

Setting	Description	Default
Theme	Light / Dark / System	Dark
Language	Interface language	English
Telemetry	Send anonymous usage data to Tessell	Enabled
Auto-update	Check for desktop app updates on launch	Enabled

Estate scan

Setting	Description	Default
Scan on startup	Run estate scan when app launches	Disabled
Scan interval	How often to refresh estate data	Manual
Include tags	Tag keys to include in resource metadata	All
Exclude regions	Regions to skip during scan	None

Notifications

Setting	Description
Slack webhook	URL for outbound Slack notifications
Min severity	Minimum finding severity to trigger a notification
Notify on run complete	Send message when a playbook run finishes

---

Environment variables (backend)

Backend services are configured via environment variables. In production these are injected from AWS Secrets Manager; locally use .env files.

Gateway

# v2-gateway-service-java/.env
ANALYSIS_AGENT_URL=http://localhost:8081
PLAYBOOK_AGENT_URL=http://localhost:8082
CONTEXT_ENGINE_URL=http://localhost:8001
COGNITO_JWKS_URL=https://cognito-idp.us-west-1.amazonaws.com/POOL_ID/.well-known/jwks.json
PORT=8080

Analysis Agent

# v2-analysis-agent-go/.env
CONTEXT_ENGINE_URL=http://localhost:8001
ANTHROPIC_API_KEY=sk-ant-...
PORT=8081

Context Engine

# v4-context-engine/.env
ASSET_STORE_URL=http://localhost:8000
PORT=8001

Asset Store

# v4-asset-store-go/.env
SURREAL_URL=ws://localhost:4000/rpc
SURREAL_USER=root
SURREAL_PASS=root
SURREAL_NS=escher
SURREAL_DB=main
PORT=8000

---

ADK configuration

The ADK reads its target Context Engine URL from the --ce-url flag or from the ESCHER_CE_URL environment variable:

export ESCHER_CE_URL=http://localhost:8001

# All ADK commands use this URL by default
adk validate ./my-agent/
adk register ./my-agent/
adk list agents

---

Next steps

• Installation — Prerequisites and initial setup
• Docker Compose — Full local stack configuration
• ADK Reference — Agent registration configuration