agent-cli-tmux-supervision

Supervise parallel agent-cli Codex worktrees with tmux sessions.

232|10|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/mindroom-ai/mindroom --skill agent-cli-tmux-supervision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-cli-tmux-supervision
Source: https://github.com/mindroom-ai/mindroom/tree/main/.claude/skills/agent-cli-tmux-supervision
Command: npx skills add https://github.com/mindroom-ai/mindroom --skill agent-cli-tmux-supervision

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agent-cli, tmux, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing multiple parallel Codex worktrees through tmux, ensuring efficient supervision and progress tracking.

Core Features & Use Cases

  • Parallel Worktree Supervision: Launch and manage multiple agent-cli Codex worktrees simultaneously within a tmux session.
  • Progress Polling: Regularly check the progress of each worktree to ensure tasks are completed without interruption.
  • Review Loops: Implement robust review protocols for PRs, including current-context and fresh-context reviews.
  • Finalization and PR Sync Check: Confirm that all work is complete and PRs are correctly updated before finalization.

Quick Start

Launch a new worktree with agent-cli dev new <branch-name> --from origin/main --agent codex --tmux-session <session-name> --prompt-file <prompt-file> and use this skill to manage and review the worktree.

Frequently Asked Questions about agent-cli-tmux-supervision

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

FAQPage Schema
How do I manage parallel Codex worktrees in tmux?

Managing parallel Codex worktrees in tmux involves launching multiple agent-cli sessions and using a supervision skill to track progress, enforce review loops, and verify PR finalization across all active worktrees.

What is the best way to track agent-cli progress across multiple worktrees?

Tracking agent-cli progress across multiple worktrees is best handled by a supervision skill that polls each tmux session regularly, ensuring tasks complete without interruption and checking PR synchronization before finalization.

Do I need tmux to run agent-cli Codex worktrees?

Yes, you need tmux to run this specific supervision setup. The Skill requires both agent-cli and tmux as dependencies to coordinate multiple worktrees, manage parallel sessions, and monitor progress effectively.

How do I set up review loops for agent-cli PRs?

To set up review loops for agent-cli PRs, you use a supervision skill that implements current-context and fresh-context review protocols, ensuring code quality checks are completed before finalizing and syncing the pull request.

Can I launch a new Codex worktree from a specific branch using agent-cli?

Yes, you can launch a new Codex worktree from a specific branch using the agent-cli command, specifying the source branch, agent type, tmux session name, and prompt file to initialize the supervised worktree.

What does a PR sync check do for supervised worktrees?

A PR sync check for supervised worktrees confirms that all agent-cli tasks are complete and the pull request is correctly updated before finalization, preventing unsynchronized or incomplete code from being merged.