Loading repository data…
Loading repository data…
Stanshy / repository
One person, one software company. Manage 47 AI agents from a single Electron app — with Harness Engineering (Skills + Hooks + FileWatchers) for disciplined, traceable AI workflows.
Build a virtual development team with Claude Code, and use Harness Engineering to keep AI working with discipline.
Website · Claude Code Mastery · Quick Start
AgentHub is not another AI chat interface.
It is a Harness Engineering system that lets you build a virtual development team with Claude Code — complete with a PM, Tech Lead, frontend developer, backend developer, and designer — and manage them like a real boss.
You give the orders. Agents execute. Hooks enforce quality. Skills standardize process. FileWatcher syncs in real time.
No prompt prayers. No "hope the AI remembers the rules." Rules live in Hooks. Agents that break them get blocked. It's that simple.
AgentHub doesn't solve "AI isn't smart enough." It solves "smart AI without discipline."
Most AI tools follow this logic: write better prompts → pray the AI complies.
AgentHub follows a different logic: replace text prayers with architectural constraints.
| Traditional AI Tools | AgentHub |
|---|---|
| "Please remember to run tests" | Stop Hook: tests must pass before the Agent can finish |
| "Please don't modify shared files" | PreToolUse Hook: dangerous commands are blocked outright |
| "Please follow the coding standards" | PostToolUse Hook: if a core service file changes, doc sync is forced |
| "Please follow the process" | Skill: standardized Sprint / Review / Gate workflows |
| "Please remember the pitfalls from last time" | FileWatcher: postmortem notes auto-sync to all new projects |
A good validator with a bad workflow beats a good workflow without a validator. This isn't a slogan — it's math: 5 steps at 80% success each = 33% overall. Add a validator that allows retries = 99%.
Just like a race car needs more than a great engine — it needs seatbelts, guardrails, and a pit stop process.
Reusable workflow templates that automatically load the relevant guidance when an Agent runs them.
/sop-execute — L2 execution SOP: mandatory spec loading → implement → acceptance verification/sop-plan — L1 planning SOP: context loading → complexity analysis → Plan Mode decision → task breakdown/sop-review — L1 review SOP: load standards → code review → approve or reject/sop-deploy — Deploy SOP: quality checklist → pre-deploy → Gate G5/task-dispatch — Boss creates a task with one command, automatically written to the dev plan/review — Auto-detects the step and selects the appropriate review type/pre-deploy — Pre-deployment automated checks (CI / environment variables / Docker)/harness-audit — Periodic health scan scoring against seven core principlesNot after-the-fact reminders — real-time blocking. Dangerous operations are stopped the moment they happen.
Markdown files are the database. Edit a .tasks/ file and the GUI updates instantly.
.tasks/T5.md is modified
→ chokidar detects the change
→ markdown-parser parses the file
→ DB upsert
→ eventBus broadcasts
→ Vue reactive update
→ GUI reflects the change instantly
G0 (Requirements Confirmation) → G1 (Design Review) → G2 (Code Review) → G3 (QA Acceptance) → G4 (Documentation Review) → G5 (Deploy Readiness) → G6 (Production Release)
You cannot proceed without passing. Not enforced by willpower — enforced by architecture.
An Electron desktop app with a dark theme.
An embedded xterm.js terminal lets you interact with Claude Code Agents directly inside the GUI.
A five-column kanban board with automatic status transitions. Click any card to see full task details.
One-click Harness scaffolding with live display of task completion rate, active Sprint, and latest Gate status.
Every Agent has its own role definition, permission scope, and reporting chain.
Real-time Hook execution history with filtering, statistics, and rankings at a glance.
You are the Boss. Below you is your virtual software company — 9 departments, 46 Agents:
Boss (You)
├── L1 Leadership (report directly to Boss)
│ ├── Product Manager — Product strategy and roadmap
│ ├── Tech Lead — Technical decisions and architecture
│ ├── Design Director — UI/UX and design systems
│ ├── Marketing Lead — Marketing strategy
│ ├── QA Lead — Quality assurance
│ ├── Project Lead — Project scheduling and milestones
│ ├── Operations Lead — Studio operations
│ └── Company Manager — Company-wide knowledge management
│
└── L2 Execution (report to L1, cannot escalate directly to Boss)
Product
| Agent | Responsibilities |
|---|---|
| Product Manager | Requirements management, Sprint planning, Gate review |
| Feedback Synthesizer | User feedback collection and analysis |
| Sprint Prioritizer | Feature prioritization |
| Trend Researcher | Market trend research |
Engineering
| Agent | Responsibilities |
|---|---|
| Tech Lead | Technical decisions, Code Review, architecture design |
| Frontend Developer | Frontend development (Vue / React) |
| Backend Architect | Backend architecture and API development |
| DevOps Automator | CI/CD, deployment, infrastructure |
| AI Engineer | AI/ML feature implementation |
| Mobile App Builder | iOS / Android / React Native |
| Rapid Prototyper | Fast prototyping and MVP |
Design
| Agent | Responsibilities |
|---|---|
| Design Director | UI/UX design, design system maintenance |
| UI Designer | Interface design and component library |
| UX Researcher | User research and usability testing |
| Visual Storyteller | Visual storytelling and infographics |
| Brand Guardian | Brand consistency enforcement |
| Whimsy Injector | Delightful micro-interaction experiences |
Marketing
| Agent | Responsibilities |
|---|---|
| Marketing Lead | Marketing strategy and coordination |
| Content Creator | Cross-platform content generation |
| Growth Hacker | User growth and viral distribution |
| Twitter Engager | Twitter/X community management |
| Instagram Curator | Instagram visual content strategy |
| TikTok Strategist | TikTok short-video strategy |
| Reddit Community Builder | Reddit community building |
| App Store Optimizer | ASO keyword and conversion rate optimization |
Testing
| Agent | Responsibilities |
|---|---|
| QA Lead | Testing strategy and quality assurance |
| Test Writer Fixer | Writing tests and fixing failures |
| API Tester | API endpoint testing |
| Performance Benchmarker | Load testing and performance benchmarks |
| Test Results Analyzer | Test result analysis and trend tracking |
| Tool Evaluator | Tool and framework evaluation |
| Workflow Optimizer | Workflow optimization |
Project Management
| Agent | Responsibilities |
|---|---|
| Project Lead | Project scheduling and milestones |
| Project Shipper | Release coordination and launch management |
| Studio Producer | Cross-department resource coordination |
| Experiment Tracker | A/B testing and experiment tracking |
Studio Operations
| Agent | Responsibilities |
|---|---|
| Operations Lead | Operations coordination |
| Company Manager | Cross-project knowledge management |
| Harness Manager | Skill/Hook creation and management |
| Analytics Reporter | Data analysis and reporting |
| Finance Tracker | Budget and cost management |
| Infrastructure Maintainer | System monitoring and maintenance |
| Legal Compliance Checker | Regulatory compliance review |
| Support Responder | Customer support |
| Context Manager | Context management |
Bonus — Special Roles
| Agent | Responsibilities |
|---|---|
| Studio Coach | Team coaching and process improvement suggestions |
| Joker | Creative ideation and out-of-the-box thinking |
Every Agent has its own role definition file (agents/definitions/), permission scope, and reporting chain. L2 cannot bypass L1 to reach the Boss, and the Boss cannot bypass L1 to directly command L2. Just like a real company.
| Layer | Technology |
|---|---|
| Desktop Framework | Electron 35 |
| Frontend | Vue 3 + TailwindCSS 4 |
| State Management | Pinia |
| Database | sql.js (WASM SQLite, main process in-memory) |
| Terminal | xterm.js + node-pty |
| AI Engine | Claude Code (CLI) |
| File Watching | chokidar |
AgentHub is a management framework built on top of Claude Code. All actual Agent work is executed through the Claude Code CLI.
| Requirement | Version | Notes |
|---|---|---|
| Node.js | >= 18 | Required for Electron and frontend builds (LTS recommended) |
| npm | >= 9 | Installed with Node.js, used for package management |
| Claude Code | Latest | Anthropic's official CLI tool and AgentHub's AI engine. Must be installed and authenticated first. |
| Git | >= 2.30 | Version control, required for project cloning and Agent operations |
| Python | >= 3.8 | Required to compile node-pty native modules (Windows) |
| C++ Build Tools | — | Required to compile node-pty native modules (see platform setup below) |
Windows
# Install Windows Build Tools (Admin PowerShell)
npm install --global windows-build-tools
# Or manually install Visual Studio Build Tools (select the "Desktop development with C++" workload)
macOS
# Install Xcode Command Line Tools
xcode-select --install
Linux (Ubuntu/Debian)
sudo apt-get install -y build-essential python3
Without Claude Code, AgentHub is just an empty GUI shell. All Skill execution, Hook interception, and Agent conversations depend on the Claude Code CLI.
# 1. Confirm prerequisites are installed
node --