Complete reference for all Codi commands, the Command Center, and the init wizard.

Command Center

Run codi with no arguments to launch the interactive Command Center. It uses @clack/prompts for a terminal UI with grouped actions.

The menu loops until you select Exit or press Ctrl+C. Actions that require a .codi/ directory are hidden until you initialize a project.

Setup: Initialize project, Add artifact, Generate configs, Manage presets
Build: Export skill, Contribute to community, Generate documentation
Monitor: Project status, Health check, Validate config, Verify agent awareness, Compliance report, CI checks, Clean generated files, Update templates, Revert to backup, Watch for changes, Update docs counts

Init Wizard

Launched by codi init (interactive mode) or from the Command Center. Guides you through 4 steps with backward navigation (Ctrl+C goes back, exits at step 1).

Steps

Keyboard Shortcuts

Command Reference

Setup Commands

codi init

Initialize a new .codi/ configuration directory.

codi init [options]

# Interactive wizard
codi init

# Non-interactive with specific agents and preset
codi init --agents claude-code cursor --preset balanced

codi add <type> [name]

Add resources to the .codi/ configuration. Supported types: rule, skill, agent, brand, mcp-server.

codi add <type> [name] [options]

When name is omitted in interactive mode, launches a search wizard.

codi add rule security --template security
codi add skill my-workflow
codi add rule --all
codi add mcp-server memory --template memory

codi generate

Generate agent configuration files from .codi/. Alias: gen.

codi generate [options]

codi generate --agent claude-code --dry-run
codi gen --force
codi generate --on-conflict keep-incoming   # overwrite any local edits
codi generate --on-conflict keep-current    # preserve all local edits, skip incoming

Pruning: codi generate automatically deletes generated files that no longer exist in the source templates. Files with local edits are preserved unless you pass --on-conflict keep-incoming or --force.

codi preset <subcommand>

Manage configuration presets.

codi preset install github:org/repo
codi preset export my-setup --format zip --output ./dist
codi preset list --builtin

Monitoring Commands

codi status

Show drift status for generated agent files. Reports in-sync, drifted, and missing files.

codi status [--diff]

codi doctor

Check project health: config validity, version compatibility, hook installation, drift detection. With --hooks, switches to a per-hook tool availability diagnostic.

codi doctor [options]

codi validate

Validate the .codi/ configuration against schemas.

codi validate

codi verify

Verify that an agent loaded its configuration correctly. Shows the verification token, rules, skills, agents, and flags.

codi verify [options]

# Show expected verification data
codi verify

# Validate agent response
codi verify --check "codi-abc123"

codi compliance

Run full compliance report: doctor + status + verification combined.

codi compliance [options]

codi ci

Composite CI validation. Runs validate + doctor --ci and reports combined results. Exits non-zero on any failure.

codi ci

codi watch

Watch .codi/ for changes and auto-regenerate agent configs. Requires auto_generate_on_change flag to be enabled.

codi watch [options]

Operation Commands

codi update

Update flags and template-managed artifacts to latest versions. Always auto-regenerates after update.

codi update [options]

codi update --rules --skills
codi update --preset strict --dry-run
codi update --from org/shared-config
codi update --skills --on-conflict keep-incoming   # accept upstream changes

codi clean

Remove generated agent config files. Without --all, preserves .codi/ and hooks.

codi clean [options]

codi revert

Restore generated files from a previous backup. Backups are created automatically on each generate.

codi revert [options]

codi revert --list
codi revert --last

codi skill <subcommand>

Manage skills: export, feedback, stats, evolve, versions.

Onboarding

codi onboard

Print an AI-guided onboarding guide to stdout. The guide contains three sections: a full artifact catalog, a built-in presets reference, and a step-by-step agent playbook.

The intended workflow: tell your coding agent to run codi onboard, and the agent reads the output, explores your codebase, recommends a preset and artifact selection, iterates with you until approved, then executes the full setup.

codi onboard

Community Commands

codi contribute

Interactive wizard to share artifacts via GitHub PR or ZIP export.

codi contribute [--repo <owner/repo>] [--branch <name>]

codi docs

Generate and validate documentation.

codi docs [options]

Global Options

Available on all commands.

Exit Codes