Agent skill

Tui Debug In Pane

by mikeyobrien in mikeyobrien/ralph-orchestrator

A skill your agent uses when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.

MITAuto-check passedAgent Workflows

Install Tui Debug In Pane

skills CLI
$ npx skills add mikeyobrien/ralph-orchestrator --skill tui-debug-in-pane -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mikeyobrien/ralph-orchestrator tui-debug-in-pane --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mikeyobrien/ralph-orchestrator.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/tui-debug-in-pane .claude/skills/tui-debug-in-pane && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tui-debug-in-pane
GitHub stars
3.2k
Token cost
~825 tokens
SKILL.md length
295 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.

  • Works in 6 steps: Create the Split Pane → Fix Shell Environment → Clean Up Before Running → …
  • You need to reproduce
  • SKILL.md covers When to Use, Quick Reference, Procedure and Common Mistakes
  • Calls git

What it does

Tui Debug In Pane is an agent skill from mikeyobrien/ralph-orchestrator. Use when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. It works with tmux. The repository describes itself as: An improved implementation of the Ralph Wiggum technique for autonomous AI agent orchestration. The licence is MIT.

When your agent uses it

  • You need to reproduce
  • Debug TUI rendering issues (garbled output
  • Broken streaming
  • Layout corruption) by running ralph in a tmux split pane and capturing live output

Example prompts

  • “/tui-debug-in-pane”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Create the Split Pane
  2. Fix Shell Environment
  3. Clean Up Before Running
  4. Launch Ralph
  5. Capture and Analyze
  6. Clean Up

What it can do on your machine

Read from SKILL.md and the folder at commit edc2b32. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tui Debug In Pane loads about 825 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 295 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~825

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mikeyobrien/ralph-orchestrator at commit edc2b32, republished under its MIT licence (© mikeyobrien). 295 words, ~825 tokens.

