subagent

Manage persistent tmux sessions for long-running background processes.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/roach88/claude-config --skill subagent-roach88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent
Source: https://github.com/roach88/claude-config/tree/main/skills/subagent
Command: npx skills add https://github.com/roach88/claude-config --skill subagent-roach88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the problem of losing state for long-running background processes like builds, log monitoring, and test runs when the AI context window resets, by using persistent tmux sessions that continue running independently of the AI's context.

Core Features & Use Cases

  • Persistent Background Sessions: Run long-running processes such as build watches, test suites, and log tailing that survive AI context resets without interruption.
  • Standardized Session Management: All sessions use a cc- naming prefix (for example, cc-build-watch, cc-log-tail) to avoid naming conflicts, with clear commands to create, send input to, read output from, list, and safely terminate sessions.
  • Safety Guardrails: Includes rules to check for existing sessions before creation, require explicit approval before killing sessions, and read output before sending new commands to prevent errors.

Quick Start

Use the subagent skill to create a persistent tmux session named cc-build-watch that runs the command npm run build --watch to continuously monitor your project's build process in the background.

Frequently Asked Questions about subagent

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

FAQPage Schema
How do I keep background processes running when the AI context window resets?

You can keep background processes running during AI context window resets by using persistent tmux sessions that operate independently of the AI context, ensuring continuous execution of long-running tasks like build watches or log tailing without manual restarts.

How do I monitor a build process in the background using tmux?

To monitor a build process in the background using tmux, create a persistent session with a standardized naming prefix, send your build command to it, and read the output stream later to check the status without interrupting the process.

Can I run log tailing continuously without losing state across AI sessions?

Yes, you can run continuous log tailing without losing state by attaching the log command to a persistent tmux session, which maintains the process state and output history independently of the AI session lifecycle.

Does persistent session management require manual approval to terminate background tasks?

Persistent session management includes safety guardrails that require explicit approval before killing tmux sessions, preventing unauthorized termination of active background processes like test runs or build monitoring tasks.

What is the best way to manage multiple background tasks without naming conflicts?

The best way to manage multiple background tasks without naming conflicts is using a standardized naming prefix for all tmux sessions, which ensures organized creation, listing, and safe termination of each persistent process.

Why should I read tmux session output before sending new commands to a background process?

Reading tmux session output before sending new commands prevents errors by allowing you to verify the current state of the background process, ensuring you do not interrupt an ongoing build or test run with conflicting input.