開始使用
Pane Notice Spool — Long Messages for Agent Panes

Pane Notice Spool — Long Messages for Agent Panes

Stop typing walls of text into another agent's tmux pane. Messages over 600 characters are saved to a spool file (exact text, newlines intact, mode 0600) and only a short pointer is typed: the first 200 characters, the total length and the file path. Same text maps to the same file, writes are atomic, and prune removes old files. Includes a one-call tmux sender with --dry-run. Python 3 + tmux only; no network calls or credentials.
#工程
評分
需要更多評價
已售出
0
使用方式
下載

The problem

When one agent wakes another with tmux send-keys, long text is fragile. Some CLIs collapse big pastes into a placeholder; a long line is easy to leave sitting unsubmitted in the input box; and a wall of text typed into a pane is hard to review later.

The fix

Keep the typed text short and move the full text into a file:

Message length What is typed What is saved
600 characters or fewer the message as is nothing
more than 600 first 200 characters + [long message: N chars; read the full text in .notice_spool/notice_<hash>.txt] the full text, newlines intact, mode 0600

Same text always maps to the same file (hash of the content), so a resend does not pile up copies. Files are written to a temporary name and renamed, so a reader never sees a half-written file. prune removes files older than N days.

What you get

  • scripts/notice_spool.py - prepare (print the short text; spool if long), prune, list. Standard library only; refuses a spool directory outside --root.
  • scripts/notice_send.py - prepare + tmux send-keys -l + Enter in a separate call. --dry-run prints what would be typed.
  • tests/test_package.py - 13 tests: package contract, spool logic (boundary, exact full text, idempotence, prune, path escape), and a private-tmux-server test that a long message arrives as a pointer while the full text is in the file.
  • SKILL.md - instructions for Claude Code.
  • LICENSE - purchaser license.

Quick start

python3 scripts/notice_send.py --root . my-session:0.1 "Please review the attached plan: ... (long text)"
python3 scripts/notice_spool.py prepare --root . --message "$(cat plan.md)"
python3 scripts/notice_spool.py list --root .
python3 scripts/notice_spool.py prune --root . --keep-days 7

Options: --threshold N (default 600), --head N (default 200), --spool-dir REL (default .notice_spool).

Limits

  • The receiving agent must be told to read the file named in the pointer; the pointer says so, but your agent's instructions should too.
  • notice_send.py types to the target exactly as given. tmux silently rounds targets that do not exist (for example a missing pane index lands on the last pane), so pass a pane id (%N) or verify the target first.
  • Spool files are plain text. Do not put credentials in a message.
  • Python 3.8+ and tmux. No network calls, no installers, no background services.