CLI Reference

Complete command line usage

AIWG CLI Usage Guide

Note: The `aiwg` CLI command is only available when installed via npm (`npm install -g aiwg`). If you installed AIWG using Claude Code plugins (`/plugin install sdlc@aiwg`), you won't have access to the CLI - plugins provide agents, commands, and skills directly within Claude Code without requiring a separate CLI tool.

Installation

npm install -g aiwg

Quick Start

# Check installation health
aiwg doctor

# Preview the guided first-run path without writing files
aiwg wizard --dry-run --goal "help me start a project"

# Deploy SDLC framework to your project
cd your-project
aiwg use sdlc

# Verify AIWG is engaged in this project
aiwg status --probe --json

Core Commands

doctor

Check AIWG installation health and diagnose issues.

aiwg doctor

Checks:

  • AIWG installation location
  • Version info
  • Project `.aiwg/` directory
  • Deployed agents and commands
  • Node.js version
  • MCP server availability
  • Skill Seekers (optional)

use

Deploy a framework to your project.

# SDLC framework (software development)
aiwg use sdlc

# Marketing framework
aiwg use marketing

# Writing addon (voice profiles)
aiwg use writing

# All frameworks
aiwg use all

Options:

  • `--provider <name>`: Target platform (claude, factory, openai, warp)
  • `--no-utils`: Skip aiwg-utils addon
  • `--force`: Overwrite existing deployments

wizard

Guide first-run provider, project, framework, deploy, and verification choices.

# Interactive terminal path
aiwg wizard

# No-write preview
aiwg wizard --dry-run --goal "help me start a project"

# Scripted path
aiwg wizard --non-interactive --profile beginner --provider codex

Options:

  • `--goal <text>`: Plain-language goal used to recommend a framework
  • `--profile <preset>`: Preset for a common path (`beginner`, `sdlc`, `research`, `marketing`, `forensics`, `ops`, `security`, `knowledge-base`, `writing`)
  • `--provider <name>`: Target provider
  • `--framework <name>`: Framework to deploy first
  • `--non-interactive`: Use selected or inferred defaults without prompting
  • `--dry-run`: Print the plan without writing files
  • `--json`: Print the plan as JSON

-new

Create a new project with full SDLC scaffolding.

aiwg -new my-project
cd my-project

-status

Show workspace health and installed frameworks.

aiwg -status
aiwg status --probe --json

issue

Manage project-local issues under `.aiwg/issues/` and move snapshots to or from Gitea/GitHub. See Local Issues for sync, backup, and Git conflict guidance.

aiwg issue init --prefix PROJECT
aiwg issue new --title "Fix import flow" --body-file issue.md
aiwg issue import --from gitea --snapshot-file gitea-1463.json
aiwg issue import --from github --live --repo org/repo --external-id 42
aiwg issue export PROJECT-0001 --to github --out project-0001.github.json
aiwg issue export PROJECT-0001 --to gitea --live --repo org/repo
aiwg issue sync conflicts PROJECT-0001 --snapshot-file gitea-1463.json --out conflicts.json
aiwg issue sync map-comments PROJECT-0001 --map-file comment-map.json

list

List installed frameworks and addons.

aiwg list

remove

Remove a framework or addon.

aiwg remove <id>

MCP Server

mcp serve

Start the AIWG MCP server.

aiwg mcp serve

mcp install

Generate MCP client configuration.

# For Claude Desktop
aiwg mcp install claude

# For Cursor IDE
aiwg mcp install cursor

# For Factory AI
aiwg mcp install factory

# Preview without writing
aiwg mcp install claude --dry-run

mcp info

Show MCP server capabilities.

aiwg mcp info

Channel Management

--use-main

Switch to bleeding edge (tracks main branch).

aiwg --use-main

--use-stable

Switch back to stable (npm releases).

aiwg --use-stable

Maintenance

-version

Show version and channel info.

aiwg -version

-update

Check for and apply updates.

aiwg -update

-help

Show all available commands.

aiwg -help

Support