mate

Coordinate worker-agent task execution across tmux panes using request IDs.

6|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/bearcove/mate --skill mate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mate
Source: https://github.com/bearcove/mate/tree/main/.claude/skills/mate
Command: npx skills add https://github.com/bearcove/mate --skill mate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the complexity of coordinating two AI agents running in separate tmux panes by turning task handoffs into simple request/response updates.

Core Features & Use Cases

  • Task delegation over tmux: Send work to a specific worker pane without requiring pane management or tmux awareness from the assigning agent.
  • Progress and results via request IDs: Report incremental updates and final outcomes through the mate update mechanism tied to a request ID.
  • Context-safe operation: Clear or preserve mate context appropriately when assigning tasks, and keep responsibility boundaries (captain handles orchestration; mate handles execution).

Quick Start

Ask your captain agent to assign a task to the mate worker using mate assign, then read back the result via mate update through the request ID.

Frequently Asked Questions about mate

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

FAQPage Schema
How do I delegate coding tasks to an AI agent in a separate tmux pane?▼

You can delegate coding tasks across tmux panes by assigning work to a worker agent using a request ID, then reading back progress and results routed through that specific request ID.

What is the best way to coordinate multiple AI agents running in tmux?▼

The best way to coordinate multi-agent workflows in tmux is using a request-response mechanism where one agent orchestrates tasks and the worker agent executes commands while reporting deterministic updates.

How do worker agents report task progress without direct communication?▼

Worker agents report task progress and completion exclusively through a dedicated update mechanism tied to a request ID, ensuring reliable response routing without direct pane management.

Can a worker agent run git commands or manage issues during task execution?▼

No, worker agents are forbidden from running git commands, managing issues, or engaging in user-facing chat to prevent scope creep and security violations during cooperative task execution.

Does multi-agent task delegation require tmux awareness from the assigning agent?▼

No, the assigning agent does not require tmux awareness or pane management to send work to a specific worker pane, as task handoffs are handled through a simple request and response update protocol.