skills.rest
OpenAEC-Foundation
OpenAEC-FoundationOFFICIAL
Explore all skills by this author →
GitHub

oa-tmux-patterns

Document tmux session structures and window naming for agent orchestration.

4|Updated Feb 26, 2026
Search Tags:#debugging#cli#tmux#window management#agent management#session structure
One-click install
npx skills add https://github.com/OpenAEC-Foundation/Open-Agents --skill oa-tmux-patterns
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: oa-tmux-patterns
Source: https://github.com/OpenAEC-Foundation/Open-Agents/tree/main/.claude/skills/oa-tmux-patterns
Command: npx skills add https://github.com/OpenAEC-Foundation/Open-Agents --skill oa-tmux-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a reference guide for the tmux patterns used within the oa-cli, helping users understand and debug agent window management, session structures, and capture-pane operations.

Core Features & Use Cases

  • Tmux Session Structure: Details the layout of the main 'oa' tmux session, including the dashboard, guardian, and individual agent windows.
  • Window Naming Conventions: Explains the standardized naming for agent windows (agent-{name}).
  • Key Tmux Operations: Lists essential tmux commands for session and window management, including creation, execution, capture, and killing.
  • Safety Patterns: Highlights security measures like shlex.split(), shlex.quote(), and index targeting to prevent command injection and ambiguity.
  • Session Lifecycle: Outlines the flow from starting a session to spawning agents and cleaning up.
  • Debugging Tips: Provides practical commands for checking session status, inspecting output, and attaching to agent windows.

Quick Start

Use the oa-tmux-patterns skill to understand how agent windows are named and managed within the 'oa' tmux session.

Frequently Asked Questions about oa-tmux-patterns

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

FAQPage Schema
How do I manage AI agent tmux sessions in a CLI environment?▼

Managing AI agent tmux sessions involves structuring a main tmux session with dashboard, guardian, and individual agent windows using standardized naming conventions like agent-{name} for reliable orchestration.

What is the recommended tmux window naming convention for agent orchestration?▼

The recommended tmux window naming convention for agent orchestration uses the format agent-{name} to ensure clear identification and prevent ambiguity when managing multiple AI agent windows.

How do I debug tmux capture-pane operations for agent windows?▼

Debugging tmux capture-pane operations requires checking session status, inspecting agent output, and attaching to specific agent windows using targeted tmux commands to verify execution flow.

What safety measures prevent command injection during tmux session management?▼

Safety measures for tmux session management include using shlex.split() and shlex.quote() for command parsing, alongside index targeting, to prevent command injection and ambiguity during agent execution.

What is the lifecycle flow of a tmux session for agent orchestration?▼

The tmux session lifecycle for agent orchestration flows from starting the main session, spawning individual agent windows, executing commands, capturing output, and cleaning up windows upon completion.

Can I use standard tmux commands to create and kill agent windows safely?▼

Standard tmux commands for creation, execution, capture, and killing are supported for agent window management, with safety patterns like shlex quoting applied to prevent command injection.

Related Skills

Explore More Software Engineering Skills→
mikeyobrienmikeyobrien
3.1k

tmux-terminal

Control tmux sessions to automate interactive terminal workflows.

Community
Intermediate
zhcndoczhcndoc

tmux

Send keystrokes and capture pane output in tmux sessions.

Official
Intermediate
karaabd23-cryptokaraabd23-crypto
1

tmux

Send keystrokes and capture pane output in tmux sessions.

Community
Intermediate
roach88roach88
2

subagent

Manage persistent tmux sessions for long-running background processes.

Community
Intermediate