[01]
Shipped
Sandbox Execution
Container-based execution with full lifecycle management. Agents run in isolated containers (Docker or Podman, auto-detected) that start and stop on demand — no pre-built images, no persistent daemons required.
$ agenticbox run hermes
[sandbox] detecting runtime... docker
[sandbox] pulling base image "agent-runtime:slim"
[sandbox] container a8f3c1 created
[sandbox] container started — cgroup: cpu=2cores mem=1G
[agent] stdio relay established (PTY)
[agent] running... session: 0x7e2a
[sandbox] container a8f3c1 stopped on exit
[sandbox] container removed — audit log written
[02]
Shipped
Scoped Permissions
Per-agent allow/deny: terminal, filesystem, browser, network.
ALLOWED terminal.exec
ALLOWED fs.read /data
BLOCKED fs.write /prod
BLOCKED net.outbound
evaluated by PolicyEngine
[03]
Shipped
Filesystem Governance
Path resolution guards prevent escapes via symlinks and ../.
> resolve "/data/../etc/passwd"
canonicalize → /etc/passwd
DENIED root not in allowed
roots: /data /tmp/agent
[04]
Shipped
Agent Packages
Run agents like Docker containers: agenticbox run hermes. TOML manifests — shareable, forkable.
[agent]
name = "hermes"
image = "agent-runtime:slim"
[permissions]
terminal = true fs = ["/data:ro"] net = "off"
[image.setup]
commands = ["pip install hermes-agent"]
[05]
Shipped
Session Persistence
SQLite-backed session management. Model config, permissions, and status survive restarts.
sqlite: sessions.db
● 0x7e2a running
● 0x3b1c paused
restored on daemon boot
[06]
Shipped
Desktop Console
Tauri desktop UI (no Electron). Manage agents, view sessions, monitor resources.
tauri://console
▎ agents: 3 active
▎ cpu: 18% mem: 412M
native · cross-platform