GitHub - gil906/copilot-hive: 🐝 Autonomous AI Agent Swarm — 11 GitHub Copilot agents that research, develop, audit, and deploy improvements to production apps 24/7. Self-healing, version-verified, event-driven pipeline. 780+ ideas/day.

"What if your entire engineering team was AI — and never slept?"

Copilot Hive is an open-source framework for running 13 specialized GitHub Copilot CLI agents as an autonomous development team. They research ideas, implement features, audit code, deploy changes, and fix failures — all without human intervention, 24/7.

Architecture · Agents · Pipeline · Self-Healing · Get Started

🏗️ Architecture

Three layers work together:

Layer	Agents	Purpose
🔬 Research	6 read-only agents	Generate 780+ structured ideas per day
⚡ Pipeline	Developer ↔ Auditor	Implement → Deploy → Verify → Audit → Loop
🛡️ Emergency	Fixer + Kuma + SmartThings	Monitor, self-heal, alert on failures

📸 Copilot Hive UI

This repo's actual interface is the Copilot Hive Project Manager in dashboard.js — a dark-mode control panel for registering projects, checking agent status, launching runs, and reviewing setup logs.

🧭 Fleet Overview

Copilot Hive Project Manager UI — project cards, agent status, and live logs

From one screen you can wire up a repo, choose which agents should work on it, and watch the hive operate in real time.

🚀 Add Project Modal

The setup flow lets you register a local app or clone from GitHub, map health checks and containers, and choose exactly which Hive agents should be enabled for that project.

🔎 Project Detail, Agents, and Logs

Each project gets its own control surface with configuration, per-agent run buttons, competitor discovery, and a live setup log for troubleshooting.

Copilot Hive project detail page with configuration, agents, competitors, and setup log

🐝 The Hive — 13 Agents

🔧 Code-Modifying Agents

These are the only agents that touch the codebase. They chain through the event-driven pipeline.

	Agent	What It Does	Trigger
🔧	Developer	Reads ALL idea files, implements the best ones, pushes to GitHub	Pipeline (continuous)
🔍	Auditor	Security audit, tests, bug fixes, code quality review	Pipeline (after Developer)
🚑	Emergency Fixer	Reads Docker logs + HTTP diagnostics, fixes critical issues	On failure (escalation)

🔬 Research Agents

Read-only — they analyze the codebase and competitors, then write structured idea documents. Never modify code.

	Agent	Focus Area	Output	Schedule
🎨	Website Designer	Public site UX, animations, landing pages, mobile, conversions	10 ideas	⏱️ Every hour
🖥️	Portal Designer	Dashboard, admin panel, charts, data viz, user settings	10 ideas	⏱️ Every hour
⚙️	API Architect	API design, scanners, orchestration, performance, new tools	10 ideas	⏱️ Every hour
🔥	Radical Visionary	Game-changers — competitor analysis, AI innovation, disruption	5 transformative	⏱️ Every 2h
⚖️	Lawyer	Privacy policies, ToS, legal compliance, competitor legal	5 ideas	⏱️ Every 2h
📋	Compliance	SOC2, PCI-DSS, HIPAA, ISO 27001 readiness	5 ideas	⏱️ Every 2h

📊 Support

	Agent	What It Does	Schedule
📧	Reporter	Sends HTML email summaries of all agent activity	Daily + Weekly
🚀	Deployer	GitHub Actions — builds Docker images, deploys via SSH	On git push

💡 Idea Flow

Research agents write structured markdown files to ideas/. The Developer reads all 6 files and picks the highest-impact ideas to implement:

ideas/web_design_latest.md    ─┐
ideas/portal_design_latest.md  │
ideas/api_architect_latest.md  ├──▶  🔧 Developer picks best ideas
ideas/radical_latest.md        │     implements → pushes → deploys
ideas/lawyer_latest.md         │
ideas/compliance_latest.md    ─┘

Per Hour	30 specialist ideas (10 web + 10 portal + 10 api)
Per 2 Hours	+ 15 strategic ideas (5 radical + 5 lawyer + 5 compliance)
Per Day	~780 total ideas feeding the Developer agent

⚡ Event-Driven Pipeline

The Dispatcher (copilot-dispatcher.sh) runs every 60 seconds via cron and orchestrates the continuous Developer ↔ Auditor loop:

State	What's Happening
💤 Idle	Ready to launch next agent in the chain
🔧 Running	Agent is actively working (PID tracked, monitored)
⏳ Deploy	Code pushed — waiting for GitHub Actions + Docker deploy + version verification
🔧 Fixing	Deploy failed — re-running the agent that broke it (2 retries before 🚑 escalation)

What a Cycle Looks Like

