Skip to content

CLI Reference ​

Crush is a TUI first, but the crush command has a few tricks for non-interactive use and day-to-day operations.

crush ​

Run Crush in the current directory. Useful flags:

FlagDescription
--yoloSkip all permission prompts. Be very, very careful.
--debugEnable debug logging
--cwd <path>Set the working directory (also keys the shared workspace)

crush serve ​

Run Crush as a shared backend that multiple clients can attach to. See Sessions & Workspaces for how clients group into workspaces.

crush logs ​

Print or follow Crush's logs:

bash
# Print the last 1000 lines
crush logs

# Print the last 500 lines
crush logs --tail 500

# Follow logs in real time
crush logs --follow

crush models ​

List available models, in the same <provider>/<id> form used by the configuration commands.

crush update-providers ​

Update the provider and model catalog from Catwalk:

bash
crush update-providers              # from Catwalk
crush update-providers https://…    # from a custom URL
crush update-providers embedded     # reset to the built-in catalog

More ​

Run crush --help (or any subcommand with --help) for the full list of commands and flags.