kaminocorp/hermes-alpha/hermes-agent
Claude Code and agent skill by kaminocorp/hermes-alpha
- community
Checking that the SKILL.md file is still in the repository.
Spawn additional Hermes Agent instances as autonomous subprocesses for independent long-running tasks. Supports non-interactive one-shot mode (-q) and interactive PTY mode for multi-turn collaboration. Different from delegate_task — this runs a full separate hermes process.
Install
npx vskill@latest install kaminocorp/hermes-alpha/hermes-agentSKILL.md
The same SKILL.md was published earlier as kaminocorp/hermes-alpha/hermes-agent.
Spawning Hermes Agent Instances
Run additional Hermes Agent processes as autonomous subprocesses. Unlike delegate_task (which spawns lightweight subagents sharing the same process), this launches fully independent hermes CLI processes with their own sessions, tools, and terminal environments.
When to Use This vs delegate_task
| Feature | delegate_task | Spawning hermes process | |
|---|---|---|---|
| Context isolation | Separate conversation, shared process | Fully independent process | |
| Tool access | Subset of parent's tools | Full tool access (all toolsets) | |
| Session persistence | Ephemeral (no DB entry) | Full session logging + DB | |
| Duration | Minutes (bounded by parent's loop) | Hours/days (runs independently) | |
| Monitoring | Parent waits for result | Background process, monitor via process tool | |
| Interactive | No | Yes (PTY mode supports back-and-forth) | |
| Use case | Quick parallel subtasks | Long autonomous missions, interactive collaboration |
Prerequisites
hermesCLI installed and on PATH- API key configured in
~/.hermes/.env
Installation
Requires an interactive shell (the installer runs a setup wizard):
This installs uv, Python 3.11, clones the repo, sets up the venv, and launches an interactive setup wizard to configure your API provider and model. See the GitHub repo for details.
Resuming Previous Sessions
Resume a prior CLI session instead of starting fresh. Useful for continuing long tasks across process restarts:
The full conversation history (messages, tool calls, responses) is restored from SQLite. The agent sees everything from the previous session.
Mode 1: One-Shot Query (-q flag)
Run a single query non-interactively. The agent executes, does its work, and exits:
Background for long tasks:
Mode 2: Interactive PTY Session
Launch a full interactive Hermes session with PTY for back-and-forth collaboration. You can send messages, review its work, give feedback, and steer it.
Note: Hermes uses prompt_toolkit for its CLI UI. Through a PTY, this works because ptyprocess provides a real terminal — input sent via submit arrives as keystrokes. The output log will contain ANSI escape sequences from the UI rendering — focus on the text content, not the formatting.
Interactive Collaboration Patterns
Code review loop — spawn hermes, send code for review, iterate on feedback:
Research with steering — start broad, narrow down based on findings:
Multi-agent coordination — spawn two agents working on related tasks, pass context between them:
Parallel Non-Interactive Instances
Spawn multiple independent agents for unrelated tasks:
With Custom Model
Gateway Cron Integration
For scheduled autonomous tasks, use the schedule_cronjob tool instead of spawning processes — cron jobs handle delivery, retry, and persistence automatically.
Key Differences Between Modes
-q (one-shot) | Interactive (PTY) | --continue / --resume | ||
|---|---|---|---|---|
| User interaction | None | Full back-and-forth | Full back-and-forth | |
| PTY required | No | Yes (pty=true) | Yes (pty=true) | |
| Multi-turn | Single query | Unlimited turns | Continues previous turns | |
| Best for | Fire-and-forget tasks | Iterative work, steering | Picking up where you left off | |
| Exit | Automatic after completion | Send /exit or kill | Send /exit or kill |
Known Issues
- Interactive PTY + prompt_toolkit: The
submitaction sends\n(line feed) but prompt_toolkit in raw mode expects\r(carriage return) for Enter. Text appears in the prompt but never submits. Workaround: Use tmux instead of raw PTY mode. tmux'ssend-keys Entersends the correct\r:
Rules
- Use `-q` for autonomous tasks — agent works independently and exits
- Use `pty=true` for interactive sessions — required for the full CLI UI
- Use `submit` not `write` —
submitadds a newline (Enter),writedoesn't - Read logs before sending more — check what the agent produced before giving next instruction
- Set timeouts for `-q` mode — complex tasks may take 5-10 minutes
- Prefer `delegate_task` for quick subtasks — spawning a full process has more overhead
- Each instance is independent — they don't share conversation context with the parent
- Check results — after completion, read the output files or logs the agent produced
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckinghermes-agent/skills/autonomous-ai-agents/hermes-agent/SKILL.md
Popularity
- Repository stars
- 228
- Repository forks
- 34
- 7-day trend score
- 27
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/kaminocorp/hermes-alpha/hermes-agent)