PC

pawel-cell/tmux-ai-agent-workspace-bundle

Developer tools
24 stars Quality 32 Trend 32

tmux 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:

  1. tmux Installation Guide — install tmux, create sessions, detach/reattach, split panes, and enable mouse support.
  2. Agent Watchdog Skill — a reusable skill/prompt pattern for monitoring long-running AI agents inside tmux.
  3. Session Recipes Pack — five runnable shell scripts that create useful tmux workspaces.
  4. 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:

Session recipe scripts

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.

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add pawel-cell/tmux-ai-agent-workspace-bundle