[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DD7REVCFCQGZ0RZETCGS2G":3,"skill-same:01M7DD7REVCFCQGZ0RZETCGS2G":45},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":44},"01M7DD7REVCFCQGZ0RZETCGS2G","tui-debug-in-pane",null,"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.","flaviomartil\u002Fralph-jev-gauntlet","flaviomartil","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F60192455?v=4","01M7DCWCHAAEJPMG1QM8T0ZN9F","Flávio Martil","01M7DD6F8GT2RSS93A6HJ9DC0H",0,"MIT","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftui-debug-in-pane\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: tui-debug-in-pane\ndescription: 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.\nmetadata:\n  internal: true\n---\n\n# tui-debug-in-pane\n\nDebug 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.\n\n## When to Use\n\n- Reproducing garbled or corrupted TUI output from a specific provider\n- Investigating streaming rendering issues that only appear live\n- Capturing TUI state for bug reports or diagnostics\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Identify current pane | `tmux display-message -p '#{session_name}:#{window_index}.#{pane_index}'` |\n| Create split pane | `tmux split-window -h -t SESSION:WINDOW -c \u002Fpath\u002Fto\u002Frepo` |\n| List panes | `tmux list-panes -t SESSION:WINDOW` |\n| Fix shell in pane | `tmux send-keys -t PANE \"exec \u002Fpath\u002Fto\u002Ffish\" Enter` |\n| Send command | `tmux send-keys -t PANE \"command\" Enter` |\n| Capture output | `tmux capture-pane -t PANE -p -S -60` |\n| Quit TUI | `tmux send-keys -t PANE q` |\n| Force stop | `tmux send-keys -t PANE C-c` |\n| Kill split pane | `tmux kill-pane -t PANE` |\n\n## Procedure\n\n### 1. Create the Split Pane\n\n```bash\ntmux display-message -p '#{session_name}:#{window_index}.#{pane_index}'\ntmux split-window -h -t SESSION:WINDOW -c \u002Fpath\u002Fto\u002Frepo\ntmux list-panes -t SESSION:WINDOW\n```\n\n### 2. Fix Shell Environment\n\nSplit panes inherit the tmux server's default shell (bash), not the parent's. Tools like `pi` need fish (mise\u002FNode).\n\n```bash\ntmux send-keys -t PANE \"exec \u002Fnix\u002Fstore\u002Fkm9w9r1p4nl92y5fp4vfwsjymjig4axl-fish-3.7.1\u002Fbin\u002Ffish\" Enter\ntmux send-keys -t PANE \"which pi && pi --version\" Enter\n```\n\n### 3. Clean Up Before Running\n\n```bash\nrm -f .ralph\u002Floop.lock\ngit worktree prune\n```\n\n### 4. Launch Ralph\n\n```bash\n# Prefer release binary (faster startup)\ntmux send-keys -t PANE \"target\u002Frelease\u002Fralph run -c CONFIG.yml -p 'prompt' --max-iterations N\" Enter\n\n# Or with cargo (must specify --bin for this workspace)\ntmux send-keys -t PANE \"cargo run --bin ralph -- run -c CONFIG.yml -p 'prompt' --max-iterations N\" Enter\n```\n\n### 5. Capture and Analyze\n\n```bash\nsleep 20  # Pi\u002FKiro take 15-30s to start streaming\ntmux capture-pane -t PANE -p -S -60\nls -lt .ralph\u002Fdiagnostics\u002Flogs\u002F | head -5\n```\n\n### 6. Clean Up\n\n```bash\ntmux send-keys -t PANE q\ntmux send-keys -t PANE C-c\ntmux kill-pane -t PANE\n```\n\n## Common Mistakes\n\n- **Shell mismatch**: Split panes get bash by default. If tools fail with \"command not found\", switch to fish with `exec \u002Fpath\u002Fto\u002Ffish`.\n- **Stale loop lock**: If `.ralph\u002Floop.lock` exists, ralph spawns worktree loops instead of running normally. Always delete it first.\n- **Wrong backend in TUI header**: Without `cli.backend: pi` in the config, ralph uses claude regardless of hat settings.\n- **Missing hat `name` field**: HatConfig requires `name`; omitting it causes a config parse error.\n- **Premature capture**: Pi and Kiro take 15-30s before streaming text appears. Capture too early and you see an empty content area.\n- **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.\n","# tui-debug-in-pane\n\nDebug 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.\n\n## When to Use\n\n- Reproducing garbled or corrupted TUI output from a specific provider\n- Investigating streaming rendering issues that only appear live\n- Capturing TUI state for bug reports or diagnostics\n\n## Quick Reference\n\n| Task | Command |\n|------|---------|\n| Identify current pane | `tmux display-message -p '#{session_name}:#{window_index}.#{pane_index}'` |\n| Create split pane | `tmux split-window -h -t SESSION:WINDOW -c \u002Fpath\u002Fto\u002Frepo` |\n| List panes | `tmux list-panes -t SESSION:WINDOW` |\n| Fix shell in pane | `tmux send-keys -t PANE \"exec \u002Fpath\u002Fto\u002Ffish\" Enter` |\n| Send command | `tmux send-keys -t PANE \"command\" Enter` |\n| Capture output | `tmux capture-pane -t PANE -p -S -60` |\n| Quit TUI | `tmux send-keys -t PANE q` |\n| Force stop | `tmux send-keys -t PANE C-c` |\n| Kill split pane | `tmux kill-pane -t PANE` |\n\n## Procedure\n\n### 1. Create the Split Pane\n\n```bash\ntmux display-message -p '#{session_name}:#{window_index}.#{pane_index}'\ntmux split-window -h -t SESSION:WINDOW -c \u002Fpath\u002Fto\u002Frepo\ntmux list-panes -t SESSION:WINDOW\n```\n\n### 2. Fix Shell Environment\n\nSplit panes inherit the tmux server's default shell (bash), not the parent's. Tools like `pi` need fish (mise\u002FNode).\n\n```bash\ntmux send-keys -t PANE \"exec \u002Fnix\u002Fstore\u002Fkm9w9r1p4nl92y5fp4vfwsjymjig4axl-fish-3.7.1\u002Fbin\u002Ffish\" Enter\ntmux send-keys -t PANE \"which pi && pi --version\" Enter\n```\n\n### 3. Clean Up Before Running\n\n```bash\nrm -f .ralph\u002Floop.lock\ngit worktree prune\n```\n\n### 4. Launch Ralph\n\n```bash\n# Prefer release binary (faster startup)\ntmux send-keys -t PANE \"target\u002Frelease\u002Fralph run -c CONFIG.yml -p 'prompt' --max-iterations N\" Enter\n\n# Or with cargo (must specify --bin for this workspace)\ntmux send-keys -t PANE \"cargo run --bin ralph -- run -c CONFIG.yml -p 'prompt' --max-iterations N\" Enter\n```\n\n### 5. Capture and Analyze\n\n```bash\nsleep 20  # Pi\u002FKiro take 15-30s to start streaming\ntmux capture-pane -t PANE -p -S -60\nls -lt .ralph\u002Fdiagnostics\u002Flogs\u002F | head -5\n```\n\n### 6. Clean Up\n\n```bash\ntmux send-keys -t PANE q\ntmux send-keys -t PANE C-c\ntmux kill-pane -t PANE\n```\n\n## Common Mistakes\n\n- **Shell mismatch**: Split panes get bash by default. If tools fail with \"command not found\", switch to fish with `exec \u002Fpath\u002Fto\u002Ffish`.\n- **Stale loop lock**: If `.ralph\u002Floop.lock` exists, ralph spawns worktree loops instead of running normally. Always delete it first.\n- **Wrong backend in TUI header**: Without `cli.backend: pi` in the config, ralph uses claude regardless of hat settings.\n- **Missing hat `name` field**: HatConfig requires `name`; omitting it causes a config parse error.\n- **Premature capture**: Pi and Kiro take 15-30s before streaming text appears. Capture too early and you see an empty content area.\n- **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.\n",{"name":5,"metadata":24,"description":7},{"internal":25},true,"main","cb944e6ea65c835dbf3944644a4675e9997b1bba",".claude\u002Fskills\u002Ftui-debug-in-pane","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet","https:\u002F\u002Fgithub.com\u002Fflaviomartil","2026-09-26 07:24:03",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":25},[34,37,40],{"tool":35,"command":36},"npx","npx skills add flaviomartil\u002Fralph-jev-gauntlet --skill tui-debug-in-pane",{"tool":38,"command":39},"bunx","bunx skills add flaviomartil\u002Fralph-jev-gauntlet --skill tui-debug-in-pane",{"tool":41,"command":42},"pnpm","pnpm dlx skills add flaviomartil\u002Fralph-jev-gauntlet --skill tui-debug-in-pane","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftui-debug-in-pane\u002FSKILL.md",[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7DD8BH0W32V5DBQK4QBQCJS","ralph-loop","Run, monitor, resume, merge, and debug Ralph loops. Use this skill whenever the user asks to operate `ralph run` or `ralph loops`, inspect loop state, recover suspended loops, analyze diagnostics, or unblock merge queue issues.","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002Fskills\u002Fralph-loop\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7DD8801CTT8E26GYRQ7GM10","ralph-hats","Create, inspect, validate, explain, and improve Ralph hat collections. Use this skill whenever the user asks to make or refine a `.ralph\u002Fhats\u002F*.yml` workflow, debug hat routing, explain event topology, or tune a multi-hat Ralph run.","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002Fskills\u002Fralph-hats\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7DD81XVTQF1HT7WQ5QE1WBD","ralph-docs","Introspect, explain, and improve ralph-jev-gauntlet using the documentation shipped in its repository. Use this skill whenever the user asks questions about Ralph's behavior, wants to understand how a Ralph internal works (event loop, gauntlet gate, judge evidence, Jev hooks, parallel loops, configuration), debug an unfamiliar failure mode, or propose a code change to the ralph-jev-gauntlet repo. The skill teaches the agent to answer from the repo's docs and source before guessing, and to scope improvements through the documented architecture rather than the local checkout alone.","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002Fskills\u002Fralph-docs\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7DD80B7K22YSHNV3ZE8B7E9","complex-test-skill","A directory-style test skill for smoke testing","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002Fcrates\u002Fralph-core\u002Ftests\u002Ffixtures\u002Fskills\u002Fcomplex-test-skill\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7DD7VVK9GW5J8MAN5365SG8","tui-validate","Validates Terminal User Interface (TUI) output using freeze for screenshot capture and LLM-as-judge for semantic validation. Supports both visual (PNG\u002FSVG) and text-based validation modes.","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftui-validate\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7DD7P15YQG647M7WHNV9ERQ","tmux-terminal","Interactive terminal control via tmux for TUI apps, prompts, and long-running CLI workflows.","https:\u002F\u002Fgithub.com\u002Fflaviomartil\u002Fralph-jev-gauntlet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftmux-terminal\u002FSKILL.md",[],[]]