ai-night-shift

# 🌙 AI Night Shift

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

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![繁體中文](https://img.shields.io/badge/lang-繁體中文-orange)](README.zh-TW.md)
[![简体中文](https://img.shields.io/badge/lang-简体中文-red)](README.zh-CN.md)
[![한국어](https://img.shields.io/badge/lang-한국어-green)](README.ko.md)

**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                  │
│                                              │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │  Gemini   │  │  Gemini  │  │Heartbeat │  │
│  │  Code     │  │  CLI     │  │  Agent   │  │
│  │          │  │          │  │          │  │
│  │ night_   │  │ patrol.  │  │ heartbeat│  │
│  │ shift.sh │  │ sh       │  │ _config  │  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  │
│       │              │              │        │
│       └──────┬───────┴──────┬───────┘        │
│              │              │                │
│       ┌──────▼──────┐ ┌────▼─────┐          │
│       │ night_chat  │ │ bot_inbox│          │
│