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.