# Foreman: Hermes Agent plugin

> A green check the agent did not rig. A deterministic gate (no model, standard library and git) blocks git commit, git push and gh pr create when the change skips, deletes or moves tests, weakens what the check…

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

A green check the agent did not rig. A deterministic gate (no model, standard library and git) blocks git commit, git push and gh pr create when the change skips, deletes or moves tests, weakens what the check runs, bypasses hooks or carries a secret, and always blocks an agent-run gh pr merge; an optional second model reviews what rules cannot see, such as a loosened assertion. /foreman shows each pull request with a verdict and merges only on your command; a Desktop panel shows where each change is.

## Good to know before installing

Runs read-only git in your repository; runs the GitHub CLI only on /foreman commands (merge and reject write to GitHub after your confirmation) and model calls only on /foreman commands or, with auto_review: finish, inside the agent's turn; notifications are off until you turn them on; no telemetry, no credentials, no network calls of its own. Full disclosure in the README.

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 foreman
```

2. Said no? Turn it on later:

```bash
hermes plugins enable foreman
```

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: Automation & multi-agent, Security & privacy
- Maintained by: PedValme (Community)
- Needs: No API keys declared
- Adds tools: `foreman_check`, `foreman_review`
- Requires Hermes: `>=0.22.6`
- Version: 0.1.0
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/foreman)
- [Source code](https://github.com/PedValme/foreman/blob/main/plugin/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
