Common tasks

export ENGINE_URL=http://localhost:8000
export ENGINE_KEY=dev-engine-key

docker compose up engine

docker compose up -d engine

docker compose down

docker compose down --volumes

docker compose build engine && docker compose up engine

docker compose logs -f engine

docker compose exec engine sqlite3 /data/brain.sqlite '.tables'

docker compose exec engine sqlite3 /data/brain.sqlite \
  'SELECT COUNT(*) FROM episodes'

docker compose exec engine sqlite3 -header -column /data/brain.sqlite \
  'SELECT id, key, description, created_at FROM episodes
   ORDER BY created_at DESC LIMIT 10'

docker compose exec engine sqlite3 -header -column /data/brain.sqlite \
  'SELECT id, thread_id, task_id, created_at FROM trajectories
   ORDER BY created_at DESC LIMIT 5'

docker compose exec engine sqlite3 /data/brain.sqlite \
  'DELETE FROM episodes; DELETE FROM knowledge_store;
   DELETE FROM social_graph_nodes; DELETE FROM working_memory_log;
   DELETE FROM trajectories;'

$EDITOR .env
docker compose up -d engine  # picks up the new .env

ENGINE_LOG_LEVEL=DEBUG docker compose up -d engine

curl -X POST "$ENGINE_URL/admin/reload-catalog" \
  -H "X-Engine-Key: $ENGINE_KEY"

curl -X POST "$ENGINE_URL/admin/reload-core-soul" \
  -H "X-Engine-Key: $ENGINE_KEY"

curl -fsS "$ENGINE_URL/health" | jq

curl -N -X POST "$ENGINE_URL/execute" \
  -H "X-Engine-Key: $ENGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Say hi.","task_id":"smoke-1"}'

curl -fsS "$ENGINE_URL/assets/servers" \
  -H "X-Engine-Key: $ENGINE_KEY" | jq

curl -fsS -X POST "$ENGINE_URL/memory/knowledge/search" \
  -H "X-Engine-Key: $ENGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"prefer","limit":5}' | jq

curl -X POST "$ENGINE_URL/admin/lc/trigger" \
  -H "X-Engine-Key: $ENGINE_KEY"

docker compose run --rm test pytest tests/ --tb=short

docker compose run --rm test pytest tests/test_agent_loop.py --tb=short

docker compose run --rm test pytest -k test_compaction_handles_overflow

docker compose run --rm test pytest tests/ -vv

LLM_PROVIDER=openai
LLM_API_KEY=sk-...
LLM_MODEL=gpt-5.4
OPENAI_API_KEY=sk-...

LLM_MODEL=claude-haiku-4-5-20251001

REACTIVE_COMPACT_ENABLED=false

docker compose logs -f engine | grep task-001

ENGINE_LOG_LEVEL=DEBUG docker compose up engine

curl -N -X POST "$ENGINE_URL/execute" \
  -H "X-Engine-Key: $ENGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"hi","task_id":"demo"}' \
  | grep -E '^(event|data):' \
  | sed 's/^data: //'