controlplane-ai

CLI for distributing the ControlPlane AI framework into any project. One command gives your AI agents (Claude Code, Cursor, Copilot) consistent engineering behavior — structured workflows, enforced standards, and plan-then-execute discipline.

Install

Requires Node.js 18+.

npx controlplane-ai init

No global install needed. Run with npx and the framework files are copied into your project. On the first AI session, ControlPlane AI auto-detects your tech stack and generates repo-specific conventions.

Commands

init

npx controlplane-ai init [directory]

Initialize the framework in a project. Copies AGENTS.md, agent adapter files, and the .agent/ directory into the target. Adds managed entries to .gitignore. Safe to run in an existing project — prompts before overwriting.

update

npx controlplane-ai@latest update [directory]

Update framework files to the latest version. Detects which files have changed upstream and replaces them. Preserves repo-specific files (repo-map.md, repo-specific-index.md, plans, briefs). Use @latest to pull the newest package version first.

validate

npx controlplane-ai validate [directory]

Check framework files for local modifications. Compares installed files against their expected hashes and reports any that have been manually edited. Useful for ensuring framework integrity before an update.

uninstall

npx controlplane-ai uninstall [directory]

Remove all ControlPlane AI framework files from a project. Cleans up AGENTS.md, adapter files, the .agent/ directory, and the managed .gitignore section.

How it works

The CLI distributes a set of markdown files that AI agents read on session start:

• AGENTS.md — Universal behavioral rules (all agents read this)
• Adapter files — Thin pointers for each tool (CLAUDE.md, .cursor/rules/, .github/copilot-instructions.md)
• .agent/ — Skills, commands, and templates loaded on demand

After init, no further CLI interaction is required. Your AI agents pick up the framework automatically.

License

MIT