Zwei
Agents.
Ein
Workspace
für
Claude Code.Hermes Agent.Agent Skills.Motion Design.
Recherchiert aus offiziellen Dokus: Wie Claude Code und Hermes Agent mit denselben Skills, Tools und Projekt-Kontext in einem Workspace arbeiten — echtes Insider-Wissen, nichts erfunden.
Der Coding-Agent und der Lern-Agent.
Claude Code (Anthropic) ist der Agent, der im Repository lebt. Hermes Agent (Nous Research) ist der persönliche Agent, der über Sessions hinweg dazulernt. Beide sprechen denselben offenen Skill-Standard — deshalb arbeiten sie im selben Workspace zusammen.
Agentic Coding-Tool: liest die Codebase, editiert Dateien, führt Befehle aus und integriert sich in die eigenen Dev-Tools — im Terminal, in der IDE, als Desktop-App und im Browser.
„The agent that grows with you" — selbstverbessernder Personal-Agent mit Lern-Loop: er baut Skills aus Erfahrung, pflegt persistentes Gedächtnis (MEMORY.md, USER.md), durchsucht alte Sessions und läuft als CLI, Desktop-App und hinter Messenger-Gateways (Telegram, Discord u. a.).
Ein Skill-Ordner. Beide Agents.
Der SKILL.md-Standard wurde von Anthropic als offener Standard (agentskills.io) freigegeben — Hermes steht in der offiziellen Client-Liste. Ein Skill ist ein Ordner mit einer SKILL.md plus optionalen Skripten, Referenzen und Templates. Beide Agents laden Skills per Progressive Disclosure und halten so den Kontext klein.
- 01DiscoveryBeim Start lädt der Agent nur Name und Beschreibung jedes Skills — gerade genug, um zu wissen, wann er relevant ist.
- 02ActivationPasst die Aufgabe zur Beschreibung, kommt die volle SKILL.md in den Kontext.
- 03ExecutionDer Agent folgt den Anweisungen, führt gebündelte Skripte aus und lädt Referenzdateien bei Bedarf nach.
---
name: motion-intro
description: Baut ein 10-Sekunden-Produkt-Intro mit
HyperFrames und rendert es als MP4.
---
# Ablauf
1. Brief in Szenen zerlegen (Hook → Produkt → CTA)
2. Timing auf 120 BPM / 60 FPS legen, GSAP-Tweens schreiben
3. HTML-Komposition rendern (HyperFrames → MP4)
4. Frames stichprobenartig gegen das Storyboard prüfen
20 GitHub-Repos, die Coding-Agents zur Motion-Design-Toolbox machen.
Das Prinzip aus der Quelle: Der Agent schreibt den Code, ein Skill führt die Bewegung, eine Engine rendert das Ergebnis. Manche Repos liefern Timing, Typo und Kamera — andere das Rendering; nicht alles wird zu Video, manches bleibt Web-Animation oder Lottie. Liste unverändert aus dem Post übernommen, alle 20 Repos geprüft (Stand: Okt 2026).
Quelle: r/SATNA_PROJECT →Demo-Material, direkt aus den Skill-Repos.
animateDie 7 eingebauten Stil-Richtungen (docs/styles.png)
remotionAnimiertes Offizielles Logo-Banner
hyperframesDesign-Template „Biennale"
hyperframesDesign-Template „Blue Professional" — jedes Template ist ein Startpunkt für den Agent
hyperframesDesign-Template „Bold Poster"
Motion-Design-Skills & Workflows
10 REPOSRendering- & Animations-Fundament
4 REPOSMehr Skills, Libraries & Discovery
6 REPOSMit einer einzigen Kombination startest du: HyperFrames lässt Coding-Agents HTML-basierte Kompositionen bauen und als MP4 rendern — der dokumentierte Workflow läuft über Planung, Animation, Medien, Preview und Rendering. Also: erst ein Workflow aufsetzen, nicht alles gleichzeitig stapeln. Vor jedem Install README, Dependencies und Lizenz checken.
Tiefenprofile und Zusammenspiel.
Alles hier stammt aus den offiziellen Dokus beider Agents — Features, Mechaniken und die Muster, mit denen sie im selben Workspace zusammenarbeiten.
Was jeder Agent wirklich kann — aus den offiziellen Dokus.
Sechs Muster, wie die beiden im Workspace zusammenarbeiten.
Ein Standard, zwei Agents
Der SKILL.md-Standard (agentskills.io) wurde von Anthropic als offener Standard freigegeben — Hermes steht in der offiziellen Client-Liste. Ein Skill-Ordner unter ~/.hermes/skills/ genügt; per Symlink nach ~/.claude/skills/ laden beide Agents denselben Skill per Progressive Disclosure: erst Name + Beschreibung, bei Bedarf die vollen Anweisungen.
Rollen sauber trennen
Claude Code ist der Coding-Agent im Repo: plant, editiert, reviewed PRs — auch automatisch per GitHub Action. Hermes ist der persönliche Agent mit persistentem Gedächtnis: langlaufende Jobs, Cron, Messenger-Gateways. Beide lesen denselben Projekt-Kontext (CLAUDE.md/AGENTS.md) und arbeiten damit an derselben Wahrheit.
Lessons fließen über
Hermes schreibt aus Erfahrung Skills — und über den gemeinsamen Skill-Ordner profitiert Claude Code mit. Umgekehrt zieht sich Hermes offizielle Anthropic-Skills direkt aus dem Hub (hermes skills install anthropics/…), mit Security-Scanner vor jedem Install und Trust-Tier für die Quelle.
Headless trifft Messenger
claude -p scriptet Claude Code kopflos in CI (GitHub Actions/GitLab) für Review und Triage. Hermes' eingebauter Cron liefert Ergebnisse auf Telegram oder Discord. Kombination: Der CI-Job wird von Claude erledigt, der Report landet per Hermes auf dem Handy.
MCP einmal anbinden, doppelt nutzen
GitHub, Browser und Dateisystem als MCP-Server: Claude Code via claude mcp add …, Hermes über seine MCP-Config. Dieselben Werkzeuge stehen danach beiden Agents zur Verfügung — inklusive Hermes' 60+ eingebauten Tools als Erweiterung.
Parallel ohne Sperren
git worktree add pro Agent — Claude Code im einen Checkout, Hermes im anderen, beide pushen ihre Branches. Claude Code bringt zusätzlich Sub-Agents und Background-Sessions mit, Hermes sieben Terminal-Backends (Docker, SSH, Modal …). Modelle frei mischbar: Hermes fährt auch Claude-Modelle (hermes model).
Alles hier ist nachlesbar.
Hermes in der Praxis — neu erzählt.
Das Praxishandbuch von Blake Crosley (Stand: Hermes v0.21.5, Sept 2026) in eigenen Worten aufbereitet: Installation, Ordnerstruktur, die drei Auth-Wege, die Engine dahinter, Gateway-Profiling, Skills & Plugins und die Diagnose-Befehle, die man kennt, wenn es brennt. Original-Guide →
Nur noch Shell-Installer — und Node 26 ist Pflicht.
Was in ~/.hermes/ liegt — und was du selbst pflegst.
Faustregel aus dem Guide: Nur config.yaml, .env und SOUL.md pflegst du von Hand — alles andere gehört dem Agent.
Drei Wege zum Modell.
Keys in der .env
Provider-Keys direkt eintragen — der Guide listet u. a. OPENROUTER_API_KEY, GLM_API_KEY, KIMI_API_KEY, DEEPSEEK_API_KEY, HF_TOKEN, GOOGLE_API_KEY, DASHSCOPE_API_KEY und MINIMAX_API_KEY.
OAuth über hermes model
hermes model bzw. hermes auth legt Tokens in auth.json ab — unterstützt werden Nous Portal, OpenAI Codex, GitHub Copilot und Anthropic. MCP-Login mit Device-Flow: hermes mcp login <name> --flow device (RFC 8628).
Eigener Endpunkt
In der config.yaml auf lokale Server zeigen: Ollama, vLLM, SGLang, llama.cpp, LM Studio oder LiteLLM — läuft dann komplett offline.
Secrets & Umzug
Seit v0.19 holen SecretSource-Referenzen Keys aus Bitwarden oder 1Password (op://). Sitzungswechsel per /model provider:model. Migration: hermes claw migrate (OpenClaw, 30+ Kategorien) und hermes import-agent (Claude Code/Codex CLI).
Ein Schleifenkern, drei API-Modi, ein Spartrick.
Ein Gateway, viele Welten — und was sicherheitsrelevant ist.
Katalog, Prüfungen und eine Frist.
Wenn es brennt: die Kommandos des Guides.
So richtest du beide zusammen ein (Windows-first)
- 01Claude Code installierenPowerShell:
irm https://claude.ai/install.ps1 | iex· danach im Projektordnerclaudestarten und beim ersten Start anmelden. - 02Hermes Agent installierenPowerShell:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)— landet in%LOCALAPPDATA%\hermes. Unter WSL2/Linux/macOS:curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash. Start:hermes. - 03Motion-Skills klonen und teilenBeispiel:
git clone https://github.com/heygen-com/hyperframes "$env:USERPROFILE\.hermes\skills\hyperframes"— und für Claude Code als Symlink verfügbar machen:New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.claude\skills\hyperframes" -Target "$env:USERPROFILE\.hermes\skills\hyperframes". Ein Skill, zwei Agents. - 04Projekt-Kontext anlegen
AGENTS.mdins Projekt-Root (Hermes liest es automatisch), dieselben Regeln inCLAUDE.mdfür Claude Code. Beide Dateien committen. - 05MCP-Server verbindenEinmal anbinden, doppelt nutzen — z. B. GitHub:
claude mcp add github -- npx -y @modelcontextprotocol/server-github; in Hermes denselben Server in der MCP-Config eintragen. - 06Parallel laufen lassenPro Agent ein isolierter Checkout:
git worktree add ../proj-hermes work/hermes— Claude Code im einen Ordner, Hermes im anderen, beide arbeiten ohne Sperren parallel und pushen ihre Branches.
Zwölf Muster, wie Claude Code und Hermes sich wirklich verbinden.
Das Herzstück ist das bidirektionale Tool-Gateway: Hermes ruft externe MCP-Server auf — und stellt sich selbst als MCP-Server bereit. Zusammengefasst aus der „vollständigen Tool-Gateway-Referenz" von Anup Karanjkar (Mai 2026, getestet gegen Hermes v0.13.0): drei Wochen, zwei Stacks, zwölf produktionsreife Muster.
Hermes ruft externe Server auf
GitHub-Issues lesen, Postgres abfragen, Slack senden. Konfiguration in ~/.hermes/config.yaml.
Hermes ist selbst MCP-Server
Claude Code liest Telegram-Threads, Cursor sendet Discord-Benachrichtigungen. Gestartet mit hermes mcp serve.
Claude Code programmiert. Hermes orchestriert.
Hermes läuft dauerhaft auf einem VPS: Telegram-Postfach, Cron-Jobs, Messaging-Gateways. Claude Code läuft lokal: Codebase, IDE, Tests. Verbunden über MCP in beide Richtungen — jeder kann dem anderen Arbeit zuweisen. Das ist der Moment, in dem aus zwei Tools ein System wird.
- 01Lokalen API-Server freigebenIn ~/.hermes/config.yaml: api_server aktivieren mit 127.0.0.1:8765 und Auth-Token.
- 02Hermes als MCP-Server registrierenIn der .mcp.json des Projekts: {"mcpServers":{"hermes":{"command":"hermes","args":["mcp","serve"]}}} — mit HERMES_API_TOKEN als Env.
- 03Dispatch-Skill beibringenEigener Skill dispatch-to-claude-code.md: bei Coding-Aufgaben strukturierte Spec bauen (Ziel, Dateien, Erfolgskriterien) und per POST an den lokalen Webhook senden.
- 04Vom Handy losschickenTelegram: „Refaktoriere die Auth-Middleware und führe die Tests aus" → Hermes dispatcht → Claude Code arbeitet im lokalen Repo → Hermes meldet zurück. Vertrauenswürdige Handy-Coding-Agenten: das ist der Unterschied.
Dateisystem-Lesezugriff
Der Einstieg: einen Projektordner als server-filesystem-MCP einbinden — absoluter Pfad Pflicht, relative Pfade schlagen still fehl. Hermes registriert die Tools automatisch beim Start.
GitHub mit Whitelist
Der GitHub-Server bietet ~40 Operationen — tools.include auf die fünf benötigten begrenzen (list_issues, get_issue …) plus prompts: false, resources: false. Weniger Tools = weniger Token pro Runde, kleinere Angriffsfläche. Ein Issue-Triage-Lauf: ~14.000 Tokens statt 45 Minuten Handarbeit.
OAuth-Remote-Server
Fremde HTTPS-MCP-Server wie Stripe: auth: oauth — Hermes erledigt den PKCE-Flow im Browser und speichert das Token unter ~/.hermes/mcp-tokens/. Finanz-Tools per exclude ausschließen. Falle: Ist include gesetzt, schlägt exclude stillschweigend fehl — include ist eine strikte Whitelist.
Multi-Server-Komposition
Die Produktionskonfiguration: Filesystem + Git + GitHub + nur-lesender Postgres-Server + Docs-Server mit include: [] und resources: true — Kontext anbieten ohne aufrufbare Tools. Ideal für Wikis und Wissensbasen.
Eingehend: die übersehene Hälfte
hermes mcp serve stellt Messaging als MCP-Tools bereit: hermes_list_conversations, hermes_read_messages, hermes_send_message, hermes_poll_events. Wichtig: Lesen funktioniert auch ohne laufendes Gateway (direkt aus der SQLite-DB) — Senden braucht den Live-Adapter.
Cron × Gateway = Selbstverbesserung
Ein PR-Triage-Cron liefert täglich einen Digest aufs Handy — und nach ~15 Läufen schreibt Hermes automatisch einen Skill daraus (weekday-pr-triage-skill.md). Beim nächsten ähnlichen Job lädt der Skill von selbst. Die Fähigkeit kodiert das Wie, das Gateway liefert das Was.
use_gateway mit Disziplin
Pro Tool steuerbar, ob lokal oder über das Nous-Portal geroutet wird — sinnvoll nur für Browser-Stealth-Fingerprinting, IP-Rotation oder GPU-Last. Alles andere lokal: schneller, günstiger, privater.
Auxiliary-Modelle
Tool-Dispatch, Kontextkomprimierung und Skill-Matching laufen über kleine Hilfsmodelle statt über Opus — laut Referenz sparte das an einem arbeitsintensiven Tag rund ein Drittel der Token-Kosten. (Details im Tiefenprofil oben.)
Fallback-Kette
fallback_model in der Config: Anthropic → OpenRouter → Nous Portal. Wechselt einmal pro Session automatisch — bei Rate-Limits, Serverfehlern oder Auth-Fehlern, ohne die Konversation zu unterbrechen. Drei Ebenen reichen; mehr heißt Fehlersuche statt Rotation.
Die Filter-Disziplin
MCP-Tool-Listungen kosten 2.000–4.000 Token pro Runde — die drei Regeln: include statt exclude (Blacklists wachsen mit), prompts/resources: false sofern ungenutzt, und Filter matchen auf Originalnamen (create-issue ≠ create_issue — sonst schlägt der Filter still fehl).
Produktionsdiagnostik
Die Reihenfolge aus dem Referenz-Artikel: hermes doctor → hermes tools list --mcp → hermes logs --tail 200 → /reload-mcp → hermes dump. Die drei Klassiker: Filterkonflikt (Namen prüfen), Token-Ordner (chmod 700 ~/.hermes/mcp-tokens), und zu generische Tool-Beschreibungen.
Referenzen aus der Referenz.
Die Ultimativen Tipps — Tasten, Befehle, Tricks.
Alles aus den offiziellen Dokus der beiden Agents: die Kürzel, die Daily-Driver-Befehle und die Kombis, die den Unterschied machen. Zum Ausdrucken gedacht — Keycap-Optik inklusive.
Hermes Agenthermes-agent …docsDer Claude in dieser Seite.
Er „erwacht" erst, wenn du die Seite öffnest: Dann startet er im Browser, begrüßt dich und antwortet direkt — deine Anfragen gehen aus dem Browser an die Anthropic-API. Du brauchst einmalig einen eigenen API-Key (console.anthropic.com → API Keys); er wird ausschließlich lokal in deinem Browser gespeichert, nichts läuft über einen Zwischenserver.
- 01API-Key erstellenconsole.anthropic.com/settings/keys → „Create Key". Kosten pro Nachricht sind Cent-Bereich; Guthaben nötig.
- 02Key im Chat einfügenGespeichert nur im
localStoragedieses Browsers. Löschen jederzeit über den „Key vergessen"-Link im Chat. - 03Modell wählbarStandard:
claude-sonnet-4-5— frei änderbar (z. B. claude-haiku-4-5 für günstigere Antworten).
- Der Key verlässt deinen Browser nur direkt in Richtung des gewählten Providers — kein Zwischenserver, kein Tracking durch die Seite.
- Gespeichert wird ausschließlich im localStorage dieses Browsers; „Key vergessen" löscht ihn sofort und vollständig.
- Der Chatverlauf lebt nur im Arbeitsspeicher — nach dem Neuladen der Seite ist er weg.
- Dein Key, dein Guthaben: Provider und Modell stehen jederzeit sichtbar im Panel.
- Auf fremden Rechnern: danach „Key vergessen" drücken — oder Key nur zuhause verwenden.