autonomous-init

CLI to initialize an autonomous AI OS project structure with CLAUDE.md and .ai/ mode files.

Usage

Option A — No install (run once with npx):

npx autonomous-init
npx autonomous-init --help
npx autonomous-init --dry-run

Option B — Install globally (use autonomous-init command directly):

npm install -g autonomous-init

# Then use the command anywhere:
autonomous-init
autonomous-init --help
autonomous-init --dry-run

What it creates

CLAUDE.md                        ← Claude Code configuration (Overlord mode)
.ai/
  state/
    active_context.md            ← Active context (populated by scripts)
  modes/
    overlord.md                  ← Script-governed specialist
    architect.md                 ← System design and architecture
    reviewer.md                  ← Code review and quality
    debugger.md                  ← Systematic bug hunting
    planner.md                   ← Task planning and implementation plans

Options

autonomous-init [options]

  --help,    -h   Show this help message
  --version, -v   Show version number
  --force,   -f   Overwrite existing files
  --dry-run       Preview what would be created without writing
  --modes         List available default modes

Examples

# Initialize a new project
npx autonomous-init

# Preview what would be created
npx autonomous-init --dry-run

# Re-initialize, overwriting existing files
npx autonomous-init --force

# List available modes
npx autonomous-init --modes

Modes

| Mode | Purpose | |------|---------| | overlord | Script-governed specialist — the default Claude Code behavior | | architect | System design, planning, and architecture decisions | | reviewer | Code review, feedback, and quality checks | | debugger | Systematic bug hunting and root cause analysis | | planner | Breaking tasks into steps, writing implementation plans |

Each mode lives in .ai/modes/ and can be referenced from .ai/state/active_context.md to control how Claude Code behaves in your project.

License

MIT