lkn
/
ollie-acme
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

readme: document Cfg/Nudge/Usage commands and Oi/Wtf/Theo scripts

This commit is contained in:
Levi Neely 2026-07-18 22:49:35 +02:00
parent 0709579452
commit c282adfd67
1 changed files with 24 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
README.md
View File

@ -10,7 +10,7 @@ cd acme && mk
## Usage ## 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 | | 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 | | Kill *id* | Kill a session |
| Refresh | Reload the session list | | 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 | | Command | Action |
|---|---| |---|---|
| Prompt | Open the session's `prompt` file for editing | | Prompt | Open the session's `prompt` file for editing |
| Stop | Interrupt the current turn | | Stop | Interrupt the current turn |
| Ctl | Open the session's `ctl` file | | 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: Override per invocation:
``` ```
Kmpl -model phi-4-mini -backend ollama 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."