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.