- Agent cwd is optional; empty = inherit session cwd (the common case) - Session cwd is required at creation and is the inheritance root - toolsrv maintains agentCWD map, resolved per call from agent= field - Override set via agent cfg (cwd=...) or ctl (cwd [<dir>|-]) - Agent.SyncCwdToToolServer re-pushes on every (re)connect - GUI NewAgentDialog shows '(inherit: <sessionCwd>)' as placeholder - proc_test.go covers per-agent cwd isolation - Kate and acme scripts updated for new session/agent creation flow - AGENTS.md documents the architecture |
||
|---|---|---|
| .. | ||
| AddTests | ||
| AskFile | ||
| Document | ||
| Explain | ||
| Fix | ||
| OllieHere | ||
| README.md | ||
| Refactor | ||
| SendVerbatim | ||
| acme-ollie-ensure | ||
README.md
Ollie Acme Commands
These scripts integrate ollie with the acme text editor. They use the acme 9P filesystem to read selections and send prompts to ollie.
Prerequisites
- An active ollie session with
$sessionand$agentenvironment variables set - The
oscript in PATH - plan9port's
9pcommand
Commands
| Command | Selection Required | Description |
|---|---|---|
| OllieHere | No | Start or select an Ollie session for the current directory |
| AskFile | No | Describe and explain the current file |
| Explain | Yes | Explain the selected code |
| Document | Yes | Add documentation comments to selected code |
| Fix | Yes | Fix issues in the selected code |
| Refactor | Yes | Refactor the selected code |
| AddTests | Yes | Write unit tests for the selected code |
| SendVerbatim | Yes | Send selection as-is (wrapped in code fence) |
Installation
Add the scripts directory to your PATH or symlink them to a directory in PATH:
export PATH="$PATH:/path/to/ollie/data/scripts/acme"
Or symlink individual commands:
ln -s /path/to/ollie/data/scripts/acme/* ~/bin/
Usage
-
Start an ollie session and set environment:
eval $(o env mysession myagent) -
In acme, add the commands to your window's tag:
OllieHere AskFile Explain Fix Refactor Document AddTests SendVerbatim -
For commands requiring selection, select text first, then middle-click the command.
Example Tag
$HOME/project/main.go Del Snarf Undo Put | AskFile Explain Fix Refactor