Which integrations are available for this server?

Integrates with Amazon Quick Desktop via the Agent Communication Protocol (ACP), allowing users to orchestrate AI agents, list sessions, get status, and run tasks in parallel directly from Quick Desktop.

How do I use Hermes Squad?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Hermes Squad Run a multi-agent code review on the latest commit." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Hermes Squad

by BarnsL

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

🧬 What is Hermes Squad?

Hermes Squad is a multi-agent AI orchestrator combining Claude Squad's session management with Hermes Agent's self-improving intelligence. It integrates natively with Amazon Quick and Kiro via ACP/MCP.

Run multiple AI coding agents in parallel, each in isolated tmux sessions with full git worktree support, while a meta-orchestration layer learns from outcomes, routes tasks intelligently, and continuously improves agent performance.

┌─────────────────────────────────────────────────────────┐
│                    HERMES SQUAD                          │
├─────────────┬─────────────┬─────────────┬──────────────┤
│  Claude Code│   Kiro CLI  │  Gemini CLI │ Hermes Agent │
│  ┌───────┐  │  ┌───────┐  │  ┌───────┐  │  ┌───────┐   │
│  │ tmux  │  │  │ tmux  │  │  │ tmux  │  │  │ tmux  │   │
│  │session│  │  │session│  │  │session│  │  │session│   │
│  └───┬───┘  │  └───┬───┘  │  └───┬───┘  │  └───┬───┘   │
│      │      │      │      │      │      │      │       │
│  ┌───┴───┐  │  ┌───┴───┐  │  ┌───┴───┐  │  ┌───┴───┐   │
│  │  git  │  │  │  git  │  │  │  git  │  │  │  git  │   │
│  │worktree│ │  │worktree│ │  │worktree│ │  │worktree│  │
│  └───────┘  │  └───────┘  │  └───────┘  │  └───────┘   │
├─────────────┴─────────────┴─────────────┴──────────────┤
│           🧠 Self-Improving Intelligence Layer          │
│         (outcome tracking · skill graphs · routing)     │
├─────────────────────────────────────────────────────────┤
│        🔌 ACP/MCP Integration (Quick · Kiro · IDE)      │
└─────────────────────────────────────────────────────────┘

Related MCP server: mcp-switchboard

✨ Features

	Feature	Description
🧠	Self-Improving Intelligence	Learns from task outcomes, builds skill graphs, improves routing over time
🪟	Tmux Session Management	Each agent runs in an isolated tmux session with full terminal access
🌳	Git Worktree Isolation	Parallel agents work on separate branches without conflicts
🎯	Intelligent Task Routing	Automatically assigns tasks to the best-suited agent based on history
🔄	Hot-Swap Agents	Switch between agents mid-task without losing context
📡	ACP/MCP Native	First-class integration with Amazon Quick Desktop, Kiro IDE, and MCP servers
🎨	Rich TUI	Beautiful terminal interface with real-time agent status and output
📊	Performance Analytics	Track agent success rates, completion times, and cost metrics
🔒	Sandboxed Execution	Agents run in isolated environments with configurable permissions
🧩	Plugin Architecture	Extend with custom agents, routers, and integrations
⚡	Parallel Execution	Run multiple agents simultaneously on different tasks
🔁	Auto-Recovery	Detects failures and automatically retries or re-routes to another agent

🚀 Quick Start

One-Line Install

curl -fsSL https://hermes-squad.dev/install.sh | bash

Homebrew

brew tap barnsl/hermes-squad
brew install hermes-squad

Manual Install

git clone https://github.com/barnsl/hermes-squad.git
cd hermes-squad
make install

Verify Installation

hermes-squad --version
# Hermes Squad v0.1.0

First Run

# Start the TUI
hermes-squad

# Or launch with a specific task
hermes-squad run "Refactor the auth module to use JWT tokens"

# Launch multiple agents in parallel
hermes-squad parallel \
  --agent claude-code "Write unit tests for auth" \
  --agent kiro "Update API documentation" \
  --agent gemini "Optimize database queries"

