Skip to content

Repository files navigation

unsolicited-text

"i did not consent to text"

(audience: humans)

1. Features

Responses are encouraged to keep to one thread at a time, and everything else gets added to the queue.

Before After
Seventeen lines of prose with three questions asked inside them Six lines, then a queue holding a question, an uncertainty and a call taken

The queue holds different items (e.g. questions, investigations) which you can deal with one at a time when you feel necessary.

1.2. say less, see more
Before After
Four harnesses compared in four parallel sentences The same four compared in a table
Before After
Two paragraphs describing how a note reaches the next turn The same thing drawn, turn by turn
1.3. simple english
Before After
An answer given in metaphors and specification names The same answer in plain words
1.4. single sentence confirmations
Before After
A finished task reported as a twelve line write-up The same task reported in one line

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
Turn forty, and the reply has drifted back to fifteen lines The same turn, still answered in two lines

2. Skills

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.1 configure as much of the queue as you want to see
Before After
Six open items listed in full Two shown, and a count of the four still pending
2.2 open each queue item with an emoji
Before After
Five open items, each opening with its word The same five, each opening with an emoji as well

Off unless you ask for it: a terminal with no emoji font shows a box instead.

3. Install

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.

4. How it works

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)

5. Tests

tests/run-tests

6. Recordings and the logo

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.

About

agent plugin for staying focused

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages