Skip to content

The agent that grows with you

plugin-catalog: add bubblewrap (official bwrap terminal backend, Linux)

Teknium7dcb1b4cfdb8
diff --git a/plugin-catalog/bubblewrap.yaml b/plugin-catalog/bubblewrap.yaml
new file mode 100644
index 00000000000..43269bfdffc
--- /dev/null
+++ b/plugin-catalog/bubblewrap.yaml
@@ -0,0 +1,27 @@
+name: bubblewrap
+repo: https://github.com/NousResearch/hermes-official-plugins
+sha: e5d447174f7d9d641aeb71086b23e35ebff36072
+subdir: bubblewrap
+description: 'Bubblewrap terminal backend for Linux: every terminal and execute_code command runs in its own bwrap
+ sandbox on this machine at the host''s own paths, with a read-only root, a writable working directory (per
+ profile: restricted, workspace or network), SSH keys, cloud credentials and the Hermes home hidden, private temp
+ and process directories, agent and docker sockets masked, and per-command memory, CPU and process limits
+ (`hermes config set terminal.backend bubblewrap`). Disclosure — no Python dependencies and no network calls of its
+ own: it runs your commands through the `bwrap` and `prlimit` binaries you install (bubblewrap, util-linux), and
+ under the default `network` profile those commands share the host network. It reads no credentials. File tools
+ (read_file, write_file, patch, search_files) still run on the host and are not confined, and because the working
+ directory is a real host directory Hermes keeps its dangerous-command prompts, as for the local backend.'
+maintainer: NousResearch
+tier: official
+category: tools
+requires_hermes: ">=0.22.2"
+version: "1.0.0"
+image: https://raw.githubusercontent.com/NousResearch/hermes-official-plugins/e5d447174f7d9d641aeb71086b23e35ebff36072/assets/bubblewrap.jpg
+docs_url: https://github.com/NousResearch/hermes-official-plugins/tree/main/bubblewrap
+platforms:
+ - linux
+capabilities:
+ provides_tools: []
+ provides_hooks: []
+ provides_middleware: []
+ requires_env: []