crush

Start an interactive session

$ crush

$ crush --cwd [path/to/project]

$ crush --yolo

$ crush --debug

$ crush --data-dir [path/to/data]

$ crush logs

$ crush logs --follow

$ crush run "[fix the bug in main.go]"

crush [options] [command]

Crush is a glamorous AI coding agent for your terminal, developed by Charmbracelet. Built in Go for speed and efficiency, it provides a terminal user interface (TUI) for interacting with various AI models to help with coding tasks, debugging, and file operations.
Crush supports multiple AI providers including OpenAI, Anthropic, Google Gemini, Groq, OpenRouter, AWS Bedrock, and local models via Ollama and LM Studio. It uses Language Server Protocol (LSP) for enhanced code context and is extensible via Model Context Protocol (MCP) servers with stdio, http, and sse transports.
The tool offers excellent cross-platform compatibility, supporting macOS, Linux, Windows (PowerShell and WSL), FreeBSD, OpenBSD, and NetBSD. Configuration is stored in JSON files with settings for providers, LSP, MCP servers, and permissions.

--cwd PATH

Change to a specific directory before starting

Override the default data directory location

Enable debug logging for troubleshooting

Skip all permission prompts (dangerous, use with caution)

Display help information

Show version number

run PROMPT

Run Crush in non-interactive mode with a prompt

Print the last 1000 lines of logs

Print the last N lines of logs

Follow logs in real time

Requires API keys from supported providers set via environment variables (ANTHROPICAPIKEY, OPENAIAPIKEY, etc.) or configured in crush.json. The --yolo flag bypasses all permission prompts and should be used with extreme caution. Debug mode with --debug generates verbose logging.

Crush was developed by Charmbracelet, a company known for creating engaging terminal applications. It was previously known as OpenCode AI before being renamed to Crush. The project is released under the FSL-1.1-MIT license (MIT-compatible) and has gained over 8,900 GitHub stars. Version 0.4.0 was released in August 2025.

claude(1), opencode(1), aider(1), codex(1)