SkillFoxx

hermitd plugin

hermitd runs an always-on Claude Code agent on your machine: tasks from chat, scheduled checks and saved state after a restart.

  • 84 ★ on the repository
  • Last commit
  • MIT
Plugin

Broad access

Why this level

  • An always-on agent runs unattended, sees the machine files, local network and SSH, and is controlled through external chats.
  • The fresh machine installer runs through `curl` and `bash`.
All reasons and checks

gtapps/hermitdAuthor:gtapps

Install

Works in

Manual install

claude plugin install hermitd --marketplace gtapps/hermitd --scope local

From the Set up section of the README, then `claude "/hermitd:hatch"`; a script installer exists for a fresh machine.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • An always-on agent runs unattended, sees the machine files, local network and SSH, and is controlled through external chats.
  • The fresh machine installer runs through `curl` and `bash`.

This is third-party code. Review the repository files before installing.

What it does

hermitd is a Claude Code plugin that turns it into an always-on agent. Sessions start and run from Discord, Telegram, iMessage or a custom Claude Code channel, and the same session can be taken over in the Claude app or the CLI. Tasks, saved watches and pending decisions survive a restart. The agent gets its own browser, regular checks of its responsibilities, scheduled routines and change watchers. The `hermitd start` command keeps it in a tmux session and a watchdog recovers failed sessions. Docker is supported through `/hermitd:docker-setup`. It runs on a Claude subscription.

Who it is for. People who want a permanent local assistant on Claude Code, assigning it tasks from a messenger and receiving reports without an open terminal.

Good fit when

  • Tasks must be given to the agent from a phone through Telegram or Discord.
  • The agent should watch systems and remind you of unfinished work itself.
  • Working state must be kept across machine restarts.
  • The agent works next to a local database, SSH and network devices.

Not a fit when

  • You need a one off session with no always-on process.
  • The agent must not get access to the local network and machine files.
  • You have no Claude subscription or WSL2 on Windows.

Example request

Check service status every morning and message me in Telegram only about what needs a decision.

Limitations

It needs Claude Code 2.1.322 or newer and Bun 1.4 or newer, and on Windows it runs through WSL2. The agent works continuously and sees everything the machine can reach: files, the local network, SSH. For unattended use the author recommends Claude Code `/sandbox` mode and Docker restrictions. Token spend depends on how often responsibilities are checked. The installer for a fresh machine runs through `curl` and `bash`, so read it before running. You need your own Claude subscription.

How to disable. Stop the agent, run `claude plugin uninstall hermitd` and delete the agent folder with its state. Stop and delete the Docker container separately.

FAQ

How do I connect a chat?

Run `/hermitd:channel-setup` as the setup wizard directs. Discord, Telegram, iMessage and a custom channel are supported.

How do I run it on my machine?

With `hermitd start` in a persistent tmux session. tmux is required and a watchdog recovers failed sessions.

Can it run in Docker?

Yes, with `/hermitd:docker-setup`. Docker Compose v2 is required, and network and resource limits are described in a separate guide.

What does the agent do between requests?

It checks your responsibilities on a schedule, runs routines and watches for changes, then messages you if something needs attention.

Is this a wrapper around Claude Code?

No, it is a plugin. There is no new harness and all Claude Code features are available.

Discussion

No questions or reviews yet.

Plugins

A Claude Code plugin that gives the agent a name, a personality and memory across sessions, plus chat channels.

PluginBroad access64

Instar runs a persistent agent on top of Claude Code or Codex with memory, scheduled jobs and replies over Telegram.

CLIBroad access86

OpenHermit runs a fleet of AI agents as production services: Postgres state, sandboxes, Telegram, Discord and Slack channels

CLIBroad access90

A tmux-based TUI that runs Claude Code, Codex and other agents in one list: status, quick prompts, worktrees and diff review

CLIBroad access691

A local control panel for coding agents: it runs Claude Code and Codex, keeps a task queue and merges verified work into main.

CLIBroad access119

Mycelium puts people and their coding agents into shared rooms with chat, a task board and memory that stays in the room.

CLIBroad access128

README in short

A plugin for an always-on Claude Code agent: chat channels, responsibilities and routines, state persistence and a watchdog. Version 1.4.31.

README badge

Report a problem