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 agentoption progress falseoption skill-path ./skillsoption attribution-trailer-style assisted-byoption 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 namesoption 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 completionsoption 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 200These skill paths load by default — you do NOT need skill-path for them: .agents/skills, .crush/skills, .claude/skills, .cursor/skills.
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
