jellydn/my-ai-tools/tmux

Claude Code and agent skill by jellydn/my-ai-tools

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Control tmux sessions remotely — send commands, capture output, manage panes

Install

npx vskill@latest install jellydn/my-ai-tools/tmux

SKILL.md

🚀 tmux Skill

Control tmux sessions programmatically to run interactive terminal applications (REPLs, debuggers, databases) without blocking.

📋 Quickstart (Easy Way)

Use LogPilot for automatic output capture + AI analysis:

bash
# Install LogPilot
cargo install logpilot
 
# Watch your tmux session
logpilot watch mysession --pane mysession:0.0
 
# Ask AI about what's happening
logpilot ask "What errors appeared?"
logpilot summarize --last 5m

Add to Claude Code: claude mcp add --scope user logpilot -- logpilot mcp-server

📋 Manual Control (Raw tmux)

Use isolated sockets to avoid conflicts with personal tmux:

bash
# Setup socket
export SOCKET="${TMPDIR:-/tmp}/ai-tmux-sockets/agent.sock"
mkdir -p "$(dirname "$SOCKET")"
 
# Create session and run
SESSION=agent-py
tmux -S "$SOCKET" new -d -s "$SESSION"
tmux -S "$SOCKET" send-keys -t "$SESSION" 'python3 -q' Enter
 
# Capture output manually
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION" -S -100
 
# Cleanup
tmux -S "$SOCKET" kill-session -t "$SESSION"
📋 Core Commands
ActionCommand
New sessiontmux -S "$SOCKET" new -d -s NAME
Send keystmux -S "$SOCKET" send-keys -t NAME 'cmd' Enter
Send literaltmux -S "$SOCKET" send-keys -t NAME -l 'text'
Capture outputtmux -S "$SOCKET" capture-pane -p -J -t NAME -S -N
List sessionstmux -S "$SOCKET" list-sessions
Kill sessiontmux -S "$SOCKET" kill-session -t NAME

Control keys: C-c (SIGINT), C-d (EOF), C-z (suspend), Escape

📋 Interactive Recipes

🔁 Python REPL
bash
SESSION=agent-py
SOCKET="${TMPDIR:-/tmp}/ai-tmux-sockets/agent.sock"
tmux -S "$SOCKET" new -d -s "$SESSION"
tmux -S "$SOCKET" send-keys -t "$SESSION" 'PYTHON_BASIC_REPL=1 python3 -q' Enter
sleep 1
tmux -S "$SOCKET" send-keys -t "$SESSION" -l 'print(2+2)'
tmux -S "$SOCKET" send-keys -t "$SESSION" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION" -S -10
tmux -S "$SOCKET" kill-session -t "$SESSION"
🔁 GDB Debugger
bash
SESSION=agent-gdb
SOCKET="${TMPDIR:-/tmp}/ai-tmux-sockets/agent.sock"
tmux -S "$SOCKET" new -d -s "$SESSION"
tmux -S "$SOCKET" send-keys -t "$SESSION" 'gdb --quiet ./program' Enter
tmux -S "$SOCKET" send-keys -t "$SESSION" 'set pagination off' Enter
tmux -S "$SOCKET" send-keys -t "$SESSION" 'run' Enter
# ... later ...
tmux -S "$SOCKET" send-keys -t "$SESSION" C-c
tmux -S "$SOCKET" send-keys -t "$SESSION" 'bt' Enter
tmux -S "$SOCKET" send-keys -t "$SESSION" 'quit' Enter 'y' Enter
Node.js / psql / etc.

Same pattern: new → send-keys → capture-pane → kill-session

📋 LogPilot Reference

TaskCommand
Watch sessionlogpilot watch SESSION
Watch panelogpilot watch SESSION --pane TARGET
AI summarylogpilot summarize --last 10m
Ask questionlogpilot ask "Why is it failing?"
With logslogpilot ask "Explain" --include-logs
Statuslogpilot status
MCP Setup
json
{
	"mcpServers": {
		"logpilot": {
			"command": "logpilot",
			"args": ["mcp-server"]
		}
	}
}

Or: claude mcp add --scope user --transport stdio logpilot -- logpilot mcp-server

🎨 Best Practices

  1. Use LogPilot — easiest way to capture and analyze output
  2. Always use `-S "$SOCKET"` — prevents conflicts with user tmux
  3. Use `-l` flag — literal text, no shell expansion issues
  4. `PYTHON_BASIC_REPL=1` — required for interactive Python
  5. Kill sessions when done — prevents resource leaks

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
75
Repository forks
9
7-day trend score
22

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 16 May 2026, 5 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/jellydn/my-ai-tools/tmux/badge)](https://verified-skill.com/skills/jellydn/my-ai-tools/tmux)

Something wrong with this skill or its page? Tell us.