guth-cli 0.1.0

Headless plugin discovery and dispatch for the Guth file manager.
Documentation

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 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.