agent-message

Coordinate task delegation and command execution among Claude Code instances in tmux sessions.

1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tcdent/dotfiles --skill agent-message
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-message
Source: https://github.com/tcdent/dotfiles/tree/main/agent/skills/agent-message
Command: npx skills add https://github.com/tcdent/dotfiles --skill agent-message

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tmux, claude-code, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines communication and task delegation among multiple Claude Code instances running in tmux, enhancing collaboration and productivity.

Core Features & Use Cases

  • Peer Discovery: Automatically identify and list all Claude Code instances within the tmux session and across different hosts.
  • Message Sending: Send messages to specific Claude instances or to all, with support for multiline and attached files.
  • Command Execution: Execute commands in other panes, facilitating actions like restarting services or checking logs.
  • Use Case: When working on a complex project with multiple Claude instances, use this Skill to delegate tasks or check the status of a particular task across different panes.

Quick Start

Use the agent-message skill to send a message to another Claude instance: agent-message send [email protected] "Check the status of the deployment."

Frequently Asked Questions about agent-message

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

FAQPage Schema
How do I coordinate tasks across multiple Claude Code instances in tmux?

You can coordinate tasks across multiple Claude Code instances in tmux by using a skill that discovers peer sessions, sends messages to specific or all instances, and executes commands remotely within a shared environment.

Can I send messages to a specific Claude Code instance running in another tmux pane?

Yes, you can send messages to a specific Claude Code instance using the send command with the target's identifier. The skill supports peer discovery to identify instances across the tmux session and different hosts for targeted messaging.

Does this task delegation tool work across different hosts or only within a single tmux session?

This task delegation tool works across different hosts. Its peer discovery feature automatically identifies and lists all Claude Code instances within the tmux session and spans across different hosts for comprehensive coordination.

How do I execute a command in another pane to check logs or restart services?

You can execute commands in other panes by using the remote command execution feature. This facilitates actions like restarting services or checking logs in another Claude Code instance without manually switching panes.

Do I need both tmux and Claude Code installed to use this coordination skill?

Yes, you need both tmux and Claude Code installed. The skill coordinates task delegation and command execution among Claude Code instances running in tmux sessions, requiring both dependencies to operate effectively.

What is the best way to delegate tasks to multiple Claude Code instances simultaneously?

The best way to delegate tasks to multiple Claude Code instances simultaneously is using the broadcast messaging feature. You can send messages to all discovered instances at once, with support for multiline text and attached files.