Overview

Complete reference for all AlignTrue CLI commands.

Important: Markdown format distinction

Literate markdown (for authoring):

• Use fenced ```aligntrue blocks
• Commands: md lint, md compile, md format, md generate
• Files you create manually
• See Markdown authoring guide

Generated exports (created by AlignTrue):

• Use HTML comment markers (<!-- aligntrue:begin -->)
• Generated by: sync, import, exporters
• Files AlignTrue creates automatically
• Edit with: import command or sync --accept-agent

Quick reference:

• Author in .md files → use md commands
• Work with generated .md files → use import or sync
• Both formats are valid - they serve different purposes!

Command categories

Browse commands by category:

• Basic commands - Daily development (init, import, sync, check, backup)
• Development commands - Markdown authoring and adapter management
• Plugs commands - Stack-agnostic variable management
• Overlay commands - Selective rule modifications
• Team mode commands - Collaboration and drift detection
• Settings commands - Configuration and privacy

All commands

Quick lookup table for all CLI commands:

Quick examples

Initialize a new project:

aligntrue init

Sync rules to all configured agents:

aligntrue sync

Import existing Cursor rules:

aligntrue import --from cursor

Check rules for errors:

aligntrue check

Enable team mode:

aligntrue team enable

For detailed documentation on each command, browse the categories above or use the command table to jump directly to specific commands.