ctrlai
v1.0.0
Published
Install a Ctrl AI Practice into your instruction file — HTTPS-only, validated and re-hashed locally, never executes anything.
Readme
ctrlai
Install a Ctrl AI Practice into your AI's instruction file.
A Practice is a published, versioned, attributable way of handling one situation — written by someone who knows, usable by any AI. This CLI pins one into CLAUDE.md, AGENTS.md, or .cursorrules, exactly and reversibly.
npx ctrlai use https://ctrlai.com/rado/how/brief-an-ai-agent --file CLAUDE.md
npx ctrlai check --file CLAUDE.md # pin vs latest, diff shown, never auto-updates
npx ctrlai remove <practiceId> --file CLAUDE.mdWhat it promises:
- HTTPS-only, and the Practice is validated against its published schema and re-hashed locally — a payload whose bytes don't match its content hash is refused.
- A diff before writing, confirmation required (
--dry-runnever writes;--yesfor scripts). - Everything outside the managed region is preserved byte-for-byte; re-applying is idempotent;
removedeletes only the region. - It never executes anything a Practice contains — no code fences, no links followed, no tools called.
- Updates are consent:
checkshows what changed upstream and asks; your pin never moves silently.
The wire format is public: ctrlai.com/spec/practice/v0.1. Reading, fetching, and adapting any Practice is free and needs no account.
— Ctrl AI: a public commons of versioned, attributable human practice.
