Nightwatch

The AI on-call partner. Detects production incidents, traces root cause, proposes a fix (with your approval), and writes the postmortem.

Companion repo for the Building Nightwatch series.

Quickstart

uv sync
uv run nightwatch simulate

You'll see a simulated incident flow through the four-agent graph:

watcher → analyzer → fixer → postmortem

No AWS or LLM credentials are needed for the simulator — Article 1 ships deterministic stubs so you can see the architecture working end-to-end before any real integrations land.

Project layout

src/nightwatch/
├── agents/           # watcher, analyzer, fixer, postmortem
├── orchestrator.py   # LangGraph wiring
├── state.py          # IncidentState (the single source of truth)
├── settings.py       # env-driven runtime config
└── cli.py            # `nightwatch` entrypoint

Series roadmap

1. Architecture & scaffolding ← you are here
2. The Watcher Agent — real CloudWatch polling
3. The Analyzer Agent — LLM-powered root cause analysis
4. The Fixer Agent — human-in-the-loop remediation
5. The Postmortem Writer — Notion-published reports
6. The Orchestrator — supervisor pattern, conditional edges, checkpointing
7. PagerDuty integration
8. The Next.js dashboard (../nightwatch-fe)
9. Production hardening