# Tinfoil Container: Hermes Agent plugin

> A tinfoil terminal backend: Hermes' terminal, file and code tools run inside your own Tinfoil Container, an attested enclave, reached over the Tinfoil CLI's attested SSH tunnel.

Canonical: https://hermeswatcher.com/plugins/tinfoil-sandbox  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/tinfoil-sandbox  
Last updated in catalog: 2026-11-14

A tinfoil terminal backend: Hermes' terminal, file and code tools run inside your own Tinfoil Container, an attested enclave, reached over the Tinfoil CLI's attested SSH tunnel. Select it with terminal.backend: tinfoil and terminal.tinfoil_container. Needs a Tinfoil organization with Containers enabled; the public template https://github.com/counterposition/hermes-tinfoil-workspace sets up a suitable workspace. Dangerous-command approval stays on, and the plugin never creates, starts, stops or bills containers.

## Good to know before installing

Every tool call runs the user's installed tinfoil CLI (tinfoil ssh) and OpenSSH client as subprocesses; the CLI contacts Tinfoil's control plane to look the container up, then the enclave. The plugin passes TINFOIL_API_KEY, read through Hermes' secret scope, to the CLI as the tunnel key, and the admin key when set (TINFOIL_ADMIN_KEY, or an admin_ key in TINFOIL_API_KEY, which the CLI also accepts); beyond those the CLI and ssh get only an allowlist of Hermes' environment (PATH, home, temp, user, locale, SSH agent socket, certificate and HTTP proxy settings, the CLI's TINFOIL_CONTROLPLANE_URL and TINFOIL_CONFIG, Windows system directories). It never reads the CLI's saved login, and strips TINFOIL_API_KEY, TINFOIL_TUNNEL_API_KEY and TINFOIL_ADMIN_KEY from the environment of commands the agent runs. An SSH control socket under the system temp directory (hermes-tinfoil/) keeps the verified connection open for five idle minutes. A pre_tool_call hook rewrites a leading ~ in the path argument of read_file, write_file, patch and search_files to the container's home directory, only while terminal.backend is tinfoil, because Hermes otherwise expands it to the host's home. No telemetry.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install tinfoil-sandbox
```

2. Said no? Turn it on later:

```bash
hermes plugins enable tinfoil-sandbox
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Security & privacy
- Maintained by: counterposition (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.23.1`
- Version: 0.1.0
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/tinfoil-sandbox)
- [Source code](https://github.com/counterposition/tinfoil-hermes-provider#run-tools-in-a-tinfoil-container)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
