This repository has been archived on 2026-08-16. You can view files and clone it, but cannot push or open issues or pull requests.
ollie-acme/README.md

59 lines
2.0 KiB
Markdown

# ollie-acme
acme interface for ollie. Provides a session list window and per-session chat windows, all driven through the 9P filesystem.
## Build
```sh
cd acme && mk
```
## Usage
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 |
|---|---|
| New | Open `s/new` for editing |
| Kill *id* | Kill a session |
| Refresh | Reload the session list |
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 |
## Scripts
Shell scripts in `acme/scripts/` for use as acme tag commands.
### 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."