ait init
Create or reinitialize AIT repository authority and effective agent instructions.
Audience: Users
Role#
Normally run by the user once from the repository that a coding agent will change.
Purpose#
ait init creates missing local repository authority and creates or refreshes the effective AIT workflow block in AGENTS.md. Reinitialization preserves valid existing authority instead of replacing it.
Syntax#
ait init
ait init --jsonImportant optional inputs include the initial repository name, default Line, policy profile, author mode, and a bounded repair flag for incomplete existing structure. Ordinary first use needs no option.
Example#
cd ~/src/example-app
ait initAfter success, open AGENTS.md or run ait config show to inspect the effective workflow routing. Initialization does not start ait-server and does not infer a programming language or validation command.
Output#
Text output summarizes the created or preserved repository and guidance. JSON is the stable machine-readable result for automation.
Failure and recovery#
If the directory contains malformed or partial AIT state, keep the error and inspect the existing .ait structure before using a repair option. Never replace authority merely to make initialization succeed.