pairmux 0.1.0

Reliable terminal primitives for AI agents on tmux

pairmux — reliable terminal primitives for AI agents on tmux

pairmux lets an AI agent drive a real terminal through a reliable, blocking
interface while a human can watch, attach, and help at any time. It is an
Agent-Computer Interface (ACI) layer built on top of tmux, not a replacement
for it: tmux stays the terminal-state engine, so a human can `tmux attach` and
take over almost for free.

Highlights:
  * Blocking `run` / `wait` calls return when a command actually finishes,
    times out, or starts asking for input — the agent never guesses `sleep N`.
  * A per-terminal journal is the single source of truth: full scrollback is
    always available via `log`, even after output scrolls off screen.
  * Completion detection degrades gracefully: OSC 133 shell integration first,
    then a printed sentinel, then output quiescence.
  * Output is shaped for models (ANSI stripped, carriage-return redraws folded)
    and truncated responses always carry the exact command to fetch the rest.
  * Humans and agents share one live terminal; `note`, `attach`, and a
    per-terminal writer lock keep hand-offs sane.

Installation model:
  This is a platform wheel bundling a prebuilt native `pairmux` executable.
  Installing it drops the binary straight onto your PATH (the environment's
  bin/ directory) — there is no Python code and no build step, so
  `uv tool install pairmux` and `pipx install pairmux` just work.

Runtime requirement: tmux >= 3.2 (`pairmux doctor` checks your environment).

Homepage / source: https://github.com/treeleaves30760/pairmux
License: MIT