Prerequisites: Go 1.24+, Node.js 20+ (web UI), Docker (optional).
Quickstart
```bash
# Configure your LLM provider (examples)
export OPENAI_API_KEY="sk-..."
# export ANTHROPIC_API_KEY="sk-ant-..." # Claude
# export CLAUDE_CODE_OAUTH_TOKEN="..." # Claude Code OAuth
# export CODEX_API_KEY="sk-..." # OpenAI Responses / Codex
# export ANTIGRAVITY_API_KEY="..." # Antigravity (OpenAI-compatible)
cp examples/config/runtime-config.yaml ~/.alex/config.yaml
# Run backend + web together
./dev.sh
# Optional: build and run the CLI/TUI
make build
./alex
./alex "print the repo layout"
```
Configuration is shared across every surface. Use examples/config/runtime-config.yaml and docs/reference/CONFIG.md for the canonical schema.
Helpful dev.sh commands
```bash
# Check status/logs
./dev.sh status
./dev.sh logs server
./dev.sh logs web
# Stop services
./dev.sh down
```
---