lkn
/
ollie
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
ollie/data/scripts/acme
History
Levi Neely abbd718e6a acme: add ollie integration commands 
Add acme scripts for interacting with ollie:
- AskFile: describe the current file
- Explain: explain selected code
- Document: add documentation comments
- Fix: fix selected code
- Refactor: refactor selected code
- AddTests: write unit tests for selection
- SendVerbatim: send selection as-is

Scripts use the acme 9P filesystem to read selections and pipe
prompts to ollie via 'o prompt'.

Also update justfile to install/uninstall the acme scripts.
 		2026-08-10 11:29:59 +02:00
..
AddTests acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
AskFile acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
Document acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
Explain acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
Fix acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
README.md acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
Refactor acme: add ollie integration commands 2026-08-10 11:29:59 +02:00
SendVerbatim acme: add ollie integration commands 2026-08-10 11:29:59 +02:00

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/user/project/main.go Del Snarf Undo Put | AskFile Explain Fix Refactor