Options

Configure general Crush behavior, paths, attribution, and the terminal UI. Boolean values are optional and default to true.

Usage:
  option <key> [value]
  option [command]

Available Commands:
  reset     Clear every value from a list option
  ui        Configure terminal UI behavior

Boolean Keys:
  debug                          enable debug logging
  debug-lsp                      enable LSP debug logging
  auto-lsp                       automatically configure language servers
  progress                       show progress indicators
  metrics                        send anonymous usage metrics
  auto-summarize                 automatically summarize long conversations
  provider-auto-update           update the provider catalog automatically
  default-providers              include built-in providers
  attribution-generated-with     add the Generated with Crush line

String Keys:
  data-directory string            directory for project data and state
  initialize-as string             context filename created by crush init
  notifications string             notification style: auto, native, osc, bell,
                                   or disabled
  attribution-trailer-style string attribution trailer: none, co-authored-by,
                                   or assisted-by

Integer Keys:
  request-timeout int              seconds before an LLM request is aborted;
                                   streaming responses are only aborted after
                                   this much inactivity; 0 waits forever
                                   (default 60)

List Keys:
  context-path string             append a project context path
  global-context-path string      append a global context path
  skill-path string               append a skill directory
  disable-skill string            hide a skill from the agent

option progress false
option skill-path ./skills
option attribution-trailer-style assisted-by

option reset

Clear every value previously added to a list option. Values added after the reset are kept.

Usage:
  option reset <key>

Available Keys:
  context-path          clear project context paths
  global-context-path   clear global context paths
  skill-path            clear additional skill directories
  disable-skill         clear disabled skill names

option ui

Configure terminal UI presentation and completion-list limits.

Usage:
  option ui <key> <value>

Available Keys:
  compact bool                  use the compact chat layout
  diff unified|split            choose unified or side-by-side diffs
  transparent bool              use the terminal background
  mouse bool                    enable terminal mouse capture for clicks,
                                selection, and scrolling in the TUI (default
                                true); disable to let the terminal emulator
                                or tmux handle text selection and copy/paste
  scrollbar string              control chat scrollbar visibility: default,
                                always, or never
  exit-banner default|compact|none
                                control the post-session banner: default shows
                                the Crush logo, compact shows only the resume
                                hint, none hides it entirely
  completions-max-depth int     maximum directory depth shown by completions
  completions-max-items int     maximum items returned to completions

option ui compact true
option ui diff unified
option ui transparent true
option ui mouse false
option ui scrollbar always
option ui exit-banner compact
option ui completions-max-depth 4
option ui completions-max-items 200

IMPORTANT

These skill paths load by default — you do NOT need skill-path for them: .agents/skills, .crush/skills, .claude/skills, .cursor/skills.

NOTE

The command palette's "Disable Background Color" and "Disable Mouse" toggles always write to the global config. If a project config also sets transparent or mouse, project settings win on the next launch (see Where config lives), so the toggle can look like it silently reverted.