hire-a-minion

Spawn a parallel Claude instance in a tmux session for concurrent task execution.

4|Updated Jan 12, 2017
One-click install
npx skills add https://github.com/brandon-fryslie/dotfiles --skill hire-a-minion
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hire-a-minion
Source: https://github.com/brandon-fryslie/dotfiles/tree/main/config/claude/skills/hire-a-minion
Command: npx skills add https://github.com/brandon-fryslie/dotfiles --skill hire-a-minion

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Claude, tmux, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of managing parallel work tasks by enabling you to hire a 'tmux minion', a separate Claude instance that works on tasks in parallel, allowing you to focus on planning and review.

Core Features & Use Cases

  • Parallel Task Execution: Run tasks simultaneously using a separate Claude instance.
  • Task Management: Assign tasks, track progress, and review work without interruption.
  • Use Case: When working on a coding project, you can use the minion to implement features while you focus on architecture or testing.

Quick Start

To hire a minion and start a new Claude instance in a tmux window, run the following command: hire-a-minion

Frequently Asked Questions about hire-a-minion

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

FAQPage Schema
How do I run parallel tasks with Claude using tmux?

You can run parallel tasks with Claude by spawning a separate Claude instance in a tmux window, which operates as a minion to handle concurrent processing while you focus on planning. This allows simultaneous task execution and multi-tasking management without interruption.

What is a tmux minion for parallel task execution?

A tmux minion is a separate Claude instance spawned in a tmux session that works on assigned tasks in parallel. It enables concurrent processing for administrative workflows, allowing you to assign tasks, track progress, and review work while focusing on other priorities like architecture or testing.

Do I need tmux installed to run parallel Claude instances?

Yes, tmux is required to run parallel Claude instances, as it manages the terminal sessions and commands for the spawned minion. You also need Claude itself to serve as the parallel instance executing the assigned tasks.

Can I use a separate Claude instance for coding while I focus on architecture?

Yes, you can use a separate Claude instance to implement features in parallel while you focus on architecture or testing. The minion works on the assigned coding tasks concurrently, allowing you to manage task progress and review work without interrupting your primary workflow.

How do I start a parallel Claude session for multi-tasking management?

To start a parallel Claude session for multi-tasking management, run the hire-a-minion command, which spawns a new Claude instance in a tmux window. You can then assign tasks to this minion and track its progress while continuing your own work.

What are the limitations of using tmux minions for parallel task execution?

Parallel task execution using tmux minions requires both Claude and tmux to manage sessions and commands. It is suited for administrative workflows requiring concurrent processing, but you must manually assign tasks, track progress, and review the minion's work to ensure proper multi-tasking management.