concept⌗

acme is the integrating development environment. its philosophy allows for powerful navigation without the use of scripting languages, addons, extensions, plugins.

instead it extends itself through being the OS through a specific tool called plumber.

plumber⌗

what plumber does is match your acme button 3 clicks to a set of rules, and execute a shell command. this is immensely powerful.

technically, any editor can do this, but none do it as elegantly as acme does it.

you see, acme depends on the mouse for navigation of files, directories, and in general the editor it self. you left click(button 1) to select, middle click(button 2) to execute a command, right click(button 3) to search through text or plumb.

to demonstrate how powerful this is, check out the underlying gif:

to add rules to plumber, you create a file in $HOME/lib/plumber and follow the syntax defined in plumb(7).

if you want to change the location of the configuration, edit lines :56 :60 in plumb/plumber.c - or launch plumber with argument -p "$FILEPATH"

if you want to be inspired check one of these plumbing configurations:

usage⌗

after you finish configuring plumber, just launch plumber, and afterwards launch acme

troubleshooting⌗

either your regexp is bad(plumber would exit in this case), or the order is messed up(rules should preceed include statements)

in either case, use 9p write plumb/send "your string here" to troubleshoot