Crush — Rules

File format

Markdown

Discovery path

AGENTS.md

Syllago install method

Project scope, Direct copy

Symlink support

Yes

Features

How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.

Other features

Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.

Feature	Conversion	Summary
cross_provider_recognition	Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more →	Crush reads AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md (and .local variants) as context files. The active filename is controlled by the initialize_as option (default: AGENTS.md); context_paths allows configuring an arbitrary list of additional file paths.
CRUSH.md Crush-specific variant	Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more →	Crush additionally recognizes a project-scope CRUSH.md file as a Crush-specific rules variant alongside the cross-provider AGENTS.md convention.
Multi-provider context file recognition	Preserved Conversion type: Preserved Syntax survives conversion but the target provider may not interpret it. Learn more →	Crush reads AGENTS.md, CRUSH.md, CLAUDE.md, and GEMINI.md (plus .local variants) as context files, enabling rules written for other providers to be loaded without modification.
Configurable context_paths and initialize_as	Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more →	The crush.json options block supports context_paths (an array of additional file paths to load as context) and initialize_as (sets the default rules filename, e.g. AGENTS.md, CRUSH.md, CLAUDE.md). This allows teams to direct Crush at arbitrary rule file locations.

Sources

Source
https://raw.githubusercontent.com/charmbracelet/crush/main/AGENTS.md