Guth CLI

guth-cli is the headless companion to the Guth desktop file manager. It discovers UUIDv7-identified command plugins and dispatches them without a shell, making the same plugin tools available on desktop and headless Linux machines.

cargo install guth-cli
guth-cli plugins
guth-cli enable <plugin-uuid>
guth-cli sync -- help

Plugin manifests live in $XDG_DATA_HOME/guth/plugins, or ~/.local/share/guth/plugins when XDG_DATA_HOME is unset. The CLI does not persist plugin arguments, endpoints, sessions, or command output.

External plugins are trusted native commands, not sandboxed extensions. Guth CLI accepts only UUIDv7-named manifests and verified regular executables owned by the current user or root with safe permissions, then executes the already-verified file without a shell. Capabilities are descriptive declarations rather than permissions.

Installed plugins are disabled until enabled in Guth's plugin settings or with guth-cli enable <plugin-uuid>. Desktop and headless commands share the bounded $XDG_CONFIG_HOME/guth/enabled-plugins.conf state. Use guth-cli prune after removing plugins to discard stale enabled UUIDs.