hermes

agent
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 12 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Local-first handoff CLI that packs unfinished work on your disk and hands it to the next coding agent: Claude, Cursor, Codex, Antigravity, and more. No plugin. No cloud.

README.md
Hermes

Hermes

Local-first CLI for coding-agent context handoff.

Named for the messenger of the gods. Pack the work. Open the next chat. Keep going.

Transfer and resume across Claude Code, Codex, Cursor, Cline, Kimi, Antigravity, OpenCode, Pi Agent, Copilot CLI, ZCode, and DeepSeek Harness.

No MCP. No plugin. No cloud. One Go binary.

Hermes handoff demo

Install

curl -fsSL https://tryhermes.pages.dev/install | sh

Site: tryhermes.pages.dev

Then open a new terminal and run hermes doctor.

If the shell says command not found:

export PATH="$HOME/.local/bin:$PATH"

The only rule

hermes handoff <WHERE YOU ARE GOING>
hermes handoff <WHERE YOU ARE NOW> <WHERE YOU ARE GOING>

One name = destination.
Two names = from, then to.

You are in Cursor. The limit expired. You want Claude:

hermes handoff claude
hermes handoff cursor claude

hermes handoff cursor means go to Cursor, not leave Cursor.

I am here I want to continue here Command
Cursor (limit hit) Claude hermes handoff claude
Claude (limit hit) Cursor hermes handoff cursor
Cursor Antigravity hermes handoff cursor antigravity
Antigravity Cursor hermes handoff antigravity cursor

Hermes only packs a chat that belongs to this folder. Another project (another window, another repo) is ignored. If nothing here matches, the pack is git-only. Pass --id to pick a specific chat.

After the command:

  • Claude / Codex / OpenCode (if that CLI is installed): Hermes starts it with the pack.
  • Cursor / Antigravity: prompt is on the clipboard. New chat → paste.
  • Claude app / VS Code: hermes handoff claude cursor --no-open --copy, then paste.

Reuse the latest pack with hermes resume or hermes resume cursor. Do not type ./handoff-*.

Many chats?

hermes list --agent cursor --here
hermes list --agent cursor --here -q auth
hermes handoff cursor antigravity --id e1884976

The token after the date is the id. A prefix is enough. Without --id, Hermes takes the newest chat for this folder.

Commands

Command What it does
hermes handoff [from] [to] Pack + send to the next agent
hermes resume [to] Reuse the latest pack
hermes list Sessions for this machine
hermes list --here Sessions for this folder
hermes doctor What Hermes can see
hermes site Local landing page
-m, --message     what you were doing
    --from        source agent
    --to          destination
    --id          session id from hermes list
    --no-open     do not start the next CLI
    --copy        put PROMPT.md on the clipboard

Docs

MIT

Reviews (0)

No results found