subagent-tmux

Delegate research tasks to isolated tmux sub-agents with file-based output capture.

7|1|Updated Jul 27, 2021
One-click install
npx skills add https://github.com/podcodar/webapp --skill subagent-tmux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-tmux
Source: https://github.com/podcodar/webapp/tree/main/.agents/skills/subagent-tmux
Command: npx skills add https://github.com/podcodar/webapp --skill subagent-tmux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of slow, blocked, or context-contaminated work by letting you delegate multiple tasks to isolated sub-agents running concurrently in separate tmux sessions.

Core Features & Use Cases

  • Isolated parallel execution: Run multiple investigations at once without mixing context between tasks.
  • File-based result capture: Redirect each sub-agent’s output to a dedicated /tmp file so you can reliably read results afterward.
  • Optional structured and interactive modes: Support JSON output for structured events and a FIFO-based approach for two-way communication.

Use case example: Run three independent repository scans (models, controllers, tests) in parallel, then combine their outputs into a single summarized report.

Quick Start

Start a tmux session for your task and run pi in that session while redirecting output to a dedicated file you can read when it completes.

Frequently Asked Questions about subagent-tmux

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

FAQPage Schema
How do I run parallel research tasks without blocking the main session?

You can delegate long-running or parallelizable research tasks to isolated sub-agents running in separate tmux sessions, ensuring the main session remains unblocked. This approach executes multiple investigations concurrently without mixing context between tasks.

What is the best way to capture output from multiple tmux sub-agents?

The best way to capture output from tmux sub-agents is redirecting each session's output to a dedicated /tmp file or using JSONL format. You can then reliably read these files afterward to retrieve deterministic results.

How do I establish two-way communication with a sub-agent in tmux?

Two-way communication with a tmux sub-agent is established using a FIFO-based approach. This interactive mode allows you to send inputs and receive structured JSON outputs back from the running sub-agent.

Can I run risky experiments in an isolated tmux session without affecting my main environment?

Yes, you can run risky experiments by delegating them to isolated sub-agents in separate tmux sessions. This isolation prevents context contamination and ensures the main session continues operating unaffected.

How do I retrieve deterministic results from a parallelized task in tmux?

To retrieve deterministic results from tmux parallelized tasks, you must apply a tmux session naming convention, redirect output to /tmp files, and use polling or completion markers. This ensures reliable and structured retrieval of the final output.