Tinfoil Container backend for Hermes Agent
A terminal backend plugin: Hermes' terminal, execute_code and file tools
run inside a Tinfoil Container, your own
image in an attested enclave.
hermes plugins install counterposition/tinfoil-hermes-provider/sandbox
hermes plugins enable tinfoil-sandbox
hermes config set terminal.tinfoil_container my-box
hermes config set terminal.backend tinfoil
Requirements, settings and limits are in the
repository README.
How it works
provider.pyregisters the backend nametinfoiland answers Hermes'
questions about it: where commands run, whether it is set up, what
hermes doctorshould show.environment.pyruns each command as
tinfoil ssh <container> -- <ssh options> bash -c <command>. The Tinfoil
CLI verifies the enclave's attestation and tunnels SSH over that verified
TLS connection. An SSH control socket under the system temp directory keeps
the connection open between commands.- The first connection also pins the SSH port. Without it the CLI logs a
port notice before every command, and that line would corrupt the output
Hermes' file tools parse. - A
pre_tool_callhook rewrites a leading~in file-tool paths to the
container's home, which Hermes would otherwise take from this machine. - The plugin has no Python dependencies and makes no network calls of its
own. It runs two programs you installed:tinfoilandssh.
README from the reviewed commit cae6859; it updates when the author re-pins.

counterposition