# 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.
```bash
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.