07:01  📡 Dispatcher → launches Developer
07:35  🔧 Developer → implements 3 features from idea files
07:36  🔧 Developer → stamps build-id, pushes to GitHub
07:37  🚀 GitHub Actions → builds container, deploys via SSH
07:39  📡 Dispatcher → calls /api/version → confirms NEW container is live ✅
07:39  📡 Dispatcher → launches Auditor
08:05  🔍 Auditor → finds 2 security issues, fixes them
08:06  🔍 Auditor → stamps build-id, pushes to GitHub
08:08  📡 Dispatcher → version verified ✅ → launches Developer
08:08  ♻️  New cycle begins...

🔖 Version Verification

"Did the deploy actually work?" — Copilot Hive doesn't just check if a container is running. It verifies the exact version matches.

1. Agent stamps a unique build ID before committing:

BUILD_ID="$(date +%s)-$(openssl rand -hex 4)"
echo "$BUILD_ID" > .build-id
git add -A && git commit && git push

2. App exposes it via API:

GET /api/version → {"build_id": "1740234567-a1b2c3d4", "status": "running"}

3. Dispatcher verifies after deploy:

RUNNING=$(curl -s localhost:8080/api/version | jq -r '.build_id')
[ "$RUNNING" = "$EXPECTED" ] && echo "✅ New container live" || echo "⏳ Still deploying..."

This prevents the next agent from working against stale code when a deploy fails silently.

🛡️ Smart Failure Coordination

When a deploy breaks, the system follows an intelligent escalation path — the agent that broke things gets first chance to fix it:

Key insight: The agent that pushed the bad code has the most context about what changed — it's the best candidate to fix it. Emergency Fixer is the last resort, armed with full diagnostics.

🏥 Health Monitoring & Self-Healing

Uptime Kuma

Uptime Kuma monitors all services with dashboards and history:

Monitor	Type	Target	Interval
Website	HTTP	port 80	60s
API Health	HTTP	`/health`	60s
API Version	HTTP	`/api/version`	60s
External	HTTPS	your domain	60s
Database	TCP	port 5432	60s
Web Container	Docker	container status	60s
API Container	Docker	container status	60s
DB Container	Docker	container status	60s

Alert threshold: 30 minutes — if a service is down for 30 consecutive checks, the webhook fires.

Webhook → Emergency Fixer Flow

Uptime Kuma detects service DOWN for 30 min
         │
         ├── Is an agent already working on it? → Skip
         ├── Cooldown active (10 min)? → Skip
         │
         ├── Write .alert-context.json (monitor, error, pipeline state)
         └── Launch 🚑 Emergency Fixer with full context

📱 SmartThings Notifications

Agents send push notifications to your phone via Samsung SmartThings:

Agent fails → notify-smartthings.sh → Toggle CopilotAlert switch
→ SmartThings Automation → Push notification to phone 📱

🚨 Urgent Idea System

Need something implemented right now? Submit an urgent idea to ideas/admin_ideas.json:

{ "title": "Add rate limiting", "urgent": true, "status": "pending" }

Every agent checks for urgent ideas at startup. The very next agent to run — whether it's the Website Designer, Lawyer, or Compliance Officer — temporarily becomes a developer, implements the idea, pushes it, then returns to its normal role.

🔬 Agent Prompts

🔥 Radical Visionary — the most ambitious agent

YOUR MISSION: You are the VISIONARY — the most important research agent.
Unlike the 3 specialist agents who focus on incremental improvements,
YOUR job is to find the BIG IDEAS — the ones that make the platform
10x better overnight.

You provide exactly 5 ideas per run — each must be TRANSFORMATIVE:
  🔥 Ideas that create massive visual impact — jaw-dropping dashboards
  🔥 Ideas that leapfrog competitors — features nobody else has
  🔥 Ideas that dramatically improve performance — 10x faster
  🔥 Ideas that bring cutting-edge AI/ML in ways competitors haven't

QUALITY BAR: Each idea should be worth MORE than all 10 ideas
from any specialist agent combined. Think disruption, not polish.

🔧 Developer — reads all ideas, implements the best

You are the DEVELOPER agent. Part of a thirteen-agent autonomous team.

Read the following idea files and implement the best improvements:
  - ideas/web_design_latest.md   (Website Designer — 10 ideas)
  - ideas/portal_design_latest.md (Portal Designer — 10 ideas)
  - ideas/api_architect_latest.md (API Architect — 10 ideas)
  - ideas/radical_latest.md      (Radical Visionary — 5 game-changers)
  - ideas/lawyer_latest.md       (Lawyer — legal ideas)
  - ideas/compliance_latest.md   (Compliance — certification ideas)

Pick the highest-impact ideas and implement them. Use --yolo mode.
After implementation, stamp .build-id and push to GitHub.

