{"id":50190801,"url":"https://github.com/CryptoDmitry/hermes-agent-control-room","last_synced_at":"2026-06-11T04:01:08.772Z","repository":{"id":334616802,"uuid":"1135473927","full_name":"CryptoDmitry/hermes-agent-control-room","owner":"CryptoDmitry","description":"Control Room-first template for managing Hermes agents from one VPS agent to specialist teams and orchestrated workflows     CA:0x69675210ee8e1160ecee280257a665f66a427ba3","archived":false,"fork":false,"pushed_at":"2026-05-18T13:30:31.000Z","size":2411,"stargazers_count":834,"open_issues_count":0,"forks_count":65,"subscribers_count":90,"default_branch":"main","last_synced_at":"2026-05-18T15:27:58.406Z","etag":null,"topics":["agent-control-room","ai-agent","ai-agents","ai-agents-framework","claude-code","claude-code-cli","development-tools","development-workflow","hermes-agent"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CryptoDmitry.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-16T06:32:50.000Z","updated_at":"2026-05-18T15:11:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"add5ace6-9bfe-4eaf-84cc-edd9c8cf787e","html_url":"https://github.com/CryptoDmitry/hermes-agent-control-room","commit_stats":null,"previous_names":["dmitrysolana/ralph-claude-code","sergio-peschiera/molt-pi-maker","dmitrysolana/molt-pi-maker","cryptodmitry/hermes-agent-control-room"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CryptoDmitry/hermes-agent-control-room","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoDmitry%2Fhermes-agent-control-room","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoDmitry%2Fhermes-agent-control-room/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoDmitry%2Fhermes-agent-control-room/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoDmitry%2Fhermes-agent-control-room/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CryptoDmitry","download_url":"https://codeload.github.com/CryptoDmitry/hermes-agent-control-room/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CryptoDmitry%2Fhermes-agent-control-room/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34181555,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-control-room","ai-agent","ai-agents","ai-agents-framework","claude-code","claude-code-cli","development-tools","development-workflow","hermes-agent"],"created_at":"2026-05-25T13:00:46.949Z","updated_at":"2026-06-11T04:01:08.766Z","avatar_url":"https://github.com/CryptoDmitry.png","language":"Shell","funding_links":[],"categories":["🤖 Agents \u0026 Orchestration"],"sub_categories":[],"readme":"# Hermes Agent Control Room\n\n\u003cimg width=\"1536\" height=\"1024\" alt=\"7715b5434ba6e44167ffe88ddbbfa617\" src=\"https://github.com/user-attachments/assets/341981e8-3a79-478d-8b35-6c51870fd3ac\" /\u003e\n\n\nA public template for setting up an **Agent Control Room** first, then scaling from one Hermes agent to direct specialists, orchestrated teams, and automated workflows.\n\nThe Agent Control Room is a sidecar repo/folder that documents and governs your Hermes agents. It is **not** an agent itself. It is the system map, operating manual, registry, runbook library, and recovery notebook for the agents you run.\n\nIt gives you a clean path from:\n\n```text\none agent -\u003e direct specialists -\u003e orchestrator -\u003e automated agent team\n```\n\n## About\n\nHermes Agent Control Room is a starter kit for people who want to run Hermes agents like an operating system instead of a pile of disconnected bots.\n\nThe repo gives you:\n\n- A control-plane folder structure for documenting agents.\n- Templates for agent runbooks, Docker notes, secret maps, and backups.\n- A level-based architecture for growing from one agent to a specialist team.\n- A task bus pattern for orchestrator-to-specialist delegation.\n- Bundled setup and operations skills an agent can use to build or manage the system.\n\nThe key idea is simple: **set up the Control Room first, then plug agents into it.**\n\n## Core Idea\n\n```text\nCreate a VPS or choose an existing one.\nBootstrap the Agent Control Room.\nRegister one Hermes agent.\nAdd direct specialists when roles become clear.\nAdd an orchestrator when you want one front door.\nAutomate only after the manual system works.\n```\n\nThe Control Room sits on the side as the control plane. You can use it directly, talk directly to any agent, or talk to an orchestrator that delegates to specialists.\n\n```text\nAgent Control Room = side control plane\nOrchestrator       = optional manager/front-door agent\nSpecialists        = focused Hermes agents with role-specific tools\nTask Bus           = handoff desk between orchestrator and specialists\nYou                = owner/operator with direct access to everything\n```\n\n## Full System Shape\n\n```mermaid\nflowchart LR\n  user[\"You / Operator\"]\n\n  control[\"Agent Control Room\u003cbr/\u003e\u003ccode\u003e/root/agent-control-room\u003c/code\u003e\u003cbr/\u003e\u003cbr/\u003eside control plane\u003cbr/\u003edocs / rules / registry\u003cbr/\u003eports / env maps\u003cbr/\u003erunbooks / backups\"]\n\n  orch[\"hermes-orchestrator\u003cbr/\u003e\u003cbr/\u003eoptional front door\u003cbr/\u003edelegation / synthesis\"]\n\n  bus[\"Agent Task Bus\u003cbr/\u003e\u003ccode\u003e/srv/agent-bus\u003c/code\u003e\u003cbr/\u003e\u003cbr/\u003einbox / working\u003cbr/\u003eoutbox / archive\"]\n\n  life[\"hermes-life\u003cbr/\u003epersonal agent\"]\n  seo[\"hermes-seo\u003cbr/\u003eSEO specialist\"]\n  dev[\"hermes-dev\u003cbr/\u003ecode / site work\"]\n  cmo[\"hermes-cmo\u003cbr/\u003emarketing\"]\n  ops[\"hermes-ops\u003cbr/\u003eVPS / backups / security\"]\n\n  user --\u003e|\"control path\u003cbr/\u003eedit docs / rules\"| control\n  user --\u003e|\"orchestrated path\"| orch\n  user --\u003e|\"direct path\"| life\n  user --\u003e|\"direct path\"| seo\n  user --\u003e|\"direct path\"| dev\n  user --\u003e|\"direct path\"| cmo\n\n  control -. \"defines / documents / governs\" .-\u003e orch\n  control -. \"defines / documents / governs\" .-\u003e life\n  control -. \"defines / documents / governs\" .-\u003e seo\n  control -. \"defines / documents / governs\" .-\u003e dev\n  control -. \"defines / documents / governs\" .-\u003e cmo\n  control -. \"defines / documents / governs\" .-\u003e ops\n\n  orch --\u003e|\"routes tasks\"| bus\n  bus --\u003e seo\n  bus --\u003e dev\n  bus --\u003e cmo\n  bus --\u003e ops\n  seo --\u003e|\"results\"| bus\n  dev --\u003e|\"results\"| bus\n  cmo --\u003e|\"results\"| bus\n  ops --\u003e|\"results\"| bus\n  bus --\u003e|\"summaries / artifacts\"| orch\n  orch --\u003e|\"final synthesis\"| user\n```\n\n## Access Paths\n\nYou are never locked into one workflow.\n\n```text\nControl path:\n  You -\u003e Agent Control Room\n\nDirect path:\n  You -\u003e hermes-seo\n  You -\u003e hermes-dev\n  You -\u003e hermes-cmo\n\nOrchestrated path:\n  You -\u003e hermes-orchestrator -\u003e Agent Task Bus -\u003e Specialists -\u003e You\n```\n\n## Architecture Levels\n\n### Level 1: Agent Control Room + One Agent\n\nSet up the Control Room and register one Hermes agent.\n\nBest for:\n\n- One personal Hermes agent\n- VPS setup documentation\n- Docker migration planning\n- Keeping runbooks and secret maps organized\n\nYou do not need an orchestrator or task bus yet.\n\n### Level 2: Direct Specialist Agents\n\nAdd multiple role-specific Hermes agents and talk to them directly.\n\nExamples:\n\n- `hermes-life`\n- `hermes-seo`\n- `hermes-dev`\n- `hermes-cmo`\n- `hermes-ops`\n\nThe Control Room documents all of them. You choose which agent to talk to.\n\n### Level 3: Orchestrator + Specialists\n\nAdd `hermes-orchestrator` as an optional front door. You can still talk directly to specialists, but the orchestrator can route and synthesize work.\n\nThe orchestrator follows the Control Room. It should not become a giant agent with every credential.\n\n### Level 4: Automated Agent Team\n\nAdd recurring workflows, audits, backup checks, task routing, and optional direct gateway/API calls.\n\nOnly add automation after the manual workflow works.\n\n## Bundled Skills\n\nThis repo includes skills that can be linked into Claude Code or adapted for Hermes.\n\n```text\ncreate-vps\n  Create a fresh Hetzner VPS, SSH key, SSH alias, and local provisioning folder.\n\nsetup-control-room\n  Bootstrap an SSH-accessible VPS with Node, Claude Code, Codex, Docker,\n  Hermes Agent, and this Control Room template.\n\nagent-control-room\n  Manage the Control Room docs and agent folders.\n\nagent-task-router\n  Route tasks from an orchestrator to specialists through a task bus.\n\nagent-registry-manager\n  Maintain the agent registry.\n\nagent-backup-manager\n  Design and audit per-agent backups without committing secrets.\n\nagent-security-auditor\n  Check ports, dashboards, SSH, Docker, secret placement, and key scope.\n\nagent-team-cron-planner\n  Plan recurring multi-agent workflows after manual workflows work.\n```\n\n## Suggested Folder Structure\n\n```text\nagent-control-room/\n  README.md\n  agents/\n    .gitkeep\n  docs/\n    architecture.md\n    levels.md\n    naming.md\n    security.md\n    task-bus.md\n    orchestrator.md\n    starter-guide.md\n  shared/\n    api-keys-sop.md\n    commands.md\n    security.md\n  templates/\n    agent/\n      inventory.md\n      docker.md\n      env-map.md\n      runbook.md\n      backup.md\n    docker/\n      docker-compose.agent.yml\n      docker-compose.orchestrator.yml\n    task-bus/\n      agents.yaml\n      task-template.md\n      result-template.md\n  skills/\n    create-vps/\n    setup-control-room/\n    agent-control-room/\n    agent-task-router/\n    agent-registry-manager/\n    agent-backup-manager/\n    agent-security-auditor/\n    agent-team-cron-planner/\n  examples/\n    level-1-control-room-one-agent/\n    level-2-direct-specialists/\n    level-3-orchestrator-specialists/\n    level-4-automated-team/\n```\n\n## Setup\n\nThere are three ways to use this repo.\n\n### Option A: Point An Agent At This Repo\n\nThis repo is designed to be agent-readable.\n\nIf your agent can read a GitHub repo or a local clone, point it here and ask:\n\n```text\nRead this repo and help me set up an Agent Control Room.\nStart with docs/starter-guide.md and the setup-control-room skill.\n```\n\nIf the bundled skills are available to the agent, you can be more direct:\n\n```text\nUse setup-control-room to bootstrap my VPS.\n```\n\nOr, if you need a new Hetzner server first:\n\n```text\nUse create-vps, then chain into setup-control-room.\n```\n\nThe intended agent flow is:\n\n```text\ncreate-vps\n  -\u003e creates a Hetzner VPS, SSH key, and SSH alias\n\nsetup-control-room\n  -\u003e installs tooling and clones this repo onto the VPS\n\nagent-control-room\n  -\u003e helps register and manage agents inside the Control Room\n```\n\nImportant: the repo does not magically run code when opened. It gives your agent the setup instructions, templates, and skills. You still ask the agent to run the setup flow.\n\n### Option B: Manual Setup On An Existing VPS\n\nUse this if you already have an Ubuntu/Debian VPS you can SSH into.\n\nSSH in:\n\n```bash\nssh root@YOUR_SERVER\n```\n\nClone the Control Room:\n\n```bash\ngit clone https://github.com/shannhk/hermes-agent-control-room.git /root/agent-control-room\ncd /root/agent-control-room\n```\n\nRead the starter guide:\n\n```bash\ncat docs/starter-guide.md\n```\n\nRegister your first agent:\n\n```bash\nmkdir -p agents/hermes-life\ncp templates/agent/*.md agents/hermes-life/\n```\n\nThen fill in:\n\n```text\nagents/hermes-life/inventory.md\nagents/hermes-life/docker.md\nagents/hermes-life/env-map.md\nagents/hermes-life/runbook.md\nagents/hermes-life/backup.md\n```\n\nKeep raw secrets out of those files.\n\n### Option C: Bootstrap With The Setup Skill\n\nUse this if you have an SSH alias already configured locally.\n\nThe bundled `setup-control-room` skill is meant to:\n\n- connect to your VPS over SSH\n- install base packages\n- install Node.js\n- install Claude Code\n- install Codex CLI\n- install Docker\n- install Hermes Agent best-effort\n- clone this repo to `/root/agent-control-room`\n- link bundled skills into `~/.claude/skills`\n\nAfter it runs, SSH into the VPS and finish interactive auth:\n\n```bash\nssh \u003calias\u003e\nclaude /login\ncodex\nhermes\n```\n\nThen start using the Control Room:\n\n```bash\ncd /root/agent-control-room\ncat README.md\nls templates/agent/\nls skills/\n```\n\n### Recommended First Milestone\n\nDo not start by building a whole agent team.\n\nFirst milestone:\n\n```text\n1. Control Room exists on the VPS.\n2. One agent is documented in agents/\u003cagent-name\u003e/.\n3. No raw secrets are in the repo.\n4. You can restart/debug/recover that one agent using its runbook.\n```\n\nThen move to Level 2 and add direct specialists.\n\n## Runtime Split\n\nKeep the control plane separate from live runtime state.\n\n```text\n/root/agent-control-room\n  docs, templates, runbooks, registry, architecture\n  no raw secrets\n\n/srv/\u003cagent-name\u003e/data\n  live Hermes runtime\n  .env, memory, skills, sessions, crons, logs\n```\n\n## Security Rule\n\nNever commit raw secrets.\n\nThe control room may record:\n\n- secret names\n- provider\n- scope\n- location\n- rotation date\n\nIt must not record:\n\n- API key values\n- OAuth refresh tokens\n- passwords\n- private keys\n\n## License\n\nMIT. See `LICENSE`.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCryptoDmitry%2Fhermes-agent-control-room","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCryptoDmitry%2Fhermes-agent-control-room","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCryptoDmitry%2Fhermes-agent-control-room/lists"}