winspect CLI

Public TypeScript CLI for authenticating to Winspect (browser login → named org API key), publishing OpenAPI specs, creating mock servers, linting with Spectral, and listing/pulling/searching APIs. Targets npm (@winspect/cli), Homebrew, and standalone binaries.

Status

Completion: ~0% — Tracked in Product OS; implementation in winspect-cli repo (planned).

Scope

• Auth: winspect auth login|logout|status|token|switch — store config under ~/.winspect/config.json
• Publish: winspect publish — CI env auto-detection (GitHub, GitLab, Bitbucket), .winspect.yaml, lint gate, --check-breaking
• Mock: winspect mock create|list|url|delete|regenerate-key|logs
• Lint: winspect lint — bundled Spectral; --org-ruleset when server persistence exists
• Registry: winspect pull|search|diff|log|status — depends on registry read API and version history
• Teams: winspect team list|create|invite|members
• MCP: winspect mcp url|test — prints hosted MCP URL for AI tools
• Onboarding: winspect init — detect spec, optional CODEOWNERS, first publish

Related backlog

Developer-adoption track: bl-042–bl-063 in data/backlog.yaml. (Agentic CLI bootstrap items remain bl-029–bl-032 under the oclif-based developer-cli feature.)

Repositories

• winspect-cli  (planned)
• platform-backend-service  — CLI auth completion endpoint, sync API