Methodology · CLI · TUI · Community
A personal AI Constitution.
Installable. Portable. Auditable.
ai turns the four-file personal AI Constitution
(Constitution.md · Common.md ·
Code.md · Writing.md) into a product.
Install it. Answer a guided interview. Have a personalized
constitution governing every AI tool on your machine — within
thirty minutes.
What ships
CLI surface
ai setup, ai review,
ai doctor, ai sync,
ai restore, ai mode,
ai profile, ai persona,
ai skills, ai hooks,
ai settings, ai issue file — every
verb from the spec is on a single binary.
Bubble Tea wizard
A guided interview that produces a personalized
Constitution.md with no fabrication. Every
question offers presets, a free-text answer, or a "chat with
the assistant" handoff.
Atoms ecosystem
Personas, profiles, skills, and brand identity are versioned,
immutable, content-addressable atoms — fetched from four
public registries (persona-atoms.com,
profile-atoms.com, skill-atoms.com,
brand-atoms.com) and cached locally.
Cross-tool enforcement
The command-wrapper facade enforces governance at the
command layer (git, gh,
opt-in terraform / kubectl) — so
Claude Code, Copilot CLI, Cursor, and human shell sessions
all get the same hooks regardless of which tool issued the
command.
Audit by default
Every override, every self-noticed violation, every focus
change leaves a permanent typed record under
~/.ai/audit/. Local-only. Never synced raw.
Self-repairing
ai doctor detects and fixes the predictable
failure modes — broken symlinks, missing hooks, dirty
working tree, stale binary — without conversation.
Status
Draft v0.8 — implementation in progress
This site, the CLI binary, the hook library, and the atom registries are being built in parallel. The authoritative spec is current at draft v0.8. Source lives at github.com/convergent-systems-co/aiConstitution.