harmonist
Portable AI agent orchestration with mechanical protocol enforcement. 186 agents, zero runtime dependencies.
Harmonist is a portable AI agent orchestration framework that provides 186 specialized sub-agents with mechanical protocol enforcement for AI coding assistants like Cursor, Claude Code, and GitHub Copilot. Unlike prompt-based frameworks, it uses IDE-level hooks to enforce non-negotiable engineering rules—preventing code changes from completing if required reviewers haven't run or security checks were skipped. The framework includes curated domain specialists across engineering, design, marketing, finance, and more, with zero runtime dependencies and supply-chain verification for every agent definition.
Key Features
Use Cases
- 01Enforcing mandatory security and QA reviews before any code change can complete in AI-assisted development
- 02Routing complex tasks to specialized agents (e.g., Solidity auditor for smart contracts, WeChat specialist for China market)
- 03Preventing accidental credential leaks through automated secret-pattern scanning in all memory entries
- 04Maintaining audit trails of architectural decisions and learned patterns across development sessions
- 05Calculating blast radius of code changes using local dependency graphs before shipping
- 06Running specialized reviewers (accessibility, performance, regression) as mandatory gates in AI workflows
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
harmonist — FAQ
What is Harmonist and how is it different from LangChain or AutoGen?+
Harmonist is a drop-in multi-agent framework for AI coding assistants that mechanically enforces protocol rules via IDE hooks, not prompts. Unlike LangChain/AutoGen (frameworks for building agentic apps), Harmonist governs how your AI assistant interacts with your existing project by blocking incomplete turns until required reviewers run.
How do I install Harmonist in my project?+
Clone the repo into your project root as a subfolder, then either paste integration-prompt.md into Cursor Agent mode for guided setup, or run 'python3 harmonist/agents/scripts/integrate.py --pack harmonist --project .' for CLI integration. The AI or script will select relevant specialists, install hooks, and bootstrap memory.
Which AI coding assistants does Harmonist work with?+
Harmonist supports Cursor (primary with full hook enforcement), Claude Code, GitHub Copilot, Windsurf, Aider, Kimi, Qwen, Gemini CLI, OpenCode, OpenClaw, and Antigravity. Enforcement is strongest in Cursor; other tools use convention-based validation.
Does Harmonist require API keys or external services?+
No. Harmonist runs entirely locally with zero runtime dependencies—only Python 3.9+ and Git are required. No API keys, no cloud services, no database, and no third-party Python packages needed.
Is Harmonist free and open source?+
Yes, Harmonist is released under the MIT License and is free for commercial use, modification, and distribution.
Can I customize which agents are active or add my own?+
Yes. During integration you select active roles (engineering, design, marketing, etc.) and only relevant specialists are installed. You can add custom agents following the Schema v2 frontmatter contract documented in agents/SCHEMA.md, or install additional specialists on-demand with install_extras.py.
How do I install harmonist?+
Open the source repository on GitHub and follow its README. harmonist is a agent — MCP Agents Market links you directly to the official repo.
Is harmonist free?+
harmonist is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.