How ossyrian/tau works
Tau is a Docker sandbox for the Pi coding agent. The main workflow is: a user starts a container through the host CLI, opens a Pi session, and the agent works in mounted workspaces; results persist in host-mounted state or are handed back through the share dropbox. Tau also provides workspace and session management, agent extensions and skills, subagents, and a gated GitHub shipping path. The README documents capabilities beyond the sampled source, so those links are shown only where the documented ownership is clear.
Main entry points: agent Pi session · tau Tau CLI · Dockerfile Docker container · subagent-sessions Subagent sessions
Components 22
Host orchestration
- Tau CLI
tau - Shell wrappers
tau.bash - Docker container
Dockerfile - Persistent host state
Agent runtime
- Pi session
pi-config/agent - Runtime awareness
pi-config/agent/extensions/tau-awareness.ts - Agent extensions
pi-config/agent/extensions - Tau skills
pi-config/agent/skills - Subagent sessions
pi-config/agent/extensions/subagent-sessions - Subagent registry
pi-config/agent/extensions/subagent-sessions/registry.ts - tmux sessions
pi-config/agent/extensions/subagent-sessions/tmux.ts
Workspace and delivery
- Project workspaces
workspace - Workspace tools
pi-config/agent/extensions/workspace-tools/index.ts - Share tools
pi-config/agent/extensions/share-tools/index.ts - Share dropbox
- Todo planning
pi-config/agent/extensions/todos.ts
Git shipping
- Git guard
pi-config/agent/extensions/git-guard.ts - Treehouse worktrees
- No-mistakes gate
Other components
- User
- GitHub
- AWS services
Connections 26
- User → Tau CLI: runs commands
- User → Shell wrappers: sources wrapper
- Shell wrappers → Tau CLI: forwards commands
- Tau CLI → Docker container: manages container
- Tau CLI → Persistent host state: mounts and manages
- Docker container → Pi session: runs
- Persistent host state → Pi session: persists mounted data
- Pi session → Runtime awareness: loads extension
- Runtime awareness → Pi session: adds prompt context
- Pi session → Agent extensions: loads extensions
- Pi session → Tau skills: loads skills
- Pi session → Subagent sessions: registers controls
- Subagent sessions → tmux sessions: creates and manages
- Subagent sessions → Subagent registry: reads and updates
- Tau CLI → Project workspaces: manages workspaces
- Pi session → Workspace tools: invokes tools
- Workspace tools → Project workspaces: lists and resolves
- Pi session → Todo planning: plans work
- Pi session → Share tools: invokes tools
- Share tools → Share dropbox: copies and lists files
- Share dropbox → Persistent host state: bind-mounts to host
- Pi session → Git guard: checks bash commands
- Pi session → Treehouse worktrees: uses worktrees
- Pi session → No-mistakes gate: drives gated runs
- No-mistakes gate → GitHub: pushes and opens PRs
- Docker container → AWS services: injects scoped credentials