Contract-backed CLI reference

Workspai command catalog

100 command surfaces are derived from the synced runtime capability contract. Workspace Intelligence commands include their canonical execution, artifacts, and schema relationships.

Workspace Intelligence

20 commands across the canonical model, evidence, impact, verification, context, and explanation loop

Intelligence
npx workspai analyze

Evaluate workspace evidence and produce governance findings for downstream readiness and release decisions.

Intelligence
npx workspai doctor

Diagnose the active project or workspace and produce actionable findings with evidence-backed remediation guidance.

Intelligence
npx workspai doctor workspace

Diagnose cross-project workspace health, contracts, policies, toolchains, and operational evidence.

Intelligence
npx workspai readiness

Evaluate whether current workspace evidence satisfies release-readiness requirements and blockers.

Intelligence
npx workspai workspace agent-sync

Project current workspace context into governed agent instructions, reports, skills, and integration files.

Intelligence
npx workspai workspace context

Build a scoped workspace context projection from the current model and evidence for human or agent consumption.

Intelligence
npx workspai workspace contract

Inspect and verify explicit workspace contracts.

Intelligence
npx workspai workspace diff

Compare the current canonical workspace model with a snapshot or source-control baseline.

Intelligence
npx workspai workspace explain

Explain a workspace relationship, project, or blocker from traceable model and evidence references.

Intelligence
npx workspai workspace feedback

Record structured feedback about Workspace Intelligence output.

Intelligence
npx workspai workspace graph

Render the current workspace dependency graph in a supported representation.

Intelligence
npx workspai workspace impact

Calculate the blast radius of a workspace diff across projects, dependencies, tests, policies, and gates.

Intelligence
npx workspai workspace mcp

Expose Workspace Intelligence through the MCP integration boundary.

Intelligence
npx workspai workspace model

Discover and normalize workspace entities, relationships, ownership, runtime, contract, and evidence state.

Intelligence
npx workspai workspace remediation-plan

Generate a structured remediation plan from current workspace evidence.

Intelligence
npx workspai workspace snapshot

Capture a versioned workspace or model baseline for comparison and recovery.

Intelligence
npx workspai workspace trace

Trace a change or finding through its evidence and dependency relationships.

Intelligence
npx workspai workspace verify

Combine impact, diagnostics, contracts, analysis, and readiness evidence into a governed verification verdict.

Intelligence
npx workspai workspace watch

Observe relevant workspace changes and publish versioned watch events.

Intelligence
npx workspai workspace why

Explain why a relationship, verdict, or workspace fact exists.

Global

5 commands

Lifecycle

8 commands

Module mutation

11 commands

NPM wrapper

16 commands

npx workspai adopt

Register an existing local repository as a governed Workspai project without recreating its source.

npx workspai ai

Manage AI configuration, recommendations, and embedding operations for the active workspace.

npx workspai autopilot

Coordinate supported automated governance actions while preserving explicit evidence and release gates.

npx workspai autopilot release

Build a governed release proposal from current analysis, readiness, and verification evidence.

npx workspai bootstrap

Establish the selected workspace profile, toolchain, and dependency baseline before project execution.

npx workspai cache

Inspect or clear Workspai cache entries used by workspace and project operations.

npx workspai config

Manage persisted Workspai CLI and provider configuration for the current user environment.

npx workspai doctor project

Diagnose the current project and emit structured project evidence.

npx workspai import

Copy or clone an existing project into the workspace and register its detected runtime capabilities.

npx workspai infra

Manage governed infrastructure planning and lifecycle operations for the active workspace.

npx workspai mirror

Manage local package or dependency mirrors used by offline and controlled development workflows.

npx workspai pipeline

Run the governance pipeline from sync and diagnostics through analysis, readiness, verification, and optional release automation.

npx workspai product

Manage governed product manifests and factory planning operations.

npx workspai setup

Install or validate runtime-specific prerequisites required by the selected workspace profile.

npx workspai shell

Open a workspace-aware shell with resolved project, runtime, and toolchain context.

npx workspai workspace

Dispatch workspace discovery, intelligence, governance, portability, and fleet lifecycle operations.

Project operations

25 commands

npx workspai ai generate-embeddings

Generate the initial semantic embedding index from the current project or workspace sources.

npx workspai ai info

Report the active AI provider, model, and embedding configuration.

npx workspai ai recommend

Recommend relevant modules or actions from the detected project context and configured AI provider.

npx workspai ai update-embeddings

Refresh the semantic embedding index after source or workspace context changes.

npx workspai config ai

Inspect or update the active AI provider, model, and embedding configuration.

npx workspai config remove-api-key

Remove a persisted provider API key from Workspai configuration.

npx workspai config set-api-key

Store a provider API key for authenticated AI operations.

npx workspai config show

Display the effective Workspai configuration with secret values protected.

npx workspai docs

Generate or validate documentation through the detected project documentation lifecycle.

npx workspai infra down

Stop the workspace infrastructure stack and optionally remove governed volumes.

npx workspai infra plan

Generate a versioned infrastructure plan without applying infrastructure changes.

npx workspai infra status

Inspect infrastructure service state and expose a strict machine-checkable status verdict.

npx workspai infra up

Start the workspace infrastructure stack from its governed configuration.

npx workspai product manifest

Inspect or create the product manifest that defines product factory inputs.

npx workspai product manifest create

Create a governed product manifest for product planning operations.

npx workspai product plan

Generate a product factory plan from the current product definition.

npx workspai project archive

Move a project into governed archive storage while preserving registry metadata and recovery evidence.

npx workspai project archives

List governed project archives and their available restoration metadata.

npx workspai project commands

Discover commands supported by the selected project runtime and its current capability tier.

npx workspai project delete

Delete a registered project through guarded workspace safety and recovery checks.

npx workspai project restore

Restore an archived project to its workspace path and reconcile registry ownership.

npx workspai snapshot create

Create a governed workspace snapshot for comparison or recovery.

npx workspai snapshot inspect

Inspect snapshot metadata, contents, and recovery compatibility without restoring it.

npx workspai snapshot list

List governed workspace snapshots available for inspection or recovery.

npx workspai snapshot restore

Restore a governed snapshot through the workspace recovery boundary.

Universal

3 commands

Workspace operations

12 commands