🔬 Research agents — read-only enforcement

# Research agents use --deny-tool to prevent code modifications:
copilot --deny-tool "bash(git push*)" \
        --deny-tool "bash(git commit*)" \
        --deny-tool "bash(git add*)" \
        --add-dir "/opt/yourproject:ro"  # Read-only access

⏰ Schedule

# PIPELINE — every minute
* * * * *  copilot-dispatcher.sh

# SPECIALISTS — every hour (10 ideas each)
0  * * * *  copilot-designer-web.sh
5  * * * *  copilot-designer-portal.sh
10 * * * *  copilot-architect-api.sh

# VISIONARY + SUPPORT — every 2 hours
15 0,2,4,6,8,10,12,14,16,18,20,22 * * *  copilot-radical.sh
20 0,2,4,6,8,10,12,14,16,18,20,22 * * *  copilot-lawyer.sh
25 0,2,4,6,8,10,12,14,16,18,20,22 * * *  copilot-compliance.sh

# REPORTER
0 18 * * *    copilot-reporter.sh daily
0 18 * * 0    copilot-reporter.sh weekly

🖥️ Supported Platforms

Platform	Status	Install Method	Scheduling
🐧 Linux (Ubuntu, Debian, etc.)	✅ Full support	Native or Docker	cron
🍎 macOS (Intel & Apple Silicon)	✅ Full support	Native or Docker Desktop	launchd
🪟 WSL 2 (Windows)	✅ Full support	Native (in WSL) or Docker Desktop	cron
🐳 Docker Desktop	✅ Full support	`docker compose up -d`	Built-in
🍓 Raspberry Pi (ARM64)	✅ Full support	Native	cron

Windows native is not supported — use WSL 2 or Docker Desktop instead.

All shell scripts use the built-in platform-detect.sh library for cross-platform compatibility:

File locking: flock on Linux/WSL, mkdir-based atomic lock on macOS
Hex encoding: xxd → od → hexdump fallback chain
File stats: OS-aware stat flags
Docker socket: Auto-detects Docker Desktop, Colima, Podman
Scheduling: Installer auto-picks cron (Linux/WSL) or launchd (macOS)

🚀 Getting Started

One-Line Install

curl -fsSL https://raw.githubusercontent.com/gil906/copilot-hive/main/install.sh | bash

The interactive installer will:

✅ Check prerequisites (git, curl, python3, docker, Copilot CLI)
📁 Clone the repo to /opt/copilot-hive (or your preferred location)
⚙️ Walk you through project configuration (paths, containers, URLs)
📝 Generate your config.sh with all settings
⏰ Install the crontab with all agent schedules
🚀 You're ready — the hive starts working!

Manual Install

# 1. Clone
git clone https://github.com/gil906/copilot-hive.git /opt/copilot-hive
cd /opt/copilot-hive

# 2. Run installer
bash install.sh

# — or configure manually —

# 3. Edit config
cp .env.example .env               # Add your tokens
nano config.sh                      # Set PROJECT_DIR, GH_REPO, container names

# 4. Add version endpoint to your app
# GET /api/version → {"build_id": "...", "status": "running"}

# 5. Install crontab
crontab crontab.example

# 6. Optional: Start health webhook
python3 health-webhook.py &

Docker Install

git clone https://github.com/gil906/copilot-hive.git /opt/copilot-hive
cd /opt/copilot-hive

# Edit config
cp .env.example .env
nano config.sh                      # Set your project paths

# Start the hive
docker compose up -d

npm Install (prompts & CLI only)

npm install -g @gil906/copilot-hive

copilot-hive list                    # List all agent prompts
copilot-hive show developer          # View Developer agent prompt
copilot-hive init ./my-hive          # Scaffold agent scripts

Test Before Going Live

# Dry-run mode — agents work but don't push to GitHub
./copilot-improve.sh --dry-run
./copilot-audit.sh --dry-run

# Pause all agents
touch /opt/copilot-hive/.agents-paused

# Resume
rm /opt/copilot-hive/.agents-paused

Prerequisites

GitHub Copilot CLI — copilot command
Docker + Docker Compose
Git with credentials configured (~/.git-credentials)
A Dockerized application with a /api/version health endpoint
Python 3 + Node.js (for webhook and CLI)

Customization

What	How
Change project settings	Edit `config.sh` (single file)
Add research agents	Copy any `copilot-designer-*.sh`, change the prompt focus
Change idea counts	Edit "EXACTLY 10 ideas" in `prompts/*.md`
Adjust schedules	Edit crontab entries (`crontab -e`)
Change escalation	Set `MAX_FIX_RETRIES` in `config.sh`
Add notifications	Swap SmartThings for Slack/Discord/Telegram
Edit prompts	Modify files in `prompts/` directory (loaded at runtime)
Test safely	Use `--dry-run` flag on any pipeline agent

