Skip to content

cli.md

Latest commit

 

History

History
205 lines (121 loc) · 5.11 KB

cli.md

File metadata and controls

205 lines (121 loc) · 5.11 KB

CLI Reference

autoskillit serve

Start the MCP server. This is the default command when no subcommand is given.

autoskillit serve

You rarely need to run this manually — Claude Code starts the server automatically via the plugin registration.

autoskillit install

Register AutoSkillit as a Claude Code plugin.

autoskillit install [--scope user|project|local]

Flags:

  • --scope (default: user) — Where to install: user (global), project (per-project), local

What it does:

  1. Creates local marketplace at ~/.autoskillit/marketplace/
  2. Registers marketplace with Claude Code
  3. Installs the plugin
  4. Syncs hooks to settings.json

Syncs hooks and plugin cache. Called automatically by autoskillit update.

autoskillit init

Set up a project for AutoSkillit.

autoskillit init [--force] [--test-command CMD] [--scope user|project]

Flags:

  • --force — Overwrite existing config
  • --test-command — Set test command non-interactively (e.g., --test-command "pytest -v")
  • --scope (default: user) — Where to register hooks

Creates:

  • .autoskillit/config.yaml — Project configuration
  • .autoskillit/temp/ — Working directory for pipeline artifacts
  • MCP server entry in ~/.claude.json

autoskillit order

Launch an interactive pipeline session.

autoskillit order [recipe]

Arguments:

  • recipe — Recipe name to run. If omitted, shows an interactive picker.

Behavior:

  • If no recipe is given, presents a numbered list to choose from (including an "Open kitchen" option)
  • Validates the recipe YAML before launching
  • Opens a restricted Claude Code session (only AskUserQuestion + MCP tools)
  • Injects the recipe as the orchestrator's system prompt
  • Cannot be run from inside a Claude Code session

Note: order only accepts recipe names (e.g., implementation, remediation). Skills like setup-project are not recipes — use autoskillit cook and then /autoskillit:setup-project instead.

Examples:

autoskillit order                    # Interactive picker
autoskillit order implementation     # Run implementation pipeline
autoskillit order remediation        # Run remediation pipeline

autoskillit doctor

Run health checks on your setup.

autoskillit doctor [--output-json]

Flags:

  • --output-json — Output results as JSON

Runs 28 checks (up to 33 with fleet enabled) enumerated by run_doctor in cli/_doctor.py — 23 numbered plus lettered sub-checks 2b, 2c, 2d, 4b, and 7b. The checks cover stale MCP servers, plugin registration, PATH, project config, secrets placement, version consistency, hook health, hook registration, hook registry drift, recipe version health, gitignore completeness, secret-scanning hook, editable install source, stale entry points, source drift, quota cache schema, process state, install classification, update dismissal state, ambient env leaks, and feature gate consistency. See installation.md for the full table.

autoskillit cook

Launch Claude Code with all skills as slash commands.

autoskillit cook

Alias: autoskillit c

This gives you an unrestricted Claude session with all bundled skills available as /autoskillit:* slash commands and the kitchen pre-opened. No recipe — use skills individually as needed.

autoskillit migrate

Check for outdated project recipes.

autoskillit migrate [--check]

Flags:

  • --check — Exit with code 1 if any recipes need migration (for CI)

Migrations are applied automatically when recipes are loaded. This command just reports what's pending.

autoskillit quota-status

Check current API quota utilization.

autoskillit quota-status

Outputs JSON with the current 5-hour rolling utilization percentage.

autoskillit config show

Show the resolved configuration.

autoskillit config show

Prints the merged result of all config layers as JSON.

autoskillit recipes list

List available recipes.

autoskillit recipes list

Shows name, source (bundled or project), and description.

autoskillit recipes show

Print a recipe's raw YAML.

autoskillit recipes show <name>

autoskillit recipes render

Generate flow diagrams for recipes.

autoskillit recipes render [name]

If no name given, renders all recipes. Diagrams are written to recipes/diagrams/{name}.md.

autoskillit skills list

List all bundled skills.

autoskillit skills list

Shows name, source, and path for all bundled skills. The complete catalogue is also documented in skills/catalog.md.

autoskillit workspace init

Create a prep station directory for testing.

autoskillit workspace init <path>

Creates the directory with a .autoskillit-workspace marker that authorizes reset_test_dir and reset_workspace to clear it.

autoskillit workspace clean

Prune old run directories.

autoskillit workspace clean [--dir DIR] [--force]

Flags:

  • --dir — Directory to clean (default: ../autoskillit-runs/)
  • --force — Skip confirmation prompt

Removes run directories older than 5 hours.