Skip to main content
AlignTrue CLI|Open Source|MIT License

Install AlignTrue CLI

Start in 60 seconds. Write rules once & sync to 20+ agents with aligntrue sync.

1
Install
$npm install -g aligntrue

Install once to manage AI agent rules (Cursor .mdc, AGENTS.md, CLAUDE.md, etc.).

2
Init & sync
$aligntrue init

Auto-detects existing rules, imports them, and syncs or creates smart defaults.

Other install options

Use your preferred package manager or run one-off commands without a global install. See the full install guide here.

$npm install -g aligntrue
One-off or CI-friendly run
$npx aligntrue init

Recommended for most Node.js environments.

Prerequisites
  • Node.js 20+ — download
  • An AI coding agent — see supported agents.
  • Git (optional) if you plan to import rules from remote sources.
FAQ
How long does setup take?

Under 60 seconds: npm install -g aligntrue → aligntrue init → aligntrue sync. Init auto-detects agent files and writes config plus exports.

What if I already have agent configs?

Run aligntrue init in your repo. It finds existing agent files, offers to import them into .aligntrue/rules, and syncs exports on next run.

AlignTrue command not found

Install globally (npm/yarn/pnpm/bun) or run via npx/bunx. If globally installed, ensure your global bin directory is on PATH.

Do I need to install anything else?

Just Node.js 20+ and an AI agent (Cursor, GitHub Copilot, Claude Code, etc.). AlignTrue works offline after install.

Does AlignTrue require network access?

No, it is local-first. Network is only used when you opt to pull rules from remote git sources (e.g., aligntrue init --source <repo>).