Tactus in a Nutshell

Sandboxing and Security

Tactus is built for running untrusted or semi-trusted agent code safely. The core idea is capability control:

Sandbox Defaults

In typical setups, procedures run in a Docker container with:

Configure sandbox behavior in .tactus/config.yml (or per-procedure via sidecar):

sandbox:
  enabled: true
  timeout: 3600
  network: "none"
  limits:
    memory: "2g"
    cpus: "2"

Trust Zones (Tool Types)

Not all tools run in the same place:

Secrets: Where to Put Them

Practical guidance:

local r = Host.call("host.ping", {value = 1})

Sidecar Files Are Trusted

{procedure}.tac.yml can include file paths and command configuration (e.g., MCP servers). Treat sidecars as trusted inputs.

Volume Mount Trust Boundaries

Default behavior: Current directory mounted to /workspace:rw

Trust model:

Safety with default mount:

Disable for untrusted procedures:

sandbox:
  mount_current_dir: false

Quick Checklist