Project Commands

brain project init

Initializes project-brain in the current directory. Always the first command to run.

brain project init

brain project

Step-by-step CLI demo: init, analyze

What it creates

.brain/              ← data directory
.brain/cache/        ← explanation cache (avoids repeated LLM calls)
.brain/data.json     ← AST analysis output (populated by analyze)
.brain/index.json    ← file index
brain.yaml           ← configuration file (all defaults pre-filled)

Tip

Safe to re-run. Existing files and directories are preserved — only missing pieces are created.

Next step

brain project analyze .

← brain.yaml Config brain project analyze →