packages/skills/skills/tmux-background-agents/SKILL.md
# tmux Background Agents Manage background Claude Code sessions using tmux. Start agents, send prompts, read responses, and hand off to Terminal windows - all without interrupting your main session. ## Prerequisites - macOS with Terminal.app - tmux installed (`brew install tmux`) - Claude Code CLI installed ## Instructions ### Start a new background Claude session ```bash # Basic - starts in specified directory tmux new-session -d -s SESSION_NAME "cd /path/to/dir && claude --dangerously-sk
npx skillsauth add mediar-ai/skillhubz packages/skills/skills/tmux-background-agentsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Manage background Claude Code sessions using tmux. Start agents, send prompts, read responses, and hand off to Terminal windows - all without interrupting your main session.
brew install tmux)# Basic - starts in specified directory
tmux new-session -d -s SESSION_NAME "cd /path/to/dir && claude --dangerously-skip-permissions"
# With initial prompt
tmux new-session -d -s SESSION_NAME "cd /path/to/dir && claude --dangerously-skip-permissions 'YOUR PROMPT HERE'"
tmux send-keys -t SESSION_NAME "your prompt here" Enter
Note: Sometimes an extra Enter is needed:
tmux send-keys -t SESSION_NAME Enter
tmux capture-pane -t SESSION_NAME -p
For full scrollback:
tmux capture-pane -t SESSION_NAME -p -S -100
tmux ls
osascript <<'APPLESCRIPT'
tell application "Terminal"
activate
do script "tmux attach -t SESSION_NAME"
end tell
APPLESCRIPT
tmux kill-session -t SESSION_NAME
tmux new-session -d -s my-agent "cd ~/project && claude --dangerously-skip-permissions"
sleep 5
tmux send-keys -t my-agent "Fix the bug in auth.swift" Enter
sleep 15
tmux capture-pane -t my-agent -p
osascript -e 'tell application "Terminal" to do script "tmux attach -t my-agent"'
When the user asks to:
tmux send-keystmux capture-panetmux lstmux kill-sessionEnter if the prompt doesn't seem to submitauth-fix, ui-refactor, etc.tools
Design web-like user interfaces in the terminal and inside tmux with a cell-grid Canvas, CSS-like box model, flexbox/grid layout, and 15 reusable widgets such as Panel, Table, Card, ProgressBar, Meter, Tabs, Tree, Badge, Banner, and a braille line chart. Use when an agent needs a dashboard, panel, table, status page, TUI layout, tmux dashboard, screenshot-driven CLI/TUI replica, ANSI frame, truecolor render, pyte PNG screenshot smoke test, wide-character alignment, or a new terminal widget.
tools
Drive interactive terminal (TUI) programs — CLIs, REPLs, installers, menu apps, agent CLIs, and editors like vim — through a PTY, reading semantic screen snapshots. A pattern library classifies a screen (REPL, menu, pager, fzf search, confirm dialog, form, spinner, wizard) and drives it with a ready recipe. Use when a program expects a live terminal (arrow-key menus, prompts, spinners, password fields, curses UIs), or when a piped command hangs or prints nothing.
tools
Design and render terminal/CMD visual effects and ASCII art from a one-line request via the pluggable `fx` engine (18 hot-swappable, themeable effects plus scripted shows). Effects include donut, matrix rain, plasma, fire, a spinning 3D ball, Game of Life, wireframe cube, 3D text banners, rainbow/lolcat gradient text, starfield, tunnel, fireworks, image-to-ASCII, and more. Use when the request is for a terminal animation, ANSI/CLI art, or a new console effect. Pure Python stdlib; truecolor.
tools
# X Twitter Scraper Use Xquik for X/Twitter tweet search, user lookup, profile tweets, follower export, media download, monitors, webhooks, posting workflows, and MCP-backed API exploration. ## Prerequisites - A Xquik API key in `XQUIK_API_KEY`. - Internet access to `https://xquik.com/api/v1`, `https://xquik.com/mcp`, and `https://docs.xquik.com`. - A clear user request that identifies the target tweets, users, accounts, keywords, media, monitor, webhook, or write action. ## Source Truth -