Overnight SWE

Documentation

Run autonomous AI dev teams overnight. Wake up to progress.

Quick Start

# Clone and setup
git clone https://github.com/DecOperations/overnight-swe.git
cd overnight-swe
./install.sh
# Go to your project and run
cd ~/your-project
overnight
# After approving specs
overnight --start

How It Works

1

Approve Specs

Review and update specs/SPEC.md with your product requirements. Set the current priority in plans/NEXT-PRIORITY.md.

2

Run Overnight

Execute ./overnight and go to sleep. The multi-agent team (PM, SWE, QA) will work autonomously for 8 hours.

3

Morning Review

Wake up to commits, test results, and a summary. Review with git log and plans/OVERNIGHT-SUMMARY.md.

4

Iterate

Update specs based on progress, set new priorities, and run again. The system learns and improves over time.

The Agent Team

📋

PM Agent

Product Manager

  • -Reviews specs and sets priorities
  • -Manages the roadmap
  • -Quality review of commits
  • -Updates documentation
💻

SWE Agent

Software Engineer

  • -Implements features from specs
  • -Writes clean, tested code
  • -Makes atomic commits
  • -Follows coding standards
🧪

QA Agent

Quality Assurance

  • -Writes and maintains tests
  • -Improves test coverage
  • -Finds and reports bugs
  • -Prevents regressions

Commands

overnightInteractive spec generation (run from your project)
overnight --startStart overnight run after specs approved
pnpm devStart development server
pnpm testRun unit tests
pnpm test:e2eRun Playwright E2E tests
pnpm qaFull QA pipeline (unit + E2E + visual + AI exploration)
pnpm qa:visualScreenshot + Claude Vision UI/UX analysis
pnpm qa:exploreAI-powered site exploration with Stagehand

Milestones

M1

8-Hour Solo Run

Complete

Single Claude Code agent works through the roadmap

M2

8-Hour Team Run

Complete

PM + SWE + QA agents coordinate with self-evaluation

M3

24-Hour Unsupervised

In Progress

Resilient operation with stuck detection and recovery

M4

World-Class Output

Planned

Output quality matches senior engineers

Morning Review Checklist

  • 1.git log --oneline -20 - See what was done
  • 2.cat .overnight/summary.md - Read the summary
  • 3.cat .overnight/qa/qa-report.md - Check QA results
  • 4.pnpm test - Verify tests pass
  • 5.git push - If satisfied, push to remote