claude-code-hermit

Lightweight .claude-code-hermit/config.json validator — checks required keys, types, routine times, channel structure, env naming. Use after hermit-settings, hermit-evolve, or any config mutation.

Pre-creation gate for proposals — deduplicates against existing PROP-NNN files and applies the three-condition rule. Returns CREATE | SUPPRESS:<reason> | DUPLICATE:<id> — <reason>. Call before proposal-create and before queuing micro-proposals in reflect.

Post-processes reflect candidates — validates that cross-session evidence citations actually exist in S-NNN-REPORT.md before proposals or micro-approvals are queued. Returns ACCEPT | DOWNGRADE:<new-tier> | SUPPRESS per observation.

Manages the session lifecycle — creates SHELL.md, tracks progress, handles closeout, and archives session reports. Use at session start and end.

Returns a 5-line executive summary of recent work. Checks active session first, falls back to latest report. Activates on messages like "brief", "what happened", "morning update", "overnight summary".

Handles inbound messages from Claude Code Channels (Telegram, Discord, webhooks) with session context awareness.

Guided channel activation for local/tmux users — installs the plugin, configures the bot token in the project-local state dir, and walks through pairing. Run after hatch or hermit-settings to activate a configured channel.

Regenerate obsidian/Connections.md from current hermit state. Runs nightly via routine and after each turn that mutates sessions/proposals. Safe to invoke manually. Cortex Portal.md is live Dataview — no rebuild needed.

Enrich existing hermit content with frontmatter and tags. Scans sessions, proposals, and artifact paths for missing fields, clusters similar files for batch confirmation, then rebuilds Connections.md if the Cortex is set up.

Generates Docker scaffolding and walks the operator through the full deployment — token setup, build, start, MCP plugin configuration, workspace trust, and verification. Offers to back up and overwrite existing Docker files. Run after /hatch.

Initializes the autonomous agent in the current project. Creates the state directory, templates, OPERATOR.md, and config.json. Appends session discipline to CLAUDE.md. Detects installed hermits. Run once per project, like git init.

Executes the heartbeat checklist from HEARTBEAT.md. Reads the checklist, evaluates each item, and reports findings or acknowledges with HEARTBEAT_OK. Supports run/start/stop/status/edit subcommands.

Returns a six-check health report on the hermit installation — config validity, hook registration, state file integrity, cost budget, proposal health, file permissions. Use when diagnosing an install, before a release, or after suspicious behavior. Activates on messages like "/hermit-doctor", "health check", "diagnose the hermit", "what's wrong", "run diagnostic".

Evolves hermit configuration and templates after a plugin update. Detects version gaps, presents new features, walks through new settings. Run after updating the plugin.

Summarizes what the operator did during takeover (via git log), optionally queues instructions in NEXT-TASK.md, updates SHELL.md, and restarts the Docker container. Run locally after a /hermit-takeover session.

Manages scheduled routines as per-session CronCreate jobs. Each enabled routine in config.json becomes an idle-gated CronCreate registered at session launch.

View or change hermit configuration for this project. Manages model, channels, budget prompts, morning brief, heartbeat, routines, idle behavior, compaction thresholds, Docker packages, and unattended mode.

Stops the Docker container running the autonomous hermit, marks the session as operator takeover, loads full hermit context, and presents a summary. Run locally (outside Docker) when you want to drive interactively.

Knowledge base maintenance — lint raw/ and compiled/ for stale, unreferenced, missing-type, and oversized artifacts. Read-only report with actionable advice. Activates on messages like "check knowledge", "lint knowledge", "knowledge health".

Audit a hermit-backed repo for safe migration to another machine. Classifies files, generates a migration manifest, and produces a verification checklist. Git-first, conservative by default. In project scope mode, detects unprotected credentials and proposes gitignore additions.

Set up the Hermit Cortex — an Obsidian vault surface over your hermit's state. Creates the obsidian/ directory with Brain, Cortex, Evolution, System Health, Connections, and Cortex Portal pages. Run once per project.

Accept, defer, dismiss, or resolve a proposal. For accepted proposals, asks how to proceed — create a session task or note for manual implementation. Activates on messages like "accept PROP-", "dismiss PROP-", "defer PROP-", "resolve PROP-".

Creates a proposal for a high-leverage improvement discovered during work. Only for ideas with real impact — not trivial fixes. Use when you discover something worth operationalizing.

Lists all proposals with their status, source, and age. Shows auto-detected proposals prominently. Activates on messages like "what have you noticed", "any improvements", "any proposals", "show proposals".

Returns a compact summary of the current session state. Channel-optimized (under 10 lines). Pass --full to append infrastructure health (proposals, routines, last activity, knowledge). Activates on messages like "status", "progress", "what are you working on", "how's it going".

Standalone routine skill for interval-triggered scheduled checks. Runs one due check, gates findings through reflection-judge + proposal-triage, applies state, and logs. Run as a daily routine — not called by reflect.

Reflect on recent work and propose improvements if patterns are noticed.

Closes the current work session with a structured handoff. Archives the session report and prepares for the next session. Activates on messages like "I'm done", "wrap it up", "that's it for now", "done for today", "close the session".

Initializes or resumes a work session. Loads context from OPERATOR.md and SHELL.md, orients the agent, and establishes what to work on. Use at the beginning of every work session.

Start or resume a work session with full context loading and work tracking. Use at the beginning of work.

Post-hatch validation — checks config, OPERATOR.md, plugin references, routines, and optionally sends a channel test message. Run after hatch to verify setup.

Run the hermit plugin test suites and report pass/fail summary

Background watching via the CC Monitor tool. Starts subprocesses that stream events as conversation notifications — zero token cost when quiet. Supports declared config watches (auto-registered on session start) and ad-hoc operator-invoked watches.

Generate the weekly review report for the current ISO week. Writes to .claude-code-hermit/compiled/review-weekly-YYYY-Www.md and updates obsidian/Latest Review.md if the cortex is set up. Runs every Sunday at 23:00 via routine.

8 hooks across 5 events