
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+Enterin a separate call.--dry-runprints 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.pytypes 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.


