Skip to main content
Use init after package install or when setup needs repair. The command scaffolds config, schema directories, migration directories, canonical supaschema:* package scripts, package-owned active AI-agent enforcement under .agents, .claude, and .codex, and path-confirmation state. It does not write AGENTS.md or CLAUDE.md.

​
Use this when

  • supaschema was installed in a project that has not been set up yet.
  • supaschema.config.json should be repaired from the canonical contract.

​
Run it

Existing config files are left untouched unless --repair is passed.

​
Flags

​
boolean
Print the scaffold or repair plan without writing files.
​
boolean
Print the init result as redacted JSON.
​
boolean
Rewrite supaschema.config.json from the canonical contract when needed.

Installation

Add supaschema to a project.

Setup

Confirm generated paths and files.

What's included

See the package and agent surfaces.

Config validate

Check the generated config.
Last modified on June 24, 2026