Pay Respects

Typed a wrong command or don't know what to do? Pay Respects will suggest a fix to your console command by simply pressing F!

• 🚀 Blazing fast suggestion: You won't notice any delay for asking suggestions!
• 🎯 Accurate results: Suggestions are verified before being prompted to the user, no sudo suggestions when you are using doas!
• ✏️ Easy to write rules: You don't need to know Rust. The rules are written in a TOML file!
• 🔩 Modular: TOML not your taste? Add sources using your favorite language with a custom module!
• 🤖 AI Support: AI module comes in aid when there is no rule for your error!
• 🪶 Tiny binary size: Not even 1MB for core features!

How to Pay Respects

Please follow the instruction for your shell:

Append the following line to your configuration file (--alias no longer required for v0.7+):

eval "$(pay-respects bash --alias)"
eval "$(pay-respects zsh --alias)"
pay-respects fish --alias | source

Arguments:

• --alias [alias]: Alias to a custom key, defaults to f
• --nocnf: Disables command_not_found handler

Manual aliasing (REMOVED after v0.7):

alias f="$(pay-respects bash)"
alias f="$(pay-respects zsh)"
alias f="$(pay-respects fish)"

Add the following output to your configuration file:

pay-respects nushell --alias [<alias>]

Or save it as a file:

pay-respects nushell --alias [<alias>] | save -f ~/.pay-respects.nu

and source from your config file:

source ~/.pay-respects.nu

Append the following output to your profile:

pay-respects pwsh --alias [<alias>]

Or directly pipe the output to your profile:

pay-respects pwsh --alias [<alias>] >> $PROFILE

pay-respects only requires 2 environment variables to function:

• _PR_SHELL: The binary name of the current working shell.
• _PR_LAST_COMMAND: The last command.

pay-respects echos back, if applicable, a cd command that can be evaluated by the current working shell.

General example:

eval $(_PR_SHELL=sh _PR_LAST_COMMAND="git comit" pay-respects)

Following variables are not required, but can be used to reduce unnecessary operations:

• _PR_ALIAS: A list of aliases to commands. Separated by newlines with zsh-like formatting, e.g. gc=git commit
• _PR_ERROR_MSG: Error message from the previous command. pay-respects will rerun previous command to get the error message if absent
• _PR_EXECUTABLES: A space separated list of commands/executables. pay-respects will search for $PATH if absent

• _PR_LIB: Directory of modules, analogous to PATH. If not provided, search in PATH or compile-time provided value.
• _PR_PACKAGE_MANAGER: Use defined package manager instead of auto-detecting alphabetically

You can specify different modes to run with _PR_MODE:

• noconfirm: Execute suggestions without confirm
• echo: Print suggestions to stdout without executing
• cnf: Used for command not found hook

Example usage with noconfirm:

function ff() {
	(
		export _PR_MODE="noconfirm"
		f
	)
}

You can now press F to Pay Respects!

Installing

Install from your package manager if available:

OS / Distribution	Repository	Instructions
Arch Linux	AUR	paru -S pay-respects (-bin)
Arch Linux (ARM)	Arch Linux CN	sudo pacman -S pay-respects
MacOS / Any	timescam	brew install timescam/homebrew-tap/pay-respects
NixOS / Any	nixpkgs	nix-env -iA nixos.pay-respects

Alternatively, install pre-built binaries from GitHub releases. An install script is available:

curl -sSfL https://raw.githubusercontent.com/iffse/pay-respects/main/install.sh | sh

This installation requires you to have Cargo (the Rust package manager) installed.

Install from crates.io, modules are optional

cargo install pay-respects
cargo install pay-respects-module-runtime-rules
cargo install pay-respects-module-request-ai

Clone from git and install, suitable for adding custom compile-time rules:

git clone --depth 1 https://github.com/iffse/pay-respects
cd pay-respects
cargo install --path core
cargo install --path module-runtime-rules
cargo install --path module-request-ai

Rules & Modules

See the following pages:

• Writing rules (TOML)
• Custom modules

AI Integration

Disclaimer: You are using AI generated content on your own risk. Please double-check its suggestions before accepting.

AI suggestions should work out of the box with request-ai module installed.

An API key is included with the source (your distribution might have stripped them out). It should always work unless I can no longer afford this public service or rate limits are reached. If it's useful to you, please share this project and spread the word. Also consider making a donation to keep its public usage alive:

AI usages and API configurations

Contributing

Current option to write rules should cover most of the cases.

We need more rule files, contributions are welcomed!

Also see development status for contribution opportunities.

This project is hosted at various sites, choose the one that suits you best:

• Codeberg
• GitHub
• GitLab

Licenses

• Binaries: AGPL-3.0
  • Core and modules
• Libraries: MPL-2.0
  • Parser and utils