📸 Demo

Screenshot: Three agents working in parallel — Claude Code writing tests, Kiro updating docs, and Gemini optimizing queries.

TUI Overview	Agent Detail	Performance Dashboard

⚙️ Configuration

Hermes Squad uses a layered configuration system:

~/.config/hermes-squad/config.toml    # Global config
.hermes-squad/config.toml             # Project-level config
.hermes-squad/agents.toml             # Agent definitions
.hermes-squad/skills.toml             # Learned skill graphs

Minimal Configuration

# ~/.config/hermes-squad/config.toml

[general]
default_agent = "claude-code"
parallel_limit = 4
auto_commit = true

[intelligence]
learning_enabled = true
skill_graph_path = "~/.config/hermes-squad/skills.db"
routing_strategy = "performance"  # "performance" | "cost" | "round-robin" | "manual"

[integrations.quick]
enabled = true
acp_endpoint = "localhost:7862"

[integrations.kiro]
enabled = true
acp_endpoint = "localhost:7863"

[tui]
theme = "dark"
show_metrics = true
split_view = "horizontal"

Agent Configuration

# .hermes-squad/agents.toml

[[agent]]
name = "claude-code"
binary = "claude"
args = ["--dangerously-skip-permissions"]
max_concurrent = 2
cost_weight = 0.8
specialties = ["refactoring", "testing", "architecture"]

[[agent]]
name = "kiro"
binary = "kiro-cli"
args = ["--agent-mode"]
max_concurrent = 1
cost_weight = 0.3
specialties = ["documentation", "specs", "planning"]

[[agent]]
name = "hermes"
binary = "hermes-agent"
args = ["--self-improve"]
max_concurrent = 1
cost_weight = 0.5
specialties = ["reasoning", "multi-step", "research"]

🤖 Supported Agents

Agent	Status	Specialties	Notes
Claude Code	✅ Stable	Refactoring, Testing, Architecture	Primary agent, best all-rounder
Kiro CLI	✅ Stable	Documentation, Specs, Planning	Spec-driven development
Codex	✅ Stable	Code generation, Completion	Fast for targeted edits
Gemini CLI	✅ Stable	Analysis, Optimization, Research	Strong on large codebases
Hermes Agent	✅ Stable	Reasoning, Multi-step, Self-improvement	Meta-cognition layer
Aider	✅ Stable	Pair programming, Git integration	Great for iterative changes
OpenCode	🧪 Beta	Terminal-native coding	Lightweight alternative
Amp	🧪 Beta	Codebase search, Navigation	Excellent for exploration

Adding Custom Agents

[[agent]]
name = "my-custom-agent"
binary = "/path/to/agent"
args = ["--flag"]
prompt_file = ".hermes-squad/prompts/custom.md"
specialties = ["domain-specific"]

🔌 Integrations

Amazon Quick Desktop (ACP)

Hermes Squad exposes an ACP server that Amazon Quick can connect to directly:

[integrations.quick]
enabled = true
acp_endpoint = "localhost:7862"
expose_tools = ["run_agent", "list_sessions", "get_status", "parallel_run"]

# Register with Quick Desktop
hermes-squad register --quick

Kiro IDE (ACP)

Native integration with Kiro's agent protocol for IDE-embedded orchestration:

[integrations.kiro]
enabled = true
acp_endpoint = "localhost:7863"
workspace_sync = true

# Register with Kiro
hermes-squad register --kiro

MCP Server

Expose Hermes Squad capabilities as an MCP server for any compatible client:

# Start MCP server
hermes-squad mcp serve --port 8080

# Or add to MCP config

{
  "mcpServers": {
    "hermes-squad": {
      "command": "hermes-squad",
      "args": ["mcp", "serve"],
      "env": {
        "HERMES_SQUAD_CONFIG": "~/.config/hermes-squad/config.toml"
      }
    }
  }
}

MCP Tools Exposed

