🌙 AI Night Shift

A multi-agent autonomous framework that lets your AI assistants work while you sleep.

AI Night Shift is an open-source framework for running multiple AI agents (Claude Code, Gemini, and more) in coordinated autonomous sessions during off-hours. Born from 30+ real production night shifts, this isn't theoretical — it's battle-tested.

What Makes This Different

Most "autonomous agent" tools run a single agent in isolation. AI Night Shift orchestrates multiple heterogeneous AI agents working together:

| Agent | Engine | Role | Mode | |-------|--------|------|------| | Developer | Claude Code | Coding, debugging, deploying | Continuous (hours) | | Researcher | Gemini CLI | Research, data gathering, triage | Periodic (minutes) | | Coordinator | Any LLM | Task routing, monitoring | Heartbeat (30min) |

They communicate through shared protocols — a file-based message queue, shared chat log, and task board integration.

Architecture

┌─────────────────────────────────────────────┐
│              AI Night Shift                  │
│                                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │  Claude   │  │  Gemini  │  │Heartbeat │  │
│  │  Code     │  │  CLI     │  │  Agent   │  │
│  │          │  │          │  │          │  │
│  │ night_   │  │ patrol.  │  │ heartbeat│  │
│  │ shift.sh │  │ sh       │  │ _config  │  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  │
│       │              │              │        │
│       └──────┬───────┴──────┬───────┘        │
│              │              │                │
│       ┌──────▼──────┐ ┌────▼─────┐          │
│       │ night_chat  │ │ bot_inbox│          │
│       │    .md      │ │  (JSON)  │          │
│       └─────────────┘ └──────────┘          │
│                                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │ Plugins  │  │Dashboard │  │Templates │  │
│  └──────────┘  └──────────┘  └──────────┘  │
└─────────────────────────────────────────────┘

Quick Start

1. Install

git clone https://github.com/judyailab/ai-night-shift.git
cd ai-night-shift
bash install.sh

2. Configure

# Copy the example config and edit your settings
cp config.env.example config.env
nano config.env

# Customize the night shift prompt
nano claude-code/prompt_template.txt

3. Test

# Run a single round to verify setup
bash claude-code/night_shift.sh --max-rounds 1

4. Schedule

# The installer adds cron jobs automatically, or set up manually:
crontab -e
# Add: 0 1 * * * cd ~/ai-night-shift && bash claude-code/wrapper.sh

Modules

| Module | Description | Docs ...