Database and API for enhancing command line history, common paths and files, and clipboard handling.
The server is configured via environment variables.
RITUAL_PORT: set this to the TCP port you want to listen on.
- Defaults to 7483 ("RITE" on a telephone's keypad).
RITUAL_VERBOSE: set this to '1' (or anything except the empty string) to increase the logging threshold to 'debug'.
- Defaults to 'info'.
RITUAL_HOST: set this to the IPv4 address to listen on.
- Defaults to '127.0.0.1'.
Load bash integration by putting the following in your
~/.bashrc or somewhere:
Run at load:
cp install/github.chbrown.ritual.plist ~/Library/LaunchAgents/github.chbrown.ritual.plist launchctl load ~/Library/LaunchAgents/github.chbrown.ritual.plist
When running under
launchctl, there are two useful commands:
To kill the ritual server process until the next system boot:
launchctl remove github.chbrown.ritual
To restart it:
launchctl stop github.chbrown.ritual
stop kills the current process, but
launchd will immediately restart it since the
launchd config file,
KeepAlive set to
Meanwhile, bash makes TCP requests easy with its
echo 'hello' > /dev/tcp/<host>/<port> syntax.
The Ritual TCP server is obligated to return one (new)line for every line that it receives. If it does not, the client may hang, waiting for a response.
Ideas / TODO
- Maybe load top 10 paths into
- Smarter path selection (right now it only selects the most recent exact match)
- Exclude current path from candidates
- Weight directories that have been recently used higher
- Weight directories that have been frequently used higher
- Add weight for directories successfully fetched with
jor, more generally,
- Add clipboard watching
- Add shell history watching
- Prune directories that don't exist, or maybe just skip them in case they are mounted directories that may exist again.
- There are a lot of good ideas on the iTerm2 shell integration page which seem to me like overkill for a terminal GUI, and much more suited to a third party service (like ritual).
- Maybe use a coproc in the shell script instead of kicking off a new subshell whenever the bash user enters a ritual command?
Want to grab the matching directories for several queries at once?