Tool	Description
`hermes_run`	Execute a task with intelligent agent routing
`hermes_parallel`	Run multiple tasks in parallel across agents
`hermes_status`	Get status of all active sessions
`hermes_history`	Query task history and outcomes
`hermes_learn`	Trigger learning from recent outcomes
`hermes_config`	View/update configuration

📚 Documentation

Document	Description
Getting Started	Installation and first steps
Architecture	System design and internals
Agent Guide	Configuring and extending agents
Intelligence Layer	How self-improvement works
ACP Integration	Quick & Kiro integration guide
MCP Server	MCP server reference
CLI Reference	Complete CLI documentation
FAQ	Frequently asked questions
Troubleshooting	Common issues and fixes

🏗️ Project Structure

hermes-squad/
├── src/
│   ├── core/           # Core orchestration engine
│   ├── agents/         # Agent adapters and lifecycle
│   ├── intelligence/   # Self-improving ML layer
│   ├── session/        # Tmux session management
│   ├── git/            # Git worktree operations
│   ├── tui/            # Terminal UI (Ink/React)
│   ├── integrations/   # ACP/MCP connectors
│   └── cli/            # CLI entry point
├── tests/              # Test suites
├── docs/               # Documentation
├── scripts/            # Build and release scripts
├── .hermes-squad/      # Default project config
└── config/             # Default configuration templates

🤝 Contributing

We love contributions! Please see CONTRIBUTING.md for guidelines.

# Development setup
git clone https://github.com/barnsl/hermes-squad.git
cd hermes-squad
make dev-setup
make dev       # Start in development mode
make test      # Run tests
make lint      # Check code style

📄 License

🙏 Credits

Hermes Squad stands on the shoulders of giants:

Claude Squad — Session management architecture and TUI inspiration
Hermes Agent — Self-improving intelligence and skill graph concepts
Amazon Quick — ACP protocol and desktop integration
Kiro — IDE-native agent protocol and spec-driven development

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

anotherai
dev.anotherai
MCP server for building and testing AI agents with multi-model experimentation and insights.
Agent Orchestration Autonomous Agents Testing & QA Tools
2
PlanWrightOAuth
tools.planwright
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
Project Management Autonomous Agents
27
aXOAuthDeprecated
io.github.ax-platform
Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client.
Knowledge & Memory Autonomous Agents Agent Orchestration
36
llm-orchestration-agent-mcp
ai.getvda
LLM Orchestration Agent (Mcp)
Agent Orchestration Autonomous Agents
1

Related MCP Servers

Keshro MCP
Project Management Agent Orchestration
jlewitt1
A
license
D
quality
C
maintenance
The intelligent execution layer for coding agents, exposed as an MCP server for high-stakes engineering projects. It enables AI agents to manage plans, tasks, and integrations via tool calls.
Updated 5 months ago (2026-04-30 15:59 UTC)
25
MIT
mcp-switchboard
Agent Orchestration Developer Tools Autonomous Agents
aslanpour
A
license
Not graded
quality
D
maintenance
Intelligent MCP server orchestrator that automates configuration, orchestration, and lifecycle management of other MCP servers for AI agents.
Updated 9 months ago (2025-12-14 23:52 UTC)
MIT
MAGI Orchestrator
Agent Orchestration Autonomous Agents Developer Tools
reaper1067MSX
A
license
A
quality
C
maintenance
A task-based AI orchestrator that bridges AI models (Gemini, Claude, OpenAI) with local environments, operating as an interactive CLI and an MCP server for structured autonomous development.
Updated 4 months ago (2026-05-13 16:43 UTC)
2
7 npm
MIT
AgentHub
Coding Agents Autonomous Agents
stojandev
A
license
Not graded
quality
B
maintenance
A local MCP server that orchestrates multi-agent coding teams by spawning workers, delegating tasks, and managing session lifecycles through an external MCP client.
Updated 3 months ago (2026-06-10 10:37 UTC)
MIT