hermes-agent/website
Teknium 6e0f4e381b
Inspired by Poke: hermes recipe — shareable setup bundles (export/preview/install)
Poke Recipes (poke.com/docs/creating-recipes) let users share their whole
agent setup — automations + integrations + a starter prompt — as one
installable link. This ports the sharing half to Hermes as a CLI command
with a self-hosted, security-first design:

- hermes recipe export: bundles selected cron jobs, remote MCP servers,
  skill references, and a starter prompt into one YAML file. All
  credentials (headers/env/api keys) are stripped and recorded by NAME in
  required_secrets; script-backed jobs and stdio MCP servers are refused.
- hermes recipe show <file|url>: preview without installing.
- hermes recipe install <file|url>: consent-first — full preview +
  confirmation, cron jobs created PAUSED by default (--enable to opt in),
  MCP servers merged without overwriting existing entries and validated
  through the SSRF guard, skills suggested via the normal hub flow.

Zero model-tool footprint (CLI command + docs per the footprint ladder).
20 unit tests + E2E round-trip (export from one HERMES_HOME, install into
a fresh one; secret-leak assertion on the dumped YAML).
2026-08-09 18:12:08 -07:00
..
docs Inspired by Poke: hermes recipe — shareable setup bundles (export/preview/install) 2026-08-09 18:12:08 -07:00
i18n/zh-Hans/docusaurus-plugin-content-docs/current docs: preserve observer version compatibility 2026-08-09 01:30:33 -07:00
scripts
src
static
.gitignore
.npmrc fix(deps): patch 31 known CVEs across Python and npm lockfiles 2026-08-08 14:06:48 -07:00
README.md
docusaurus.config.ts feat(docs): replace local lunr search with Algolia DocSearch 2026-08-08 11:14:13 -07:00
package-lock.json chore(deps): reconcile website lock after Algolia search migration rebase 2026-08-08 14:06:48 -07:00
package.json fix(build): allow get-windows install script, refresh stale allowScripts pins 2026-08-08 21:23:16 -05:00
sidebars.ts Inspired by Poke: hermes recipe — shareable setup bundles (export/preview/install) 2026-08-09 18:12:08 -07:00
tsconfig.json

README.md

Website

This website is built using Docusaurus, a modern static website generator.

Installation

yarn

Local Development

yarn start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Build

yarn build

This command generates static content into the build directory and can be served using any static contents hosting service.

Deployment

Using SSH:

USE_SSH=true yarn deploy

Not using SSH:

GIT_USER=<Your GitHub username> yarn deploy

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the gh-pages branch.

Diagram Linting

CI runs ascii-guard to lint docs for ASCII box diagrams. Use Mermaid (````mermaid`) or plain lists/tables instead of ASCII boxes to avoid CI failures.