(audience: humans)
Responses are encouraged to keep to one thread at a time, and everything else gets added to the queue.
| Before | After |
![]() |
![]() |
The queue holds different items (e.g. questions, investigations) which you can deal with one at a time when you feel necessary.
1.4. single sentence confirmations
| Before | After |
![]() |
![]() |
I don't need to hear your life story after asking you to do something.
1.5. no agent drift
The agent remains concise even with longer sessions via skills, hooks and local state.
| Before | After |
![]() |
![]() |
| Skill | What it does |
|---|---|
unsolicited-text:settings |
allows you to configure different settings (e.g. queue in tree format, emojis) |
unsolicited-text:update |
updates the plugin |
unsolicited-text:reload |
prints the rules into a session that never got them |
unsolicited-text:uninstall |
removes the plugin from this install |
2.2 open each queue item with an emoji
| Before | After |
![]() |
![]() |
Off unless you ask for it: a terminal with no emoji font shows a box instead.
Copy/paste into your CLI prompt:
Install the unsolicited-text plugin from https://github.com/justinkek/unsolicited-text, refer to the repo's INSTALL.md for instructions.
Or 🔗 check the installation instructions.
See 🔗 product compatibility for what installation, hooks and reloads support on each product and surface.
| File | When it runs | What it does | Tokens |
|---|---|---|---|
hooks/load-rules.sh |
session start | prints rules/reply-shape.md into the session |
~1,900 |
hooks/print-rules-if-missed.sh |
every prompt | prints the rules where session start did not, once a session | ~1,900, and only in a session that missed them |
hooks/remind-response-length.sh |
every prompt | restates the shortest-form rule | ~50 |
hooks/replay-stop-notes.sh |
every prompt | prints the note the last turn recorded | ~70, and only when there is one |
hooks/note-long-reply.sh |
turn end | records a note when the reply ran over the ceiling | none, it prints nothing into the session |
hooks/note-long-queue.sh |
turn end | records a note when the queue showed more items than allowed | none, it prints nothing into the session |
hooks/note-new-version.sh |
every prompt | asks once a day whether a newer version is out, and prints what it found | ~30, and only when there is one |
(Estimated at four characters to a token)
tests/run-tests
Each pair above is typed out from demo/<name>.prompt, demo/<name>-before.txt
and demo/<name>-after.txt. Edit any of them and record again:
brew install vhs
demo/record
They are typed in Commit Mono at the palette in demo/record. Without that face
installed the recording falls back to another one, and demo/record says so
before it starts.
The logo is drawn in logo/logo.svg and rendered by logo/render.
















