personal-tmux-devmode

Detect and inspect dev server processes in tmux panes to diagnose terminal output.

Updated Jun 14, 2024
One-click install
npx skills add https://github.com/Huijiro/dotfiles --skill personal-tmux-devmode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: personal-tmux-devmode
Source: https://github.com/Huijiro/dotfiles/tree/main/agents/.agents/skills/personal-tmux-devmode
Command: npx skills add https://github.com/Huijiro/dotfiles --skill personal-tmux-devmode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps troubleshoot dev server issues by detecting if you are in tmux and inspecting dev server processes running in other tmux panes, so you can review terminal output directly instead of guessing.

Core Features & Use Cases

  • Detects whether you are inside tmux and identifies available panes across sessions.
  • Locates dev server processes (node, bun, deno, etc.) and associates them with their working directories.
  • Matches the relevant pane to the current project to focus troubleshooting on the most pertinent server.
  • Captures and surfaces pane logs to reveal errors, warnings, and HMR/build messages for faster diagnosis.
  • Guides you through actionable steps when dev servers are not producing useful output.

Quick Start

Ensure you are inside a tmux session with a running dev server, then ask me to inspect the panes for logs.

Frequently Asked Questions about personal-tmux-devmode

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

FAQPage Schema
How do I troubleshoot a dev server running in a tmux pane?

Troubleshooting a dev server in tmux involves detecting active panes, identifying the running process, and capturing terminal output to surface diagnostic logs. This lets you review build or runtime errors directly instead of guessing.

Can I check HMR build errors across multiple tmux sessions?

Yes, you can inspect multiple tmux sessions by discovering panes and reading the current command and path. This allows you to match the relevant pane to your project and capture HMR build messages for diagnosis.

Do I need to be inside tmux to diagnose runtime issues?

Yes, you need an active tmux session to diagnose runtime issues this way. The mechanism requires tmux accessibility to execute pane discovery commands, locate dev server processes, and read their terminal output.

What is the best way to find node dev server logs in terminal panes?

Finding node dev server logs requires identifying the process via pane_pid and pane_current_path, matching it to your working directory, and surfacing captured pane logs to reveal warnings and errors.

Why does my dev server troubleshooting show no useful output?

When dev server troubleshooting yields no useful output, the process may not be generating logs or the pane is mismatched. Actionable steps are required to verify the running dev process and capture valid terminal output.