ollie/data/scripts/acme
Levi Neely a899f933fb acme-ollie-ensure: always update agent cwd
Match ollie-session-here behavior: update cwd for existing agents,
not just on creation. Ensures agent cwd reflects current project root
when invoked from a different context.
2026-10-07 15:24:46 +02:00
..
AddTests add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
AskFile add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
Document add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
Explain add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
Fix add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
OllieHere improve acme tools, fix focus stealing in kde gui 2026-08-16 16:00:59 +02:00
README.md improve acme tools, fix focus stealing in kde gui 2026-08-16 16:00:59 +02:00
Refactor add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
SendVerbatim add metrics queries and agent-scoped plans 2026-08-16 17:00:11 +02:00
acme-ollie-ensure acme-ollie-ensure: always update agent cwd 2026-10-07 15:24:46 +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
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

  1. Start an ollie session and set environment:

    eval $(o env mysession myagent)
    
  2. In acme, add the commands to your window's tag:

    OllieHere 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