ai-policy-pack-cli
v0.1.5
Published
Multi-IDE AI policy pack generator for Cursor, Copilot, Antigravity, and Claude
Maintainers
Readme
AI Policy Pack CLI
ai-policy-pack-cli is a multi-IDE policy generator that renders instruction files for:
- Cursor (
.cursor/rules/*.mdc) - GitHub Copilot (
.github/copilot-instructions.md,.github/instructions/*.instructions.md) - Antigravity (
AGENTS.md, optionalGEMINI.md) - Claude-compatible tools (
CLAUDE.md)
The CLI uses one canonical policy preset and maps it into each target format.
Quick Start
npx ai-policy-pack-cli installNon-interactive mode:
npx ai-policy-pack-cli install --targets cursor,copilot,antigravity,claude --yesCommands
Install
npx ai-policy-pack-cli install [--targets cursor,copilot,antigravity,claude] [--preset anhtdq] [--yes] [--dry-run]- Generates target files from preset
- Writes
.ai-policy/manifest.jsonfor tracking
Verify
npx ai-policy-pack-cli verify- Re-renders expected output from manifest
- Fails if generated files drifted
- Suitable for CI checks
Update
npx ai-policy-pack-cli update [--preset anhtdq] [--yes] [--dry-run]- Re-applies current targets from manifest
- Refreshes files and manifest hashes
Presets
Current default preset:
presets/anhtdq/policy.yml
Preset layout:
globalRules: shared guardrailsfileRules: per-pattern rulestargetOverrides: optional target-specific instructions
CI Integration
Example GitHub Actions step:
- name: Verify AI policy files
run: npx ai-policy-pack-cli verifyDevelopment
npm install
npm run build
npm testRelease Guidance
- Use semantic versioning for policy and renderer changes
- Treat generated-file shape changes as minor or major depending on compatibility impact
- Keep changelog entries grouped by target (
cursor,copilot,antigravity,claude)
