hermes-labs-ai

Hermes Prime — Development skill for Claude Code

Development community

Drift-prevention session-init convention card for fresh Claude Code sessions.

How to install Hermes Prime

This entry records only its repository, not the path inside it, so there is no exact command to give. Open hermes-labs-ai/hermes-prime and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hermes Prime does

Drift-prevention session-init convention card for fresh Claude Code sessions. Injects a self-contained card so a new session opens with its grounding triggers, calibration rules, and tool-map in scope — instead of re-deriving them at minute 30. Per-project, marker-anchored, idempotent, reversible. Bash installer plus MCP server.

Alternatives in Development

Friction Protocol — Friction protocol — convention 29.1k ★
Domxss — Confirm DOM XSS in a real headless browser — injects canary payloads into params + URL fragment and only repor 4.5k ★
Agentlas Login — Sign this machine into Agentlas (opens the browser sign-in window) 1.1k ★

README

hermes-prime

**Deliver a versioned convention card to a fresh Claude Code session.** The Bash surface snapshots the card into a project's `CLAUDE.md`; the read-only MCP surface returns the same card over stdio. The mechanism makes conventions available. It does not prove that a model will follow them or prevent drift.

[![CI](https://github.com/hermes-labs-ai/hermes-prime/actions/workflows/ci.yml/badge.svg)](https://github.com/hermes-labs-ai/hermes-prime/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Status: alpha](https://img.shields.io/badge/status-alpha-orange.svg)](#status)

This is a small transport, not an enforcement layer. Hermes Labs ships the convention card it uses itself; fork it or select another fragment with `HERMES_SESSION_INIT_FRAGMENT=/path/to/custom.md`.

Two surfaces share one fragment: a four-subcommand Bash tool for `CLAUDE.md`-based workflows and a Claude-Code-native MCP server that does not mutate `CLAUDE.md`. Neither surface calls a model or a network service. The Bash path makes no global configuration change; MCP registration uses the scope the user selects.

Pain

Conventions can fall out of visible context between sessions. A versioned card gives a new session one concrete artifact to read instead of requiring it to reconstruct those conventions from scattered notes.

The discipline rules normally live in scattered handbook docs, feedback files, or session-end retros — places a fresh session never reads. `hermes-prime` packages them as a single self-contained card the orchestrator opens with.

How it's different

Most "set up the agent" tools either (a) ship a giant prompt file you copy-paste, or (b) install a global hook that runs on every session whether you want it or not. `hermes-prime` is per-project, marker-anchored, and idempotent. Unedited injected suffixes are byte-reversible; edited blocks use the documented marker/backup fallback.

The fragment is a snapshot