Crush cheat sheet

Every command, flag and slash command for crush — Charm's glamourous open-source terminal coding agent (Go) — LSP-aware, MCP-ready, many providers. 8+ commands, verified July 2026.

Watch the flags: -c is --cwd, not continue. Continue-most-recent is -C; continue-by-id is -s. And crush.json is trusted code — $(…) expressions run at load time, so never launch Crush in a directory whose crush.json you have not reviewed.

Install

brew install charmbracelet/tap/crush             # Homebrew
npm install -g @charmland/crush                   # npm
go install github.com/charmbracelet/crush@latest  # Go
winget install charmbracelet.crush                # Windows

Start & run

crush                                # interactive TUI
crush run "explain this codebase"    # headless: one prompt, then exit
cat README.md | crush run "…"        # pipe stdin as context
crush run -m anthropic/claude-sonnet-4-5 "…"   # pick the model
crush -C                             # continue the most recent session
crush -y                             # yolo: auto-accept all prompts

Flags & subcommands

Flag / cmd	What it does
`run [prompt]`	Non-interactive prompt (accepts args and/or stdin)
`-C, --continue`	Resume the most recent session
`-s, --session <id>`	Continue a specific session by id
`-c, --cwd <path>`	Set the working directory (⚠ not continue)
`-y, --yolo`	Auto-accept ALL permission prompts (dangerous)
`-q, --quiet` / `-v, --verbose`	(run) hide the spinner / show logs
`crush logs [--follow]`	View / stream logs
`crush update-providers`	Refresh the provider / model catalog

In the TUI: Ctrl+L opens the model picker, Ctrl+P the commands palette. Pick the launch model with crush run -m ….

Config

// priority: .crush.json → crush.json → ~/.config/crush/crush.json
{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "anthropic": { "type": "anthropic", "api_key": "$ANTHROPIC_API_KEY" }
  },
  "lsp": { "go": { "command": "gopls" } },
  "mcp": { "filesystem": { "type": "stdio", "command": "npx",
           "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] } }
}

Common one-liners

crush run -q "summarize the changes in the last commit"     # clean output
git diff --staged | crush run "write a conventional-commit message"
crush run -y "add a README section documenting the CLI flags"
crush -C                                                    # back to last session