TypingMindTypingMindThe best frontend for AI
Tui Debug In Pane logo

Tui Debug In Pane

CommunityPopular
mikeyobrien
tui-debug-in-pane

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.

Overview

Publishermikeyobrien
Repositoryralph-orchestrator
Skill nametui-debug-in-pane
Stars
3.2K
Forks
299
Bundled files
Instructions only
LicenseMIT
Links
Skill sourceRepository
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by mikeyobrien on GitHub. Read the source before you install it.

Installation

Install the Tui Debug In Pane AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/tui-debug-in-pane
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/mikeyobrien/ralph-orchestrator.git /tmp/ralph-orchestrator
mkdir -p .claude/skills
cp -r /tmp/ralph-orchestrator/.claude/skills/tui-debug-in-pane .claude/skills/tui-debug-in-pane
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Tui Debug In Pane in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Tui Debug In Pane on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Tui Debug In Pane is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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.

Frequently asked questions

What does the Tui Debug In Pane AI skill do?

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.

Why use Tui Debug In Pane on TypingMind?

Because you install it once and use it with any model. Tui Debug In Pane is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Tui Debug In Pane in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/tui-debug-in-pane. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Tui Debug In Pane?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Tui Debug In Pane?

As many as you like. As long as a model supports skills, you can use Tui Debug In Pane with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Tui Debug In Pane AI skill free?

Yes. It is published on GitHub by mikeyobrien under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Related AI Skills

View all
openclaw logo

Claw Score

openclaw
OrganizationPopular

Audit or refresh OpenClaw maturity scorecard docs from root taxonomy, maturity scores, and QA evidence artifacts without using maintainer discrawl data or committed inventory reports.

82.2K
391K
51 files
View
openclaw logo

Clawsweeper

openclaw
OrganizationPopular

Use for all ClawSweeper work: OpenClaw issue/PR sweep reports, repair jobs, cloud fix PRs, @clawsweeper maintainer mention commands, trusted ClawSweeper-reviewed autofix/automerge, GitHub Actions…

82.2K
391K
1 files
View
openclaw logo

Control Ui E2e

openclaw
OrganizationPopular

Use when designing, testing, fixing, or extending the OpenClaw Control UI GUI, including UI stress-test galleries with feedback inputs, Vitest + Playwright end-to-end checks, mocked Gateway flows,…

82.2K
391K
1 files
View
openclaw logo

Deslop

openclaw
OrganizationPopular

Diff-scoped AI-slop cleanup pass: strip comment slop, defensive-check slop, type-laundering, and style drift from the current branch diff before autoreview.

82.2K
391K
Instructions
View

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