Max (named after Maxwell Smart, Agent 86) is a self-hosted agent management platform that orchestrates Claude Code CLI agents across multiple projects. Built with Flask, it provides a web-based mission control centre for deploying, monitoring, and coordinating AI agents.
"Sorry about that, Chief." — Max, after every minor setback
- Operations Centre — Dashboard showing all registered projects with status, health, and quick actions
- Persistent Multi-Terminal Hub — Multiple xterm.js terminals with tab and mini-panel management. Sessions survive page navigation. Pop-out windows. Fullscreen mode.
- KAOS Mode — launch Claude with --dangerously-skip-permissions (☠️ button)
- Session resume — Claude terminals auto-resume the project's last session- Agent 99 — Persistent Claude CLI assistant accessible from every page (Cmd+9). She knows all your projects, can schedule tasks, run health checks, and create new projects from natural language.
- Consolidated task register across all projects — bugs, features, improvements, tasks
- Syncs with production — pulls from your apps' feedback APIs, pushes status updates back
- Agent assignment — assign tasks to 86 (Sonnet/Opus) or 99
- Scheduling — set date/time for agent work, friendly cron builder with presets
- Multi-select bulk actions — run, deploy, or run & deploy selected items
- Quality gates — review states, rejection loops with feedback
- Session management — store and resume Claude CLI sessions per project
- CLAUDE.md generation — edit Business Problem + Proposed Solution, auto-generate CLAUDE.md
- Intelligent merge — updates CLAUDE.md without overwriting existing content
- Reconnaissance — scan project directories with time grouping, search, undercover system
- Sequential task execution per project — no conflicts, no timeouts
- Git workflow — agents commit to
agent/<task>branches, push for review - Diff viewer — color-coded code review in the browser
- Deploy approval — review diff, approve, merge to main with one click
- Progressive updates — agents report progress every 2 minutes
- Auto-handoff — if a task times out inline, it spawns a background worker
- One bot, multiple channels — each project gets a Discord channel
- Agent 99's Direct Line — dedicated channel for 99
- Project agents respond in character — Max talks like Maxwell Smart
- File attachments — send screenshots and files via Discord
- Background task handoff — complex requests auto-delegate to background workers
- Results delivered back to the channel when complete
- Allowlist — only authorised users can talk to the bots
- Central notification hub — all agent updates, task completions, questions
- Reply inline — responses go to the ticket thread
- Deploy approval from inbox — review diffs and approve without leaving
- Discord push — agent updates post to project channels automatically
- macOS notifications — native alerts for agent activity
- Remote agent deployment — SSH into VPS, spawn research agents
- Remote terminal — execute commands on VPS from the browser
- PostgreSQL sync — bidirectional sync between local SQLite and VPS Postgres
- Agent coordination — remote researches, local executes
- Analytics dashboard — 7-day activity trends, task distribution, model usage, project breakdown
- Audit trail — every agent action logged with timestamp, actor, detail
- Health checks — git status, dependencies, common issues, project size
- Vulnerability scanning — npm audit, pip-audit integration
- Log analysis — error pattern detection in project logs
- Smart polling — SocketIO pauses when browser tab is inactive, resumes on focus
- Agent state machine — offline/idle/busy/sleeping/error with heartbeat tracking
- Regression branches — isolated git branches for testing changes
- Promote to production — merge to main with one click
- Test runner — auto-detect and run pytest, npm test, unittest
- Backup & restore — snapshot the database, restore with safety backup
- CLAUDE.md management — edit project briefs, generate CLAUDE.md, intelligent merge
Three themes with Claude orange (#E8734A) as the accent:
- 🌙 Dark — Night Operations
- ☀️ Light — Daylight Operations
- 🌊 Soft — CONTROL Headquarters (light blues & greys)
- Python 3.10+
- Claude Code CLI installed and authenticated
- Git
git clone https://github.com/yourusername/max.git
cd max
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your settings
python run.pyOpen http://localhost:8086 — CONTROL headquarters is operational.
cp .env.example .env
# Edit .env
docker-compose up -dpython setup_startup.py # Install launchd agent
python setup_startup.py uninstall # Remove it- Create a bot at discord.com/developers
- Enable Message Content Intent under Bot → Privileged Gateway Intents
- Invite the bot to your server
- Configure in Max: Shoe Phone page → enter token + channel IDs
- Or let 99 create channels: she can do it programmatically
Max (Flask + SocketIO)
├── Routes (Blueprints) ← HTTP → Browser UI
├── SocketIO Events ← WebSocket → Real-time updates
├── Services
│ ├── AgentRunner → spawns claude CLI processes
│ ├── Agent99 → persistent Claude assistant
│ ├── TaskExecutor → sequential task queue per project
│ ├── BotManager → Discord/Telegram lifecycle
│ ├── TerminalManager → persistent PTY sessions
│ ├── HealthChecker → project health analysis
│ ├── FeedbackRegister → consolidated task management
│ ├── InboxService → agent notifications
│ ├── AuditService → activity logging
│ └── AnalyticsService → usage tracking
├── DB (SQLite)
└── Discord Worker (subprocess)
All configuration via .env or environment variables:
| Variable | Default | Description |
|---|---|---|
MAX_SECRET_KEY |
agent-86-would-you-believe |
Flask session secret |
MAX_PORT |
8086 |
Server port (Agent 86's number) |
CLAUDE_CLI_PATH |
~/.local/bin/claude |
Path to Claude CLI |
MAX_PROJECT_LOCATIONS |
local:~/Projects |
Project directories (name:path pairs) |
DISCORD_BOT_TOKEN |
— | Discord bot token |
VPS_HOST |
— | VPS IP for remote operations |
Max is packed with Get Smart references:
- Agent 86 (Max) — your project agents, confident and occasionally bumbling
- Agent 99 — the competent persistent assistant who always calls you "Chief"
- The Chief — that's you
- CONTROL — the good guys (your infrastructure)
- KAOS — the bad guys (production errors, vulnerabilities)
- The Shoe Phone — Discord/Telegram bot connectivity
- The Cone of Silence — secure operations (token entry, credentials)
- KAOS Mode —
--dangerously-skip-permissions(☠️ button) - Training Ground — regression environments
- Emergency Protocols — backup & restore
- Mission Dossier — consolidated task register
- Satellite Office — VPS remote operations
- "Would you believe..." — loading messages
- "Sorry about that, Chief" — error messages
- "And loving it!" — success messages
- "Missed it by that much!" — timeouts and near-misses
max/
├── app.py # Flask factory
├── config.py # Configuration
├── run.py # Entry point + Discord worker
├── max/
│ ├── models/ # Data models (Project, Agent, Task, etc.)
│ ├── services/ # Business logic (agent runner, bots, health, etc.)
│ ├── routes/ # Flask blueprints
│ ├── sockets/ # SocketIO event handlers
│ ├── db/migrations/ # SQL migrations
│ └── utils/ # Smart quotes, helpers
├── static/ # CSS themes, JS, images
├── templates/ # Jinja2 templates
├── menubar/ # macOS menu bar app (rumps)
└── scripts/ # Setup scripts, launchd plists
- Fork the repo
- Create a branch (
git checkout -b feature/shoe-phone-upgrade) - Make your changes
- Submit a PR
"Would you believe... we accept pull requests?"
MIT License — see LICENSE for details.
"Would you believe... the world's smartest agent manager?"
Built with Claude Code. And loving it.