What is hermitd?
hermitd is a Claude Code mod by gtapps that your own local Claude Tag, in the Claude app, Discord, Telegram, or a custom Claude Code channel. It is listed under Interface and has 81 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | gtapps |
| Repository | gtapps/hermitd |
| Popularity | 81 GitHub stars |
| Category | Interface |
| Security | Review before installing (68/100) |
| Rank | #137 of 5,272 Claude Code mods; #36 in Interface |
| License | MIT |
| Last commit | 2026-10-18 |
| Stars this week | +6 |
| Hooks | 8 events |
| Sees | classic hooks, compaction, every prompt |
| Draws on | nothing |
Is hermitd safe to install?
hermitd scores 68/100 on the MCPMods security check: Review before installing. Things to review: starts processes outside the sandbox; watches every prompt or event. It passed 4 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts processes outside the sandbox | Review |
| Writes no files or config | Pass |
| Doesn't read environment variables | Pass |
| Watches every prompt or event | Review |
| Drives Claude (model calls, prompts) | Note |
| Validator reported problems | Note |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.after | |
$.command.run | drives Claude |
$.process.run | runs processes |
$.prompt.submit | drives Claude |
$.session.cwd | |
$.session.id |
How do I install hermitd?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/gtapps/hermitd claude plugin validate ./hermitd/plugins/hermitd
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add gtapps/hermitd && claude plugin install hermitd@hermitd
Or ask Claude to set it up
Paste this into Claude Code and it installs hermitd for you:
Install the "hermitd" Claude Code mod from https://github.com/gtapps/hermitd/tree/main/plugins/hermitd. Run claude plugin validate on it first and show me what it can access before you enable it.
More from gtapps/hermitd
This repository has 2 Claude Code mods on MCPMods.
- hermitd-mod-tests: Test wrapper for the core chat harness mod. (Review before installing)