runbox.yaml 2.7 KB

12345678910111213141516171819202122232425
  1. name: runbox
  2. repo: https://github.com/Zek-Takai/hermes-runbox
  3. sha: 544e6f35c65c45d085a90078a328dbd8c3fb8872
  4. subdir: plugin
  5. title: runbox
  6. version: "0.1.0"
  7. description: "Build, run and test Python in an offline container per chat, with results as a plain file:line issue list. The agent syncs files or folders in as copies, then runs run (a shell command), check (ruff error rules) and test (pytest); fixes stay in the box until the user asks for export, which writes changed files back through write_file and reports host files changed since the sync as conflicts. In Hermes Desktop a VS Code-style editor opens beside the chat: file tabs with in-place editing, Run / Check / Test / Stop, and PROBLEMS / OUTPUT / RUNS panels that follow the agent live. Ships the runbox:dev-loop starting-point skill. Disclosure — needs Docker (on macOS a dedicated colima profile 'runbox', started on demand with --activate=false and its own Docker config); pulls the container image pinned by digest and installs a hash-pinned checker toolchain (ruff 0.16.9, pytest 9.1.1 and deps) from PyPI once per image; the work container has no network, hardened flags, and runs commands without Hermes' dangerous-command approval like Hermes' Docker backend; install (PyPI) always asks for approval in a separate installer container; a write_file/patch on an imported original asks for approval (guard_imports); export reads each existing target through read_file before replacing it; a background thread removes idle containers (15 min), stops the VM, and removes boxes of deleted or long-idle chats (reads state.db read-only hourly); adds a short per-turn note (about 80 tokens); no credentials or telemetry."
  8. maintainer: Zek-Takai
  9. tier: community
  10. category: tools
  11. requires_hermes: ">=0.22.2"
  12. platforms: [linux, macos]
  13. image: https://raw.githubusercontent.com/Zek-Takai/hermes-runbox/544e6f35c65c45d085a90078a328dbd8c3fb8872/docs/runbox-banner.png
  14. screenshots:
  15. - https://raw.githubusercontent.com/Zek-Takai/hermes-runbox/544e6f35c65c45d085a90078a328dbd8c3fb8872/docs/runbox-desktop.png
  16. - https://raw.githubusercontent.com/Zek-Takai/hermes-runbox/544e6f35c65c45d085a90078a328dbd8c3fb8872/docs/runbox-demo.gif
  17. known_issues:
  18. - "Needs Docker: on macOS install colima and the docker CLI (brew install colima docker); on Linux a running Docker daemon. The first start on macOS downloads the VM image and takes a few minutes."
  19. - "The Hermes data folder must be under your home folder on macOS (colima shares only that)."
  20. - "The agent may not always pick runbox on its own (the model chooses its tools). Ask it to use runbox."
  21. capabilities:
  22. provides_tools: [runbox]
  23. provides_hooks: [pre_tool_call, pre_llm_call]
  24. provides_middleware: []
  25. requires_env: []