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
- Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
hermes plugins install werk - Said no? Turn it on later:
hermes plugins enable werk - 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_readwerk_item_showwerk_item_advancewerk_item_renewwerk_finding_resolvewerk_ir_writewerk_tool_runwerk_review_submitwerk_measure_requestwerk_statuswerk_item_listwerk_gaps- Adds hooks
pre_tool_callpost_tool_callpost_api_requestkanban_task_completedkanban_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

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