From c282adfd67445a78a09e7f3bc4d5473fa56f20c8 Mon Sep 17 00:00:00 2001
From: Levi Neely <141506390+lneely@users.noreply.github.com>
Date: Sat, 18 Jul 2026 22:49:35 +0200
Subject: [PATCH] readme: document Cfg/Nudge/Usage commands and Oi/Wtf/Theo
 scripts

---
 README.md | 29 ++++++++++++++++++++++++-----
 1 file changed, 24 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index e7a663f..80dab65 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ cd acme && mk
 
 ## Usage
 
-Run `ollie-acme` from within acme. It opens an `ollie/sessions` window listing active sessions. Click a session ID to open its chat window. Tag commands:
+Run `ollie-acme` from within acme. It opens an `ollie/sessions` window listing active sessions. Execute (middle-click) a session ID to open its chat window. Tag commands:
 
 | Command | Action |
 |---|---|
@@ -18,22 +18,41 @@ Run `ollie-acme` from within acme. It opens an `ollie/sessions` window listing a
 | Kill *id* | Kill a session |
 | Refresh | Reload the session list |
 
-Chat windows stream new output via `statewait` and expose:
+Chat windows stream new content by polling the chat file. The window is named `cwd/+Ollie`. Tag commands:
 
 | Command | Action |
 |---|---|
 | Prompt | Open the session's `prompt` file for editing |
 | Stop | Interrupt the current turn |
 | Ctl | Open the session's `ctl` file |
+| Cfg | Open the session's `cfg` file |
+| Nudge | Send a `.` prompt (nudge the agent) |
+| Usage | Open the session's `usage` file |
 
-## Kmpl
+## Scripts
 
-`acme/scripts/Kmpl` is an acme script for AI code completion. It reads the text before and after the cursor (dot), sends it to `u/complete`, and inserts the result at the cursor position.
+Shell scripts in `acme/scripts/` for use as acme tag commands.
 
-Add `Kmpl` to your acme tag or middle-click it to trigger a completion. It uses the `OLLIE_COMPLETE_BACKEND` and `OLLIE_COMPLETE_MODEL` environment variables (same as `u/complete`).
+### Kmpl
+
+AI code completion. Reads the text before and after the cursor (dot), sends it to `u/complete`, and inserts the result at the cursor position.
+
+Uses `OLLIE_COMPLETE_BACKEND` and `OLLIE_COMPLETE_MODEL` environment variables (same as `u/complete`).
 
 Override per invocation:
 
 ```
 Kmpl -model phi-4-mini -backend ollama
 ```
+
+### Oi
+
+Spawns or reuses a persistent navigator session scoped to the workspace root. Sends file context (filename, selection, git diff) and a check-in prompt. On first use, asks the agent to acknowledge context; on subsequent uses, sends a short "check in" prompt. Prints the response to the +Errors window.
+
+### Wtf
+
+Like Oi, but sends the prompt "What does this code do?" Useful for quick explanations of unfamiliar code. Uses the same persistent navigator session.
+
+### Theo
+
+Adversarial security review. Spawns or reuses a persistent `theo` agent session. Sends the current file (or selection + diff), or if executed from a directory window, sends uncommitted/staged/branch changes. Prompt: "Security review. Tear it apart."