Skip to content

development.md

Latest commit

 

History

History
94 lines (66 loc) · 1.85 KB

development.md

File metadata and controls

94 lines (66 loc) · 1.85 KB

Development Guide

Building and running Atlas for development.

Build

docker compose build

Start

docker compose up -d

The Web-UI is available at http://localhost:8080.

OAuth Login (One-Time)

docker run -it --rm -v $(pwd)/volume:/home/agent atlas claude login

This stores credentials in volume/.claude/ for persistence across restarts.

View Logs

# All logs
docker compose logs -f

# Specific services
docker compose logs -f atlas

# Inside container
docker compose exec atlas tail -f /atlas/logs/init.log
docker compose exec atlas tail -f /atlas/logs/trigger-<name>.log

Service Status

docker compose exec atlas supervisorctl status

Services managed by supervisord:

  • nginx — Reverse proxy (port 8080)
  • web-ui — Dashboard (port 3000)
  • supercronic — Cron runner

Rebuild After Code Changes

docker compose build && docker compose up -d

Access Container Shell

docker compose exec atlas bash

Database Access

docker compose exec atlas sqlite3 /home/agent/.index/atlas.db

Test Webhook Locally

curl -X POST http://localhost:8080/api/webhook/test-trigger \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello from curl"}'

Environment Variables

Variable Purpose
ATLAS_TRIGGER Set to trigger name when running as trigger session
ATLAS_TRIGGER_CHANNEL Channel for trigger context (internal, signal, email, web)
ATLAS_TRIGGER_SESSION_KEY Session key for persistent triggers
CLAUDE_SESSION_ID Current session ID (set by Claude Code)

File Locations in Container

Path Purpose
/atlas/app/ Core code (read-only)
/home/agent/ Persistent data
/atlas/logs/ Log files
/home/agent/.claude/ Claude Code config