ollie/data/scripts/acme/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 $session and $agent environment variables set
• The o script in PATH
• plan9port's 9p command

Commands

Command	Selection Required	Description
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

1. Start an ollie session and set environment:

   eval $(o env mysession myagent)
   

2. In acme, add the commands to your window's tag:

   AskFile Explain Fix Refactor Document AddTests SendVerbatim
   

3. 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