---
repo: tmux-amq
updated: "2026-08-24"
---

# INTENT

## Why it exists

Provide repository-aware tmux sessions and a local, durable, inspectable
transport for direct messages between their users or processes, with strict
targeting, explicit endpoint lifecycle, safe delivery boundaries, and future
interoperability with coordination-engine.

## Governing principle

This repository should stay focused on the purpose above. Work that changes its
authority, ownership boundaries, or operational promises should be captured in a
workplan before implementation.

## What it enables

- Terminal users and processes can address one another by registered repository
  slug without tamq assuming what runs in a pane.
- Messages, leases, delivery state, and acknowledgements survive process restarts.
- Operators can inspect, export, replay, and purge local queue history.
- A later coordination-engine adapter can use a stable local socket boundary
  without absorbing tmux-specific concerns into the coordination engine.