team

Manage atmux team lifecycle by starting, stopping, adding members, and refreshing context.

2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/geoyws/atmux --skill team-geoyws
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team
Source: https://github.com/geoyws/atmux/tree/main/plugins/atmux/skills/team
Command: npx skills add https://github.com/geoyws/atmux --skill team-geoyws

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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.

Frequently Asked Questions about team

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage agent orchestration across multiple tmux panes?

Agent orchestration across tmux panes is managed through a unified lifecycle entry point that starts, stops, and adds team members. It targets the correct tmux session by locating project configuration files and dispatching commands to the specific panes.

How do I refresh stale context for AI agents running in tmux?

To refresh stale context for AI agents in tmux, you can trigger a context rotation or clearing operation. This sends the correct control flow into the designated tmux panes and automatically re-briefs the agents to ensure consistent operational state.

Can I resume a stopped tmux team session without losing state?

Yes, you can resume a stopped tmux team session without losing state. The system maintains team configuration in a JSON file and operational state in a SQLite database, allowing you to safely stop and resume long-running agent workflows seamlessly.

What is the best way to rotate leads or onboard new agents into an existing tmux workflow?

The best way to rotate leads or onboard new agents is to use dedicated lifecycle verbs like add, rotate-lead, and rotate-member. These operations safely integrate new members by re-briefing them and updating the team state database without disrupting existing panes.

Does team lifecycle management require a specific project directory structure?

Yes, team lifecycle management requires a specific project directory structure. It needs an accessible configuration file within your project root to detect the team, though you can use environment variables to override the default directory and team name paths.

How do I clean up inbox and task artifacts for long-running agent teams?

You can clean up inbox and task artifacts for long-running agent teams by running the cleanup and clear lifecycle verbs. These operations prune accumulated workspace artifacts and rotate logs to maintain a healthy environment for ongoing agent orchestration.