CLI Reference

In addition to its interactive TUI, Crush provides a full command-line interface for automation, scripting, and management tasks.

Global Flags

These flags work with most Crush commands:

Flag	Short	Description
`--session`	`-s`	Continue a previous session by ID
`--continue`	`-C`	Continue the most recent session
`--host`	`-H`	Connect to a specific Crush server host
`--data-dir`	`-D`	Custom Crush data directory
`--cwd`	`-c`	Set the current working directory
`--debug`	`-d`	Enable debug logging
`--yolo`	`-y`	Enable YOLO mode (no permission prompts)

Command	Description
`crush run`	Run a single non-interactive prompt
`crush session`	Manage sessions (list, show, delete, rename)
`crush models`	List all available models
`crush login`	Authenticate with a platform
`crush logout`	Sign out from a platform
`crush stats`	Show usage statistics
`crush logs`	View application logs
`crush update-providers`	Update provider model listings
`crush projects`	List project directories
`crush dirs`	Show config and data directories
`crush server`	Start the Crush server

List all project directories where Crush has stored data:

bash

crush projects

Use --json for machine-readable output.

Show where Crush stores its configuration and data:

bash

crush dirs

Start a Crush server for remote connections:

bash

crush server --host localhost:8080

The server allows multiple clients to connect to a shared Crush instance.