Skip to main content
devw compile
Reads your .dwf/ rules and generates output for each configured tool using the appropriate bridge. Also deploys installed assets (commands, templates, hooks).

​
Output by Tool

ToolOutput File
Claude CodeCLAUDE.md
Cursor.cursor/rules/devworkflows.mdc
Gemini CLIGEMINI.md
Windsurf.windsurf/rules/devworkflows.md
VS Code Copilot.github/copilot-instructions.md

​
Asset Deployment

During compilation, installed assets are also deployed:
Asset TypeSourceOutput
Commands.dwf/assets/commands/*.md.claude/commands/*.md (frontmatter stripped)
Templates.dwf/assets/templates/*.mddocs/specs/*.md (frontmatter stripped)
Hooks.dwf/assets/hooks/*.json.claude/settings.local.json (deep-merged)

​
Flags

FlagDescription
--tool claudeCompile only a specific bridge
--dry-runShow output without writing files
--verboseShow detailed output

​
Markers

When compiling to markdown-based outputs (CLAUDE.md, GEMINI.md, .github/copilot-instructions.md), the generated content is wrapped in <!-- BEGIN dev-workflows --> and <!-- END dev-workflows --> markers. This means you can have manual content in your CLAUDE.md and dev-workflows will only replace the section between markers. Your hand-written rules are preserved.

​
Examples

# Compile all configured tools
devw compile

# Preview output without writing
devw compile --dry-run

# Compile only Claude bridge
devw compile --tool claude