cli-generation

cli-generation

Generate complete, tested, audited CLIs from any API surface. A Claude Code plugin.

Try it now

/cli-generation https://api.example.com

Install

# 1. Add the marketplace
claude plugin marketplace add https://github.com/KalebCole/cli-generation.git

# 2. Install the plugin
claude plugin install cli-generation@cli-generation-marketplace

Or from within Claude Code: /plugin marketplace add KalebCole/cli-generation, then /plugin install cli-generation.

Requires the superpowers plugin for TDD and skill creation:

claude plugin install superpowers

What It Does

Point /cli-generation at any API surface and it autonomously builds a production-grade CLI:

• Auth discovery — figures out how the API authenticates (11 auth types)
• API mapping — parses docs or reverse-engineers endpoints
• Validation — hits every endpoint, confirms responses
• Architecture — designs command tree, flags, JSON output contract
• Code generation — writes the CLI using TDD (tests first)
• Quality audit — grades against 14-point checklist, loops until grade >= B
• Skill generation — creates SKILL.md files so AI agents can use the CLI

Each phase runs in its own subagent. No context bloat.

Supported Inputs

# Web URL
/cli-generation https://dining.microsoft.com

# OpenAPI / Swagger spec
/cli-generation ./openapi-spec.yaml

# GraphQL schema
/cli-generation ./schema.graphql

# gRPC proto
/cli-generation ./service.proto

# SDK reference
/cli-generation "Azure SDK for Node.js"

# Raw endpoint list
/cli-generation "GET /users, POST /users, GET /users/:id, DELETE /users/:id"

The Pipeline

flowchart TD
    INPUT["URL | Spec | SDK | Proto | GraphQL"]
    
    P0["<b>Phase 0</b><br/>Classify Input<br/><i>You pick: name, path, stack</i>"]
    
    P1["<b>Phase 1</b> · auth-recon<br/>Auth Discovery<br/><i>5 strategies, 11 auth types</i>"]
    P2["<b>Phase 2</b> · api-recon<br/>API Mapping<br/><i>Parse docs → reverse-engineer</i>"]
    P3["<b>Phase 3</b> · endpoint-validator<br/>Validate Endpoints<br/><i>Hit every endpoint, confirm schemas</i>"]
    
    P4["<b>Phase 4</b> · cli-architect<br/>Design CLI Architecture<br/><i>Commands, flags, JSON output</i>"]
    P5{"<b>Phase 5</b><br/>Audit Architecture<br/>14-point checklist"}
    
    P6["<b>Phase 6</b> · cli-generator<br/>Generate CLI (TDD)<br/><i>Tests first, then implement</i>"]
    P7{"<b>Phase 7</b><br/>Audit Implementation<br/>14-point checklist"}
    
    P8["<b>Phase 8</b> · skill-ideator<br/>Ideate Skills<br/><i>6-category brainstorm</i>"]
    PAUSE["<b>PAUSE</b><br/>You select which skills to generate"]
    P9["<b>Phase 9</b> · skill-generator<br/>Generate SKILL.md files<br/><i>Full eval harness + triggers</i>"]
    
    DONE(["Done · Push to GitHub"])

    INPUT --> P0
    P0 --> P1
    P1 --> P2
    P2 --> P3
    P3 --> P4
    P4 --> P5
    P5 -->|"grade ≥ B"| P6
    P5 -->|"grade < B (max 2×)"| P4
    P6 --> P7
    P7 -->|"grade ≥ B"| P8
    P7 -->|"grade < B (max 2×)"| P6
    P8 --> PAUSE
    PAUSE --> P9
    P9 --> DONE

    style INPUT fill:#1a1a2e,stroke:#e94560,color:#fff
    style DONE fill:#0f3460,stroke:#16213e,color:#fff
    style PAUSE fill:#533483,stroke:#e94560,color:#fff
    style P5 fill:#e94560,stroke:#16213e,color:#fff
    style P7 fill:#e94560,stroke:#16213e,color:#fff

Tech Stack Options

The CLI it generates uses your choice of stack:

Stack	CLI Framework	Test Runner	Build / Run	Package File
TypeScript (recommended)	Commander.js	Vitest	tsx / tsup	package.json
Python	Click	pytest	uv run	pyproject.toml
PowerShell	Native module	Pester	Import-Module	.psd1
Custom	You describe it	You describe it	You describe it	—

What You Get

1 Command

Command	What it does
/cli-generation	The orchestrator. Takes an API surface, runs all 9 phases.

6 Skills (independently useful)

Each skill works standalone — you don't need to run the full pipeline.

Skill	Use when you want to...
cli-auth-recon	Figure out how an API authenticates
cli-api-recon	Map an API's endpoints, schemas, rate limits
cli-architect	Design a CLI architecture from scratch
cli-audit	Grade any CLI against the 14-point quality checklist
cli-ideate	Brainstorm features for a CLI across 6 categories
cli-skillgen	Generate SKILL.md files for a CLI

9 Internal Agents

Dispatched by the orchestrator — you don't invoke these directly.