CHEAT SHEET
Usage, detailed features, commands and keybindings of crush
CLI OVERVIEW
Crush comes with useful CLI that have good flags that will help you while you use it.
USAGE
crush [command] [--flags]
EXAMPLES
# Run in interactive mode
crush
# Run with debug logging
crush -d
# Run with debug logging in a specific directory
crush -d -c /path/to/project
# Print version
crush -v
# Run a single non-interactive prompt
crush run "Explain the use of context in Go"
# Run in dangerous mode (auto-accept all permissions)
crush -y
COMMANDS
| Command | Description |
|---|---|
completion [command] | Generate the autocompletion script for the specified shell |
help [command] | Help about any command |
logs [--flags] | View crush logs |
run [prompt...] | Run a single non-interactive prompt |
GLOBAL FLAGS
| Flag | Alias | Description |
|---|---|---|
--cwd | -c | Current working directory |
--debug | -d | Enable debug mode |
--help | -h | Show help |
--version | -v | Print version for Crush |
--yolo | -y | Automatically accept all permissions (dangerous mode) |
SUB COMMANDS
COMPLETION SUB-COMMAND
You can add crush cli commands auto completion for your shell. We support: bash, fish, powershell, zsh.
crush completion bash
crush completion fish
crush completion powershell
crush completion zsh
USAGE
crush completion [command] --flags
FLAGS:
| Flag | Alias | Description |
|---|---|---|
--cwd | -c | Current working directory |
--debug | -d | Enable debug mode |
--help | -h | Show help for completion command |
RUN SUB-COMMAND
If you don't want to run the whole TUI and just need a quick single prompt, the run command is for you.
RUN A SIMPLE PROMPT:
crush run Explain the use of context in Go
PIPE INPUT FROM STDIN:
echo "What is this code doing?" | crush run
RUN WITH QUIET MODE (NO SPINNER)
crush run -q "Generate a README for this project"
USAGE
crush run [prompt ...] [--flags]
FLAGS
| Flag | Alias | Description |
|---|---|---|
--cwd | -c | Current working directory |
--debug | -d | Enable debug mode |
--help | -h | Show help for run command |
--quiet | -q | Hide spinner |
LOGS SUB-COMMAND
You can view the logs generated by Crush. This command allows you to monitor and debug by inspecting the log output.
USAGE
crush logs [--flags]
FLAGS
| Flag | Alias | Description |
|---|---|---|
--cwd | -c | Current working directory |
--debug | -d | Enable debug mode |
--follow | -f | Follow log output |
--help | -h | Show help for logs command |
--tail | -t | Show only the last N lines (default: 1000) |
TUI OVERVIEW
The Crush TUI provides a set of keyboard shortcuts and commands that make it faster and easier to interact with the assistant directly from your terminal.
KEYBINDINGS
Keybindings are the main shortcuts you can use inside the TUI to quickly perform actions without leaving the keyboard.
GENERAL
| Keybinding | Action |
|---|---|
Tab | Focus the chat panel |
Shift+Enter | Insert a newline without sending the message |
NAVIGATION
| Keybinding | Action |
|---|---|
Ctrl+G | Toggle between less (when opened) and more (when closed) |
Ctrl+P | Open the commands palette |
Ctrl+F | Add an image to the chat |
SESSIONS
| Keybinding | Action |
|---|---|
Ctrl+S | Manage sessions / add a file |
Ctrl+N | Create a new session |
Ctrl+O | Open the editor |
COMMANDS
The commands palette (opened with Ctrl+P) allows you to access higher-level actions inside the TUI.
| Command | Keybinding | Description |
|---|---|---|
| New Session | Ctrl+N | Create a new session |
| Switch Session | Ctrl+S | Switch between sessions |
| Switch Model | — | Change the active AI model |
| Summarize Session | — | Generate a summary of the session |
| Toggle Sidebar | — | Show or hide the sidebar |
| Open File Picker | Ctrl+F | Open the file picker |
| Toggle Yolo Mode | Ctrl+G | Enable/disable dangerous mode |
| Toggle Help | — | Show or hide help inside the TUI |
| Initialize Project | — | Initialize project in current folder |
| Quit | Ctrl+C | Exit Crush |