
pawel-cell/tmux-ai-agent-workspace-bundle
Developer toolstmux guide, AI-agent watchdog skill, session recipes, and handoff protocol for VPS-based agent work.
Overview
A practical starter bundle for keeping AI-agent work alive on a VPS with tmux. This repo contains the deliverables from the tmux lead magnet: 1. — install tmux, create sessions, detach/reattach, split panes, and enable mouse support. 2. — a reusable skill/prompt pattern for monitoring long-running AI agents inside tmux. 3. — five runnable shell scripts that create useful tmux workspaces. 4. — a simple planner/executor workflow for two agents working in separate panes. - tmux-installation-guide.md - agent-watchdog-skill.md - session-recipes-pack/README.md - handoff-protocol.md - agent-pair.sh — Claude + Codex side-by-side - build-loop.sh — editor + dev server + tests - research.sh — agent + browser logs + notes - deploy.sh — SSH/deploy + logs + monitor - learn.sh — tutorial + terminal + notes These scripts are intentionally simple. Edit the commands at the top of each script if your machine uses different CLI names or project paths.
README
tmux AI Agent Workspace Bundle
A practical starter bundle for keeping AI-agent work alive on a VPS with tmux.
This repo contains the deliverables from the tmux lead magnet:
- tmux Installation Guide — install tmux, create sessions, detach/reattach, split panes, and enable mouse support.
- Agent Watchdog Skill — a reusable skill/prompt pattern for monitoring long-running AI agents inside tmux.
- Session Recipes Pack — five runnable shell scripts that create useful tmux workspaces.
- Handoff Protocol Prompt + Skill Combo — a simple planner/executor workflow for two agents working in separate panes.
Quick start
git clone https://github.com/pawel-cell/tmux-ai-agent-workspace-bundle.git
cd tmux-ai-agent-workspace-bundle
chmod +x session-recipes-pack/*.sh
Then open the files in this order:
tmux-installation-guide.mdagent-watchdog-skill.mdsession-recipes-pack/README.mdhandoff-protocol.md
Session recipe scripts
agent-pair.sh— Claude + Codex side-by-sidebuild-loop.sh— editor + dev server + testsresearch.sh— agent + browser logs + notesdeploy.sh— SSH/deploy + logs + monitorlearn.sh— tutorial + terminal + notes
Notes
These scripts are intentionally simple. Edit the commands at the top of each script if your machine uses different CLI names or project paths.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add pawel-cell/tmux-ai-agent-workspace-bundle