📁 Files

Full file reference

File	Purpose
`copilot-dispatcher.sh`	📡 Pipeline orchestrator (runs every 1 min)
`copilot-improve.sh`	🔧 Developer agent
`copilot-audit.sh`	🔍 Auditor agent
`copilot-emergencyfixer.sh`	🚑 Emergency fixer with diagnostics
`copilot-designer-web.sh`	🎨 Website Designer (10 ideas/hour)
`copilot-designer-portal.sh`	🖥️ Portal Designer (10 ideas/hour)
`copilot-architect-api.sh`	⚙️ API Architect (10 ideas/hour)
`copilot-radical.sh`	🔥 Radical Visionary (5 game-changers/2h)
`copilot-lawyer.sh`	⚖️ Lawyer agent
`copilot-compliance.sh`	📋 Compliance agent
`copilot-reporter.sh`	📧 Email reporter
`copilot-deployer.sh`	🚀 Deployment helper
`copilot-gitguardian.sh`	🔐 Secret scanner
`copilot-regressiontest.sh`	🧪 Regression tester
`health-webhook.py`	🏥 Uptime Kuma → Emergency Fixer bridge
`notify-smartthings.sh`	📱 Push notification sender

🤝 Contributing

Contributions welcome! Some ideas for extending the hive:

🆕 New agent types (Performance, Accessibility, i18n, SEO)
�� Web dashboard for agent status and idea management
🔌 Slack/Discord/Telegram notification integrations
🐳 Docker Compose for the entire hive infrastructure
📈 Prometheus/Grafana metrics for agent analytics

📄 License

MIT License — see LICENSE

Built with GitHub Copilot 🤖

🐝 The hive never sleeps.

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.github/workflows		.github/workflows
__pycache__		__pycache__
assets		assets
bin		bin
ideas		ideas
lib		lib
projects		projects
prompts		prompts
templates		templates
.env.example		.env.example
.gitignore		.gitignore
.pipeline-status.example		.pipeline-status.example
CHANGELOG.md		CHANGELOG.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
commands.txt		commands.txt
config.sh		config.sh
copilot-architect-api.sh		copilot-architect-api.sh
copilot-audit.sh		copilot-audit.sh
copilot-compliance.sh		copilot-compliance.sh
copilot-deployer.sh		copilot-deployer.sh
copilot-designer-portal.sh		copilot-designer-portal.sh
copilot-designer-web.sh		copilot-designer-web.sh
copilot-dispatcher.sh		copilot-dispatcher.sh
copilot-emergencyfixer.sh		copilot-emergencyfixer.sh
copilot-gitguardian.sh		copilot-gitguardian.sh
copilot-improve.sh		copilot-improve.sh
copilot-lawyer.sh		copilot-lawyer.sh
copilot-radical.sh		copilot-radical.sh
copilot-regressiontest.sh		copilot-regressiontest.sh
copilot-reporter.sh		copilot-reporter.sh
crontab.example		crontab.example
dashboard.js		dashboard.js
docker-compose.yml		docker-compose.yml
health-webhook.py		health-webhook.py
index.js		index.js
install.sh		install.sh
notify-smartthings.sh		notify-smartthings.sh
package.json		package.json
platform-detect.sh		platform-detect.sh
pre-push-check.sh		pre-push-check.sh
prompts-explained.txt		prompts-explained.txt
run-agent.sh		run-agent.sh
run-all-projects.sh		run-all-projects.sh
setup-project.sh		setup-project.sh
track-metrics.sh		track-metrics.sh

Folders and files

Latest commit

History

Repository files navigation

🏗️ Architecture

📸 Copilot Hive UI

🧭 Fleet Overview

🚀 Add Project Modal

🔎 Project Detail, Agents, and Logs

🐝 The Hive — 13 Agents

🔧 Code-Modifying Agents

🔬 Research Agents

📊 Support

💡 Idea Flow

⚡ Event-Driven Pipeline

What a Cycle Looks Like

🔖 Version Verification

🛡️ Smart Failure Coordination

🏥 Health Monitoring & Self-Healing

Uptime Kuma

Webhook → Emergency Fixer Flow

📱 SmartThings Notifications

🚨 Urgent Idea System

🔬 Agent Prompts

⏰ Schedule

🖥️ Supported Platforms

🚀 Getting Started

One-Line Install

Manual Install

Docker Install

npm Install (prompts & CLI only)

Test Before Going Live

Prerequisites

Customization

📁 Files

🤝 Contributing

📄 License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages