Werk

From its catalog listing

Plain-language equipment description in, engineering package out: werk triages the description into domains, breaks it into work items, runs them through review roles and domain-pack checks (a build123d STEP model for mechanical work; the elec pack ships SKiDL/KiCad tools but designs nothing in this release), and writes a COVER.md with the gaps it found written down. Proof of concept, NOT FOR CONSTRUCTION.

Good to know before installing

`hermes werk doctor --setup` (after consent in a terminal) creates two worker profiles (werk-builder, werk-reviewer) and a Kanban board `werk`, symlinks werk into those profiles' plugins dirs and their plugin-data/werk to your own werk data dir, and uses uv to download a CPython 3.12 build and hash-pinned pack packages from PyPI (mostly wheels, including build123d/OCP) into the plugin's data dir; the elec pack's sdist-only skidl, hierplace and kinet2pcb are built locally with setuptools fetched unpinned at build time, in a minimal environment with no provider keys; `hermes werk run` is a long foreground run (default caps 60M tokens / 24 h) that spends model tokens through your configured providers and runs `hermes kanban` CLI calls; pack tools run as subprocesses in their own venvs with the network cut via `unshare -rn` when available, the elec pack calls the system `kicad-cli` (GPL) if present, and signed overrides use `ssh-keygen`. Three optional supplier-key settings are declared but unused in this version. No telemetry, no self-update.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install werk
  2. Said no? Turn it on later:
    hermes plugins enable werk
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Coding & developer tools
Maintained by
aaddrick (Community)
Needs
No API keys declared
Adds tools
werk_bundle_read werk_item_show werk_item_advance werk_item_renew werk_finding_resolve werk_ir_write werk_tool_run werk_review_submit werk_measure_request werk_status werk_item_list werk_gaps
Adds hooks
pre_tool_call post_tool_call post_api_request kanban_task_completed kanban_task_blocked
Works on
linux
Needs Hermes
0.23.0 or newer
Version
0.1.0
In the catalog
2026-11-11

Known issues (from its catalog listing)

  • Proof of concept: packages are NOT FOR CONSTRUCTION and need review by a licensed engineer.
  • Only mechanical work is designed (a build123d 3D model); elec, power, safety and every other domain are listed as gaps in COVER.md, not designed.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in coding & developer tools

All coding & developer tools plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins