hermes-agent/website/docs/user-guide
kshitijk4poor ccfbf42844 feat: secure skill env setup on load (core #688)
When a skill declares required_environment_variables in its YAML
frontmatter, missing env vars trigger a secure TUI prompt (identical
to the sudo password widget) when the skill is loaded. Secrets flow
directly to ~/.hermes/.env, never entering LLM context.

Key changes:
- New required_environment_variables frontmatter field for skills
- Secure TUI widget (masked input, 120s timeout)
- Gateway safety: messaging platforms show local setup guidance
- Legacy prerequisites.env_vars normalized into new format
- Remote backend handling: conservative setup_needed=True
- Env var name validation, file permissions hardened to 0o600
- Redact patterns extended for secret-related JSON fields
- 12 existing skills updated with prerequisites declarations
- ~48 new tests covering skip, timeout, gateway, remote backends
- Dynamic panel widget sizing (fixes hardcoded width from original PR)

Cherry-picked from PR #723 by kshitijk4poor, rebased onto current main
with conflict resolution.

Fixes #688

Co-authored-by: kshitijk4poor <kshitijk4poor@users.noreply.github.com>
2026-03-13 03:14:04 -07:00
..
features feat: secure skill env setup on load (core #688) 2026-03-13 03:14:04 -07:00
messaging Merge remote-tracking branch 'origin/main' into feat/honcho-async-memory 2026-03-11 12:22:56 -04:00
_category_.json feat: add documentation website (Docusaurus) 2026-03-05 05:24:55 -08:00
cli.md feat(cli): add /reasoning command for effort level and display toggle 2026-03-11 06:02:18 -07:00
configuration.md Merge PR #736: feat(honcho): async writes, memory modes, session title integration, setup CLI 2026-03-12 19:05:11 -07:00
security.md docs: complete Daytona backend documentation coverage 2026-03-06 03:37:05 -08:00
sessions.md docs: add resume history display to sessions, CLI, config, and AGENTS docs 2026-03-08 17:55:14 -07:00