Home

Welcome to the agent-box wiki!

This wiki holds the docs that outlive any single change: the design rules behind the module, and notes for people hacking on agent-box itself. Repo conventions live in AGENTS.md at the repo root.

Design

How the pieces are meant to be used:

• Users-vs-Sessions — when to add a Linux user and when to add a session, and why a session is not a security boundary.

Maintainer docs

Notes for people hacking on agent-box itself (not needed to use the template):

• Development — CI behavior and the generated-module check.

What is NOT here

• Host-specific config — PATH, git identity, token paths, Caddy vhosts, and the migration history of one box. These describe a deployment, not the template, so they belong to that host's own config repo. The maintainer's box keeps them in a private repo.
• Live, in-flight state — unresolved work stays in a local, un-committed SESSION-CONTINUITY.md on the maintainer's box. It goes stale too fast to be worth publishing.