RapidKit
workspai on npm — Workspace Intelligence CLI

Workspai CLI

One workspace. One truth. Humans and AI aligned.

Open-source workspace intelligence for software systems — create planner, model, context, agent-sync, impact analysis, verification evidence, and release gates.

Not another AI assistant — a governed workspace layer for developers, CI, IDEs, and agents
$npm install -g workspai
npx workspai --help
npx workspai my-workspace --yes --profile polyglot
npx workspai bootstrap --profile polyglot
npx workspai workspace context --for-agent --json --write
npx workspai workspace agent-sync --write --refresh-context --preset enterprise
npx workspai pipeline --json --strict
CLI ReferenceInstall via npmView on GitHub
.........

Create planner paths

Native create, external adopt, or adopt-only — one command surface per stack

Next.js Frontend

npm-backed

Create official Next.js apps with RapidKit workspace metadata and contracts.

npx workspai create project nextjs web
  • Uses create-next-app@latest under the hood
  • Writes RapidKit project metadata
  • Participates in workspace contract graph
  • Works from CLI and Workspai sidebar

Adopt Existing Project

in-place

Link a local repo into a workspace without moving or copying source.

npx workspai adopt /path/to/project
  • Detect runtime and command capabilities
  • Add project to workspace metadata
  • Participate in model, impact, and verify
  • Keep unsupported actions explicit

FastAPI Project

Core-backed

Create production-ready FastAPI projects with Core module workflows.

npx workspai create project fastapi.standard my-api
  • Core-backed project workflow
  • Access the RapidKit module catalog
  • Clean architecture out of the box
  • Full CLI command support

NestJS Project

Core-backed

Create enterprise-ready NestJS projects with TypeScript module boundaries.

npx workspai create project nestjs.standard my-api
  • TypeScript-first development
  • Modular architecture
  • Enterprise patterns included
  • Full CLI command support

Go Fiber / Gin Project

npm-backed

Create Go services with workspace contracts and runtime-aware commands.

npx workspai create project gofiber.standard my-api
  • Go module scaffold
  • Fiber and Gin choices
  • Workspace contract metadata
  • Observed command capability mapping

Spring Boot Project

npm-backed

Create JVM services inside RapidKit workspaces.

npx workspai create project springboot.standard my-api
  • Java 21-oriented scaffold
  • Health endpoint and project metadata
  • Workspace run compatibility
  • Project import parity with other runtimes

ASP.NET Core Project

preview

Create clean architecture .NET Web API projects.

npx workspai create project dotnet.webapi.clean my-api
  • .NET 8 Web API scaffold
  • Application/domain/API boundaries
  • Workspace contract participation
  • Preview runtime support matrix

Import Repository

observed

Clone or register a git URL into a governed RapidKit workspace.

npx workspai import ./repo.git
  • Detect runtime after checkout
  • Add project to workspace metadata
  • Participate in contract graph
  • Keep unsupported actions explicit

Powerful Features

Everything you need to start building

Governed Workspaces

Create, adopt, or import projects under one workspace boundary with policies and evidence.

  • npx workspai my-workspace --yes --profile polyglot
  • npx workspai bootstrap --profile polyglot
  • npx workspai adopt /path/to/project
  • Reports under .rapidkit/reports/

Runtime-aware Command Routing

Run one CLI across npm-owned kits, Python Core-backed projects, and observed imports.

  • NPM-owned Go, Spring Boot, .NET, and Next.js generators
  • Core-backed FastAPI and NestJS workflows
  • Adopt in-place or import git repos
  • Capability-aware project command matrix

Unified Project Creation

Create, adopt, or import governed projects with one workspace-native command surface.

  • npx workspai adopt /path/to/project
  • npx workspai create project nextjs web
  • npx workspai create project fastapi.standard
  • npx workspai create project nestjs.standard
  • npx workspai create project gofiber.standard
  • npx workspai import ./repo.git
  • Interactive framework selection

Workspace Intelligence

Build shared understanding for developers, CI, IDEs, and AI agents.

  • npx workspai workspace model --json
  • npx workspai workspace context --for-agent --json --write
  • npx workspai workspace agent-sync --write
  • npx workspai workspace impact --from <snapshot>
  • npx workspai workspace verify --strict --json
  • npx workspai pipeline --json --strict

Create Planner

Native create, external adopt, or adopt-only — RapidKit picks the safest path per stack.

  • native-create — first-class kits (Next.js, FastAPI, NestJS, Go, …)
  • external-create-adopt — ecosystem generator + adopt
  • adopt-only — existing repos without scaffolding
  • WordPress, Laravel, Rails via adopt/import

Developer Experience

Built with TypeScript for reliability and performance.

  • Interactive CLI prompts
  • Debug mode available
  • Dry-run preview
  • Auto-update checks

Optimized Bundle

Lightning-fast installation with minimal footprint.

  • 48KB bundle size (optimized)
  • Built with tsup + esbuild
  • Tree-shaking enabled
  • Zero bloat dependencies

Typical Workflow

Bootstrap shared understanding, then create or adopt projects

StepGreenfieldAdoptImport
1
Create workspace
npx workspai my-workspace --yes --profile polyglotnpx workspai adopt /path/to/projectnpx workspai import ./repo.git
2
Bootstrap & model
npx workspai bootstrap --profile polyglotnpx workspai workspace model --jsonnpx workspai workspace model --json
3
Agent context & sync
npx workspai workspace context --for-agent --json --writenpx workspai workspace agent-sync --write --refresh-context --preset enterprisenpx workspai workspace agent-sync --write
4
Release gate
npx workspai pipeline --json --strictnpx workspai pipeline --json --strictnpx workspai pipeline --json --strict

After a Change

Diff → impact → verify → trace — the governance loop agents and CI can share

1
Diff changes
npx workspai workspace diff --from git --json --write
2
Analyze impact
npx workspai workspace impact --from .rapidkit/reports/workspace-model-diff-last-run.json --json --write
3
Verify readiness
npx workspai workspace verify --strict --json --write
4
Explain & trace
npx workspai workspace trace --from .rapidkit/reports/workspace-model-diff-last-run.json --json --write

Start with workspace intelligence

Create or adopt a workspace, sync agents, then verify with shared evidence

npx workspai my-workspace --yes --profile polyglot
View PackageBack to Home