Download SKILL.mdSave it as .claude/skills/tui-debug-in-pane/SKILL.md (or your agent's skills folder).
name
tui-debug-in-pane
description
Use when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.
metadata.internal
true

tui-debug-in-pane

Debug TUI rendering bugs by launching ralph in a tmux split pane and capturing live output. The split keeps your main pane free for inspection commands.

When to Use

  • Reproducing garbled or corrupted TUI output from a specific provider
  • Investigating streaming rendering issues that only appear live
  • Capturing TUI state for bug reports or diagnostics

Quick Reference

TaskCommand
Identify current panetmux display-message -p '#{session_name}:#{window_index}.#{pane_index}'
Create split panetmux split-window -h -t SESSION:WINDOW -c /path/to/repo
List panestmux list-panes -t SESSION:WINDOW
Fix shell in panetmux send-keys -t PANE "exec /path/to/fish" Enter
Send commandtmux send-keys -t PANE "command" Enter
Capture outputtmux capture-pane -t PANE -p -S -60
Quit TUItmux send-keys -t PANE q
Force stoptmux send-keys -t PANE C-c
Kill split panetmux kill-pane -t PANE

Procedure

1. Create the Split Pane
bash
tmux display-message -p '#{session_name}:#{window_index}.#{pane_index}'
tmux split-window -h -t SESSION:WINDOW -c /path/to/repo
tmux list-panes -t SESSION:WINDOW
2. Fix Shell Environment

Split panes inherit the tmux server's default shell (bash), not the parent's. Tools like pi need fish (mise/Node).

bash
tmux send-keys -t PANE "exec /nix/store/km9w9r1p4nl92y5fp4vfwsjymjig4axl-fish-3.7.1/bin/fish" Enter
tmux send-keys -t PANE "which pi && pi --version" Enter
3. Clean Up Before Running
bash
rm -f .ralph/loop.lock
git worktree prune
4. Launch Ralph
bash
# Prefer release binary (faster startup)
tmux send-keys -t PANE "target/release/ralph run -c CONFIG.yml -p 'prompt' --max-iterations N" Enter

# Or with cargo (must specify --bin for this workspace)
tmux send-keys -t PANE "cargo run --bin ralph -- run -c CONFIG.yml -p 'prompt' --max-iterations N" Enter
5. Capture and Analyze
bash
sleep 20  # Pi/Kiro take 15-30s to start streaming
tmux capture-pane -t PANE -p -S -60
ls -lt .ralph/diagnostics/logs/ | head -5
6. Clean Up
bash
tmux send-keys -t PANE q
tmux send-keys -t PANE C-c
tmux kill-pane -t PANE

Common Mistakes

  • Shell mismatch: Split panes get bash by default. If tools fail with "command not found", switch to fish with exec /path/to/fish.
  • Stale loop lock: If .ralph/loop.lock exists, ralph spawns worktree loops instead of running normally. Always delete it first.
  • Wrong backend in TUI header: Without cli.backend: pi in the config, ralph uses claude regardless of hat settings.
  • Missing hat name field: HatConfig requires name; omitting it causes a config parse error.
  • Premature capture: Pi and Kiro take 15-30s before streaming text appears. Capture too early and you see an empty content area.
  • Ghost keystrokes: If the TUI already exited, pressing q prepends it to your next command. Check if the TUI is still running before sending quit keys.

© mikeyobrien, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/tui-debug-in-pane of mikeyobrien/ralph-orchestrator.

Open the folder on GitHubat commit edc2b32

Compare with similar skills

Tui Debug In Pane next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tui Debug In Pane compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tui Debug In Pane this skillmikeyobrien/ralph-orchestrator3.2k—~825Automated safety check: PassMIT
CodeGraph Agent Evalcolbymchenry/codegraph74k—~950Automated safety check: PassMIT
Agent of Empires Session Manageragent-of-empires/agent-of-empires3.3k—~2.5kAutomated safety check: PassMIT
Agent Deckasheshgoplani/agent-deck1.1k—~1.8kAutomated safety check: PassMIT
Agent of Empires Session Manageragent-of-empires/agent-of-empires3.3k—~2.1kAutomated safety check: PassMIT
Clawteamwin4r/ClawTeam-OpenClaw1.5k—~3.1kAutomated safety check: PassMIT

Similar skills

  • CodeGraph Agent Eval

    colbymchenry/codegraph

    Benchmarks how much CodeGraph helps a coding agent on a real repository, comparing runs with and without it for a chosen local or published version.

    74k GitHub stars~950 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent of Empires Session Manager

    agent-of-empires/agent-of-empires

    Launches, monitors and organizes AI coding agent sessions such as Claude Code or Codex inside tmux, tracking status, capturing output and managing git worktrees for parallel branches.

    3.3k GitHub stars~2.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent Deck

    asheshgoplani/agent-deck

    agent-deck, the terminal session manager for AI coding agents.

    1.1k GitHub stars~1.8k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Agent of Empires Session Manager

    agent-of-empires/agent-of-empires

    Starts, monitors and organizes coding agent sessions that run in tmux through the aoe command, including groups, profiles and worktree-based parallel work.

    3.3k GitHub stars~2.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Clawteam

    win4r/ClawTeam-OpenClaw

    Multi-agent swarm orchestration. An agent skill from win4r/ClawTeam-OpenClaw.

    1.5k GitHub stars~3.1k tokensUpdated 3 mo ago
    Agent WorkflowsAuto-check passed
  • Huashu Agent Swarm

    alchaincyf/huashu-skills

    多Agent蜂群并行协作,纯git自组织,适合大型项目开发。当用户提到"蜂群模式"、"多agent"、"并行开发"、"agent swarm"时使用。

    1.7k GitHub stars~576 tokensUpdated 17 days ago
    Agent WorkflowsAuto-check passed

More from mikeyobrien/ralph-orchestrator

All 16 skills in this repo
  • Ralph Docs

    mikeyobrien/ralph-orchestrator

    Introspect, explain, and improve Ralph Orchestrator using its published llms.txt doc map.

    3.2k GitHub stars~1.5k tokensUpdated 5 days ago
    Auto-check passed
  • Evaluate Presets

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when testing Ralph's hat collection presets, validating preset configurations, or auditing the preset library for bugs and UX issues.

    3.2k GitHub stars~1.8k tokensUpdated 5 days ago
    Auto-check passed
  • PR Demo

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when creating animated demos (GIFs) for pull requests or documentation.

    3.2k GitHub stars~1.3k tokensUpdated 5 days ago
    Auto-check passed
  • Release Bump

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when bumping ralph-orchestrator version for a new release, after fixes are committed and ready to publish

    3.2k GitHub stars~583 tokensUpdated 5 days ago
    Auto-check passed
  • Review PR

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when asked to review a PR, run a code review loop, or invoke the ralph reviewer against a pull request number or GitHub URL

    3.2k GitHub stars~589 tokensUpdated 5 days ago
    Auto-check passed
  • Ralph Hats

    mikeyobrien/ralph-orchestrator

    Create, inspect, validate, explain, and improve Ralph hat collections.

    3.2k GitHub stars~691 tokensUpdated 5 days ago
    Auto-check passed

Works with

Categories

Questions about Tui Debug In Pane

What does Tui Debug In Pane do?

A skill your agent uses when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output. Tui Debug In Pane is an agent skill from mikeyobrien/ralph-orchestrator. Use when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.

When should I use Tui Debug In Pane?

Tui Debug In Pane fits situations like: you need to reproduce; debug TUI rendering issues (garbled output; broken streaming; layout corruption) by running ralph in a tmux split pane and capturing live output.

How do I install Tui Debug In Pane in Claude Code?

Run `npx skills add mikeyobrien/ralph-orchestrator --skill tui-debug-in-pane -a claude-code`. Or copy the skill folder (.claude/skills/tui-debug-in-pane in mikeyobrien/ralph-orchestrator) into .claude/skills/tui-debug-in-pane in your project. Claude Code loads it when a task matches its description.

How do I install Tui Debug In Pane in Codex?

Run `npx skills add mikeyobrien/ralph-orchestrator --skill tui-debug-in-pane -a codex`. Or copy the skill folder (.claude/skills/tui-debug-in-pane in mikeyobrien/ralph-orchestrator) into .agents/skills/tui-debug-in-pane in your project. Codex loads it when a task matches its description.

Can I use Tui Debug In Pane in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mikeyobrien/ralph-orchestrator --skill tui-debug-in-pane -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tui-debug-in-pane, .gemini/skills/tui-debug-in-pane, .github/skills/tui-debug-in-pane and .opencode/skills/tui-debug-in-pane in your project.

What does Tui Debug In Pane need to run?

Going by SKILL.md and its folder, Tui Debug In Pane needs the command-line tools its instructions call (git).

Does Tui Debug In Pane access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Tui Debug In Pane safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tui Debug In Pane use?

Tui Debug In Pane is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tui Debug In Pane use?

About 825 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tui Debug In Pane?

Skills that share tags, products or a category with Tui Debug In Pane: CodeGraph Agent Eval (colbymchenry/codegraph, 74k stars), Agent of Empires Session Manager (agent-of-empires/agent-of-empires, 3.3k stars), Agent Deck (asheshgoplani/agent-deck, 1.1k stars) and Agent of Empires Session Manager (agent-of-empires/agent-of-empires, 3.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tui Debug In Pane?

mikeyobrien (a GitHub user) maintains it in mikeyobrien/ralph-orchestrator, which has 3,168 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.

Source: mikeyobrien/ralph-orchestrator on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.