Files
ngn-agent/.planning/research/hermes/SUMMARY.md
Bagas Purwa Sentika 0355858596 docs: update project state through Phase 3
Phase 2: memory, session search, git worktree configured
Phase 3: Telegram gateway connected, DM pairing approved
Phase 4: custom skills created (aws-diagnostics, jira-query, confluence-search, bitbucket-pr)
2026-06-14 12:02:04 +08:00

3.6 KiB

Hermes Agent: Feature Research Summary

Context: This research maps Hermes v0.16.0 capabilities so ngn-agent doesn't reimplement what Hermes already provides. All features listed are built-in — ngn-agent should leverage them, not rebuild them.

Date: 2026-06-14


What Hermes Does Out of the Box (Don't Reinvent)

  • Multi-session management with resume (hermes --continue, sessions list)
  • Persistent memory (MEMORY.md + USER.md) with auto-learning
  • Full-text session search (FTS5 on SQLite)
  • 8 external memory providers (Honcho, Mem0, Hindsight, OpenViking, Holographic, RetainDB, ByteRover, Supermemory)
  • Skills system with progressive disclosure (3-level loading)
  • Skills Hub with 8 search sources (official, skills.sh, well-known, GitHub, ClawHub, LobeHub, browse.sh, direct URL)
  • Git worktree isolation (hermes -w)
  • Agent-created skills (skill_manage tool) - self-improving by default
  • Skill bundles (group skills under one slash command)
  • Cron/automation with 30+ delivery targets
  • No-agent cron mode (script-only, zero LLM cost)
  • Multi-provider fallback (credential pools + cross-provider)
  • Docker container backend with security hardening
  • Dangerous command approval (manual/smart/off modes)
  • Hardline blocklist for catastrophic commands
  • 20+ messaging platforms (Telegram, Discord, Slack, WhatsApp, Signal, Teams, etc.)
  • DM pairing for gateway authorization
  • Session isolation with configurable reset policies
  • Profiles for multi-agent setups
  • Plugin system (tools + hooks + commands)
  • MCP server integration
  • Context compression with configurable thresholds
  • Worktree isolation for git parallel branch work
  • SOUL.md for personality/identity
  • Subagent delegation (delegate_task)
  • Background sessions (/background)
  • Kanban multi-agent board
  • Docker sandbox with --cap-drop ALL, no-new-privileges, PID limits
  • SSRF protection and tirith pre-exec scanning

What ngn-agent Needs to Build

Based on initial-plan.md, these features are NOT built into Hermes:

  1. Jira integration — Hermes has no built-in Jira tool. Need custom skill or MCP server
  2. Confluence integration — Same, need custom skill or MCP server
  3. Infrastructure-specific diagnostics — Generic skills exist but no AWS/terraform-specific ones by default
  4. Read-only infra safety layer — Hermes has dangerous command approval but nothing specific to cloud APIs
  5. Auto session cleanup (30d archive) — Hermes has session reset policies but not our specific archive flow
  6. Telegram gateway — Hermes supports it, just needs bot token config
  7. SSO session automation — Need custom startup script (already created scripts/start-session.sh)
  8. Custom reporting pipeline — Cron + skills can provide this

Key Limitations to Know

Area Limitation
Memory capacity MEMORY.md: ~800 tokens, USER.md: ~500 tokens. External providers (Honcho, etc.) remove this limit.
Docker dangerous commands Checks are skipped in Docker mode — container is the boundary
Cron provider recovery Inherits fallback_providers; per-job provider override available
Gateway user authorization Allowlists or DM pairing required — denies all by default
Skills are per-profile Each Hermes profile has its own skills directory
Plugin discovery User plugins opt-in via plugins.enabled in config.yaml

Start with built-in memory (MEMORY.md + USER.md) — no external deps needed. If the ~1300 token limit is hit, add Honcho (cross-session user modeling) or Holographic (local SQLite with FTS5 search, no external deps).