phantom-template

# 🕵️ Project Phantom

**A multi-agent AI system template powered by Gemini CLI.**

Automate your daily operations with 10 specialized AI agents that collaborate, plan, and execute tasks — from GitHub project management to Gmail classification.

## ✨ Features

- **10 specialized sub-agents** — each with a distinct role (strategist, executor, debugger, etc.)
- **Gemini CLI native** — runs directly in your terminal, no extra infrastructure needed
- **GitHub Project v2 integration** — automated task sync with Google Tasks
- **Gmail auto-classification** — sorts emails into actionable categories using Gemini AI
- **PDCA self-improvement** — agents log failures and learn from past mistakes
- **Hook system** — pre/post tool execution guards (secret detection, git safety, etc.)

## 🚀 Quick Start

### Prerequisites

**Supported OS:** Linux, macOS, Windows (WSL2 / Ubuntu recommended)

| Tool | Version | Purpose |
|------|---------|---------|
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | latest | Core runtime |
| [Node.js](https://nodejs.org/) | v18+ | Gemini CLI dependency |
| [Python](https://python.org/) | 3.10+ | Scripts & hooks |
| [GitHub CLI](https://cli.github.com/) | latest | GitHub integration |
| [Git](https://git-scm.com/) | latest | Version control |

> **Windows users:** Tested on WSL2 (Ubuntu). Native PowerShell is not supported. See [Windows automated setup](#windows-automated-setup) below.

**Required services:**
- Google Workspace (Gmail, Google Drive, Google Tasks)
- GitHub account with Project v2
- Claude API key ([Get one here](https://aistudio.google.com/apikey))

### Installation

#### Windows (automated setup)

Right-click `setup/setup-windows.bat` → **Run as administrator**. The script will automatically install WSL, Ubuntu, Node.js, Gemini CLI, and GitHub CLI — then walk you through the rest.

> **⚠️ Security software notice:** Some antivirus software (Norton, Windows Defender SmartScreen, etc.) may block `.bat` files from running. I