Global Context Files

Crush automatically includes two files for cross-project instructions. Think of these are personal additions to the system prompt.

• ~/.config/crush/CRUSH.md: Crush-specific rules that would confuse other agentic coding tools. If you only use Crush, this is the only one you need to edit.

• ~/.config/AGENTS.md: generic instructions that other coding tools might read. Avoid referring to Crush-specific features or workflows here. You probably only care about this if you use multiple agentic coding tools and want to share instructions between them.

You can customize these paths with option global-context-path. Repeat the command to add multiple paths:

# Load a single markdown file.option global-context-path "~/path/to/custom/context/file.md" # Recursively load all Markdown files in the folder.option global-context-path "/full/path/to/folder/of/files/"

Ignoring Files

Crush respects .gitignore files by default, but you can also create a .crushignore file to specify additional files and directories that Crush should ignore. This is useful for excluding files that you want in version control but don't want Crush to consider when providing context.

The .crushignore file uses the same syntax as .gitignore and can be placed in the root of your project or in subdirectories.