Options

Configure general Crush behavior, paths, attribution, and the terminal UI.

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 behaviorBoolean Keys:  debug                          enable debug logging  debug-lsp                      enable LSP debug logging  auto-lsp                       automatically configure language servers  progress                       show progress indicators  pinentry-integrated            render GPG passphrase prompts as a native                                 Crush dialog instead of an external                                 pinentry program; never modifies GPG or                                 git configuration (default true)  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 lineString 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-byInteger Keys:  request-timeout int              seconds before an LLM request is aborted;                                   streaming responses are only aborted after                                   this much inactivity between tokens, while                                   the wait for the first token gets at least                                   five minutes; 0 waits forever                                   (default 60)  max-background-jobs int          background shell jobs allowed to run at                                   once; finished jobs never count against it                                   (default 50)  pinentry-cache-timeout int       seconds Crush keeps an entered GPG                                   passphrase in memory so repeated signing                                   does not re-prompt; 0 disables it                                   (default 0)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 falseoption skill-path ./skillsoption 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 trueoption ui diff unifiedoption ui transparent trueoption ui mouse falseoption ui scrollbar alwaysoption ui exit-banner compactoption ui completions-max-depth 4option ui completions-max-items 200
Warning

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.

Read this post in your terminal with glow:glow -p https://crush.charm.land/configuration/options.md

EOF