Metadata-Version: 2.1
Name: pairmux
Version: 0.1.0
Summary: Reliable terminal primitives for AI agents on tmux
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Go
Classifier: Topic :: Software Development
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Project-URL: Homepage, https://github.com/treeleaves30760/pairmux
Project-URL: Repository, https://github.com/treeleaves30760/pairmux
Requires-Python: >=3.9
Description-Content-Type: text/plain

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
