tmux

Create tmux panes and run commands via split-pane.sh with deterministic layouts.

8|5|Updated Jan 20, 2025
One-click install
npx skills add https://github.com/Perseus/pko-tools --skill tmux-perseus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tmux
Source: https://github.com/Perseus/pko-tools/tree/main/.claude/skills/tmux
Command: npx skills add https://github.com/Perseus/pko-tools --skill tmux-perseus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Coordinating tmux pane creation, commands, and focus across multiple panes can be error-prone and unstable. This skill enforces a safe, repeatable workflow by routing all pane creation through scripts/split-pane.sh and by consistently targeting the calling pane, reducing layout drift and misplaced focus.

Core Features & Use Cases

  • Deterministic pane creation: rely on split-pane.sh to create new panes or windows with predictable layouts, minimizing manual adjustment.
  • Safe, interactive workflows: run REPLs, servers, and debuggers in dedicated panes without losing context or accidentally disrupting other panes.
  • Helper tooling and guardrails: leverage included scripts for common tasks (e.g., code review, waiting for output) to maintain a stable tmux session during complex tasks.

Quick Start

Load this skill before performing any tmux operation and always create panes via scripts/split-pane.sh.

Frequently Asked Questions about tmux

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

FAQPage Schema
How do I automate tmux pane creation without layout drift?

Automate tmux pane creation by routing all splits through a dedicated script like split-pane.sh. This ensures predictable layouts and consistent focus on the calling pane, preventing manual adjustment errors.

What is the best way to run an interactive server in a dedicated tmux pane?

Running an interactive server in a dedicated tmux pane requires deterministic pane creation. Using enforced layout rules and targeted scripts maintains session stability and prevents disrupting other panes.

Can I run REPLs and debuggers in tmux without losing context?

Yes, running REPLs and debuggers in tmux without losing context is possible. Delegating pane creation to scripts enforces safe, repeatable workflows and stable layouts during complex interactive tasks.

Why does my tmux split-pane command cause misplaced focus?

Tmux split-pane commands cause misplaced focus when pane creation is not properly targeted. Consistently targeting the calling pane and using dedicated helper scripts eliminates layout drift and focus errors.

Does this tmux workflow require manual pane management?

No, this tmux workflow does not require manual pane management. It includes helper tooling and guardrails that enforce layout rules and delegate pane creation to scripts for safe, predictable operation.