Rooms and collaboration

Status: Current for core room commands, planned for room-agile extensions.

Rooms are durable collaboration timelines. They separate transport state, viewer state, participant identity, messages, and tasks.

Basic room flow

foxctl room create alpha --title "Agent Alpha"

foxctl room join alpha agent-a --role lead

foxctl room send alpha "Review the retry branch in client.ts"

foxctl room inbox alpha --actor agent-a

foxctl room status alpha

foxctl room task add alpha --title "Refactor retry path"

foxctl room task claim alpha --id <task-id>

foxctl room task block alpha --id <task-id> --reason "waiting on benchmark data"

foxctl room task complete alpha --id <task-id> --notes "Retry ladder flattened"

foxctl room relay alpha --backend tmux

foxctl room loop alpha --backend zellij --session alpha-room

foxctl tmux create --session foxctl-collab --panes 3 --attach

foxctl tmux send agent-b "Review internal/storage/mailbox/store.go for lease races." --sender agent-a

Current: room messages, inbox, status, tasks, tmux/zellij relay surfaces.
Planned: room-agile milestone enforcement, evidence-lane policy, and workpack templates from docs/plans/features/room-*.
Room-agile commands exist as a skill protocol surface, but milestone evidence policy must be described as guidance unless exit-policy enforcement is explicitly enabled.

foxctl room epic start <room-id> "Room agile protocol" --goal "..." --owner human-a

foxctl room milestone start <room-id> <epic-id> --proposal <proposal-id>

foxctl room story validate <room-id> <story-id> review pass "..."