tell-lead

Append driver-to-lead asks to .atmux/driver-inbox.md with best-effort socket and tmux wake-up.

2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/geoyws/atmux --skill tell-lead
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tell-lead
Source: https://github.com/geoyws/atmux/tree/main/plugins/atmux/skills/tell-lead
Command: npx skills add https://github.com/geoyws/atmux --skill tell-lead

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When you need the team lead to act, you need a reliable way to deliver your request even if tmux panes or sockets aren’t currently listening.

Core Features & Use Cases

  • Durable driver inbox write: Appends your ask to .atmux/driver-inbox.md under ## Open as the source of truth.
  • Best-effort wake-up: Publishes a socket event to nudge the lead and sends a tmux ping to the lead’s pane when it’s available.
  • Clear output semantics: Explains and distinguishes expected “lead listener absent” warnings (not a failure) from true failure cases like missing durable writes.

Use case: You are in the driver pane and need to escalate a blocker or request a decision from the lead, and you want it queued durably while also trying to get immediate attention.

Quick Start

Run /atmux:tell-lead <message> while you’re in your driver pane to send your request to the team lead and append it to .atmux/driver-inbox.md.

Frequently Asked Questions about tell-lead

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

FAQPage Schema
How do I send a task escalation request to a team lead across tmux restarts?▼

To send a task escalation durably across tmux restarts, append your request to a markdown inbox file while issuing a best-effort socket wake-up. This guarantees message delivery even if the listener pane is offline.

What is the best way to handle stateful messaging when the tmux listener is absent?▼

Stateful messaging during listener absence relies on a durable file inbox for message persistence, accompanied by a best-effort socket notification. This approach distinguishes expected listener-absent warnings from actual write failures using exit-code semantics.

How does socket pubsub work with durable workflow escalation for team communication?▼

Socket pubsub provides a best-effort wake-up nudge to the team lead, while a YAML-logged durable delivery to a markdown inbox file serves as the source of truth. The socket notification only alerts the lead if currently listening.

Can I use a markdown inbox file for driver-to-lead decision requests without losing data?▼

Yes, appending decision requests to a markdown inbox file ensures data persistence without loss. The file acts as a durable source of truth, capturing all driver asks even if tmux panes or sockets experience downtime.

Why does my best-effort wake-up return a warning instead of a failure code?▼

A best-effort wake-up returns a warning exit-code when the lead listener is absent, which is an expected state and not a real failure. True failure exit-codes are reserved for actual write failures to the durable inbox file.

When do I need durable task orchestration for tmux panes instead of direct messaging?▼

You need durable task orchestration when workflow escalations or decision requests must survive tmux restarts or listener downtime. Direct messaging fails if the receiving pane is inactive, whereas a durable inbox guarantees eventual processing.