spawn

Spawn parallel AMP agents in tmux windows with thread linkage.

59|5|Updated Jun 21, 2025
One-click install
npx skills add https://github.com/bdsqqq/dots --skill spawn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spawn
Source: https://github.com/bdsqqq/dots/tree/main/user/amp/skills/spawn
Command: npx skills add https://github.com/bdsqqq/dots --skill spawn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you spawn amp agents in tmux with thread linkage, enabling coordinated multi-agent work and traceable conversations.

Core Features & Use Cases

  • Auto-naming: Agents get auto-assigned names for easier tracking.
  • Thread linkage: Agents reference the parent thread to maintain context.
  • Handoff and coordination: Provides patterns for coordinating with other skills like coordinate.

Quick Start

  • Spawn an agent in a new window: use the TASK and optionally NAME to control naming
  • Example: TASK="<task>" NAME="branch-name" && tmux new-window -n "$NAME" "amp --dangerously-allow-all" && sleep 3 && tmux send-keys "Continuing from https://ampcode.com/threads/$AMP_CURRENT_THREAD_ID. $TASK" C-m

Frequently Asked Questions about spawn

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

FAQPage Schema
How do I spawn multiple agents in parallel within a tmux session?

Spawn parallel agents by creating new tmux windows with `tmux new-window`, passing your task via environment variables. Each agent runs independently in its own window while maintaining parent-child thread linkage through AMP_CURRENT_THREAD_ID, enabling coordinated multi-agent workflows.

What is thread linkage in multi-agent workflows and why does it matter?

Thread linkage maintains context continuity across agents by referencing the parent thread ID. This approach enables traceable conversations and coordinated handoffs between agents, ensuring each spawned agent inherits conversation context from the parent thread.

Can I use tmux windows to orchestrate agent handoffs and coordination?

Yes. This Skill provides patterns for agent handoffs through tmux window management and thread linkage. Agents reference the parent thread ID and receive callback instructions via TMUX_PANE, enabling coordinated task delegation and sequential agent workflows.

How do I auto-name spawned agents for easier tracking?

Pass the NAME variable when spawning agents—it auto-assigns window names based on your assets or custom values. The Skill returns the agent name for reference, simplifying tracking across multiple parallel agents.

What environment setup do I need to spawn agents with thread context?

Set AMP_CURRENT_THREAD_ID to link child agents to the parent thread, and use TMUX_PANE to route callback instructions. These variables enable detached window creation and maintain conversation context across spawned agents in the tmux session.