# Butler: Hermes Agent plugin

> Turns the Hermes desktop pet into an on-screen operator: WALK draws a guide on the real controls and verifies each step from the macOS Accessibility tree, DESCRIBE reads the control under your pointer (role,…

Canonical: https://hermeswatcher.com/plugins/butler  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/butler  
Last updated in catalog: 2026-11-14

Turns the Hermes desktop pet into an on-screen operator: WALK draws a guide on the real controls and verifies each step from the macOS Accessibility tree, DESCRIBE reads the control under your pointer (role, label, enabled state, value) without letting the click reach your app, and WATCH announces one condition from an app in the background and keeps it until you acknowledge it. Accessibility only: no screenshots, no OCR, no Screen Recording, no Input Monitoring.

## Good to know before installing

MacOS only; needs the Accessibility permission, which lets its helper read the controls and text of other apps on screen. On first use it downloads its native screen helper from the author's GitHub release and refuses it unless it matches the checksum pinned in the plugin source (otherwise it compiles the bundled Swift source with swiftc), and LOOK mode intercepts clicks across the screen until you pick or cancel. Sending from the pet into a chat requires `allow_gateway_injection: true` for this plugin.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install butler
```

2. Said no? Turn it on later:

```bash
hermes plugins enable butler
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Hermes Desktop add-ons, Memory & notes
- Maintained by: Intenzi (Community)
- Needs: No API keys declared
- Adds tools: `butler_capture`, `butler_guide_start`, `butler_guide_status`, `butler_look`, `butler_say`, `butler_stop`, `butler_watch_ack`, `butler_watch_start`, `butler_watch_status`, `butler_watch_stop`
- Works on: macos
- Requires Hermes: `>=0.22.5`
- Version: 0.4.1
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/butler)
- [Source code](https://github.com/Intenzi/hermes-butler/blob/main/README.md)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
