What problem does it solve?
It helps coordinate starting, stopping, and hygienically refreshing agent-team tmux sessions without leaving teammates stuck with stale context or inconsistent state.
Core Features & Use Cases
- Unified lifecycle verbs: Use a single entry point (/atmux:team <verb> [args]) for start, stop, add, clear, cleanup, bootstrap, rotate-lead, and rotate-member.
- Safe, stateful operations: Maintains team config and state in .atmux/team.json and .atmux/state.db (SQLite), supporting resume after stop.
- Reliable context refresh: Clears or rotates member/lead context by sending the right control flow into the correct tmux panes and re-briefing them.
- Operations & maintenance: Prunes inbox/task artifacts and rotates logs to keep the workspace healthy for long-running teams.
- Scoped execution: Detects the correct team by walking up from the current project root for .atmux/team.json and targets only that team’s tmux session (atmux-<team-name>).
Quick Start
Run /atmux:team start from your project root to bring up the team tmux session and spawn all members with role briefs.