One shared understanding of your software system.
AI tools read files. Workspai models the projects, dependencies, policies, and evidence around them, so developers, CI, IDEs, and AI agents work from the same truth.
Build one model. Align every tool.
What the workspace contains
Workspace Intelligence
One shared model of structure, context, impact, and verification
Who works from the same truth
Build one model. Align every tool.
Open-source CLI
Same workspace intelligence from the terminal
Workspai uses one deterministic CLI across terminals, CI, and VS Code. Bootstrap workspaces, adopt repos, sync agent grounding with workspace agent-sync, and run pipeline --strict from the open-source Workspai CLI, then open the same workspace in the extension.
Workspace
Model + context
Agent sync
Pipeline
Adopt
Or run instantly with npx workspai … — no global install required.
Workspai platform
Workspace Intelligence — not a chat window
Workspai turns projects, policies, evidence, and changes into one shared model that humans, CI, IDEs, and AI agents can use. Start with a Workspace Intelligence workspace, then bring in the software you already have or create a supported frontend or backend project.
Create a workspace
The workspace is the shared architecture around your projects. It does not force a framework or rewrite your source.
npx workspai my-workspaceBring an existing project
Adopt a local project in place or import a folder or Git repository. Any language or framework can enter the workspace.
npx workspai adopt /path/to/projectnpx workspai import <path|git-url>Create a new project
Choose one of the supported backend or frontend options. Workspai creates it and registers it in the workspace automatically.
npx workspai create projectWorkspai project kits
These backend scaffolds are supplied and governed by Workspai and RapidKit Core, with a 52 modules ecosystem available after creation.
FastAPI Standard Kit
fastapi.standard · Core-backed · stable
FastAPI DDD Kit
fastapi.ddd · Core-backed · stable
NestJS Standard Kit
nestjs.standard · Core-backed · stable
Spring Boot Standard Kit
springboot.standard · Workspai-owned · stable
Go Fiber Standard Kit
gofiber.standard · Workspai-owned · stable
Go Gin Standard Kit
gogin.standard · Workspai-owned · stable
ASP.NET Core Clean Web API
dotnet.webapi.clean · Workspai-owned · preview
Official framework generators
For these frontend options, Workspai invokes the framework's official generator, then adds the project marker and workspace registration. Generator versions follow the CLI's tested command contract.
Both paths end in the same Workspace Intelligence loop: register, model, context, impact, verify, and agent sync.
What the intelligence layer produces
Real repos, projects, modules, and kits — not prompts.
Registry graph
Evidence
Contracts
Agent context
Model, evidence, contracts, and agent context — same truth for IDE and CI.
Workspai
VS Code
Workspai CLI
npx workspai
Copilot · Cursor
grounded chat
CI pipeline
--strict gates
Governed AI workflow
One controlled loop from issue to verified change
Workspai keeps every workspace action inside the same operating model: detect the real context, diagnose with evidence, plan the smallest safe move, verify before trust, and retain what the team learned.
Workspace platform
Free · No AI requiredWorkspace Explorer
Dedicated sidebar tree showing every workspace, project, and RapidKit Core module. Expand, right-click, or run quick actions without leaving VS Code.
Workspaces · Projects · Modules
Project Scaffolding
One command creates a guided starter project for supported stacks. Pick FastAPI, NestJS, Go / Fiber, Go / Gin, Spring Boot, ASP.NET Core, Frontend Apps and Workspai generates the core directory structure, config, and entry point for you to review.
FastAPI · NestJS · Go / Fiber · Go / Gin · Spring Boot · ASP.NET Core · Frontend Apps
Module System
Browse the RapidKit Core module catalog for FastAPI/NestJS projects, install with a click, and manage per-project dependencies. Go / Fiber, Go / Gin, Spring Boot, ASP.NET Core, Frontend Apps use scaffold-first workflows without the module catalog.
FastAPI/NestJS modules · Advisor suggestions at create
Health Doctor
Automated workspace and project health checks on demand. Detects missing env variables, broken dependencies, misconfigured kits, and port conflicts.
ENV · Deps · Ports · Kit config
Dev Server Control
Start, stop, and restart project dev servers from the VS Code sidebar without switching to a terminal. Works with all supported frameworks.
One-click run · Live status · Logs
Workspace Dashboard
Rich webview panel showing project tree, health status, module inventory, and quick-launch AI flows — the single pane of glass for your governed workspace.
Status · Navigator · Studio/Advisor entry points
Contract Graph
Inspect and verify the workspace contract registry from VS Code. Refresh contract evidence, validate bindings, and trace governance links before release.
Contract registry · Verify · Refresh
Archive Handoff
Export, verify, hydrate, and share workspace archives with integrity checks. Supports local handoff bundles and remote archive import with doctor evidence.
Export · Verify · Hydrate · Share
Studio and Advisor capabilities
Free · Studio/Advisor sessions · CLI agent-syncWorkspai Studio
Detect → Diagnose → Plan → Verify → Learn loop for workspace incidents. Baseline shipped with evidence badges, stabilization snapshots, and dashboard return paths.
Guided Create
Describe the product or pick a kit. Workspai plans the workspace/project target, then scaffolds only after confirmation.
"Build a SaaS billing API with auth, Stripe, and Postgres"
Project Assistant
Context-aware Q&A grounded in your actual project files, modules, and architecture. Answers that fit your specific codebase.
"What breaks if I change this settings model?"
Workspace Advisor
Advisor sessions for workspace, project, card, and editor scopes. Ask, explain, or navigate while keeping execution user-controlled.
"Explain the auth module in this project"
@workspai in Chat
Native VS Code Chat participant. /ask for architecture questions, /debug for a structured Root Cause → Fix → Prevention response using live diagnostics.
"@workspai /debug Why does this endpoint return 500?"
Editor Issue Actions
Editor lightbulb actions for ordinary code diagnostics: Fix with Workspai opens Studio, Explain with Workspai opens Advisor.
"Why does this endpoint return 422 Unprocessable Entity?"
Fix by Workspai
Artifact cards open Studio repair sessions backed by Workspai remediation plans, guarded edits, verify commands, and rollback notes.
"Fix missing environment variable in billing-platform"
Explain with Workspai
Ask Advisor to explain an editor diagnostic, card blocker, or workspace question without applying changes.
"Preview the safest fix for this 500 error"
Change Impact
Use Workspai impact evidence to understand blast radius, risk, and verification targets before making a change.
"If I change this auth middleware, what might break?"
Terminal Evidence Review
Send terminal output, stack traces, or failing test logs into Advisor/Studio as evidence for scoped diagnosis.
"Analyze this pytest failure and suggest the safest next step"
Agent Context Pack
Generate workspace context and grounding surfaces so Copilot, Cursor, Claude, Codex, CI, and Studio read the same truth.
"Always use async SQLAlchemy and avoid sync session in routes"
Agent Sync
Refresh portable agent grounding files from Workspai evidence so tools stay aligned after model, doctor, impact, or verify changes.
"Set API naming conventions and architecture decisions"
Workspace Playbooks
Generated operational skills/playbooks for diagnosing, repairing, and verifying workspace issues from evidence.
"Run ship-readiness recipe for this workspace"
Module Advisor
AI scoped to each RapidKit Core module — install guidance, usage patterns, and config tips. Suggests the right modules during project creation.
"How do I wire up db_postgres with auth_core?"
Command Evidence History
Inspect recent command outcomes, reports, and artifact freshness so Studio and the dashboard stay evidence-based.
"Show telemetry summary for the last 7 days"
Coming soon
Module Generator
Add feature slices to any existing project. Routes, services, schemas, migrations, and tests — all in one step with a preview diff.
"Add OTP login with Redis rate limiting and tests"
Studio Debugger (Advanced)
Paste logs, traces, or test failures. Workspai analyzes root-cause patterns and proposes a concrete remediation path in context.
"Why is this endpoint returning 500 in staging?"
Test Generator
Generate unit and integration tests for existing code, covering happy paths, edge cases, and missing surfaces.
"Generate tests for the booking cancellation endpoint"
DevOps Assistant
Generate Docker configs, CI pipelines, env validation, and deploy checklists from your actual project structure.
"Generate a deploy-ready Compose starter for this API"
Architecture Advisor
Architecture guidance grounded in your workspace — caching, queue systems, modularisation, and scale tradeoffs.
"How should I scale this service for 10x traffic?"
Team Workspace Memory
Shared workspace conventions, code style, and architecture decisions synchronized by Workspai across your whole team.
"Enforce our naming conventions across all new modules"
Workspai CLI · same workspace truth
How it works
From detection to learning
in five phases
Workspai runs a structured incident loop — not a chat box. Each phase has a clear job and a clear exit condition before moving forward. The same model, impact, and verify evidence is available from the Workspai CLI outside VS Code.
Surface the problem or intent
Workspai reads your workspace — framework, modules, doctor evidence, git diff, and memory — so every analysis starts from real context, not guesswork.
Root-cause the issue with evidence
Workspai Studio analyzes the detected signals and returns a scoped diagnosis — probable root cause, affected files, and confidence level. No generic guesses.
One safe next action
Workspai proposes the smallest correct next step — not a list of options, but one scoped action with explicit impact context and a preview before any change.
Recommended action
Add STRIPE_WEBHOOK_SECRET to .env.staging
Prove the fix worked
Every shipped guided action that touches code or config has an explicit verify path. Run the suggested check and Workspai confirms whether the issue is resolved or escalates.
Retain what worked
Resolved incidents feed the workspace evidence loop — reports, agent context, and generated playbooks keep future sessions grounded in what was verified.
.workspai/reports/agent-customization-pack.json
Workspai CLI · same workspace truth
Execution discipline
Readiness before promises
Workspai follows a strict claim policy: do not market a capability as stable or retention-driving until it passes flow-level evidence, KPI thresholds, and release-stop gates.
Non-negotiable principle
Workspai must reduce workspace uncertainty, not generate more of it.
Wave 2 release gate
- ✓Capability lives inside the core product loop (not a disconnected surface).
- ✓Affected scope is inspectable before risky execution.
- ✓High-risk actions expose verify path and safe recovery path.
- ✓Claim text in docs/UI matches real shipped behavior and supported scope.
Workspai CLI · same workspace truth
@workspai lives inside
VS Code Chat
No extra window. No copy-paste into a browser. Type @workspai in the native VS Code Chat panel and get answers grounded in your workspace evidence — project structure, installed modules, git diff, reports, and agent context.
/askArchitecture Q&AProject-aware answers grounded in your actual files and modules — not generic LLM output.
/debugRoot Cause → RemediationStructured debug flow: Root Cause · Remediation · Prevention. Reads your live VS Code diagnostics as context.
@workspai /debug payments route returning 500 in staging
Reading workspace context...
Full context from billing-api · stripe_payment module · .env.example
Workspai CLI · same workspace truth
Why Workspai
Why not just use Copilot or Cursor?
Copilot and Cursor make you a better line writer. Workspai makes your team better at operating a software workspace. They live comfortably side by side.
Workspace project scaffolding
Create or adopt projects through a governed workspace target and Workspai create planner
Framework module system
Install and manage RapidKit Core modules with AI setup guidance and workspace-aware checks
Workspace evidence layer
Model, doctor, impact, verify, remediation plans, and agent context as shared truth
Evidence-backed repair handoff
Artifact cards open Studio sessions with remediation plan, verify command, and rollback notes
Dedicated workspace sidebar
VS Code panel built around your workspace — not a generic chat box
Context-aware AI chat
Inline code completion
Free tier
Workspai is purpose-built for workspace evidence, repair, and verification, not general-purpose line completion. Pair it with Copilot or Cursor for the full stack. CLI reference
Workspai CLI · same workspace truth
Pricing
Start free with guided actions for supported workspace stacks. Upgrade when advanced generation depth and team workflows become core to your daily engineering process.
Free
Everything you need for guided, verify-first workspace intelligence workflows in the currently shipped free scope — no credit card required.
- Guided Create — workspace + project with confirmed target
- Project Assistant — context-aware Q&A
- Workspace Explorer — workspaces, projects, modules, and actions
- Editor Issue Actions — Fix with Workspai + Explain with Workspai
- Fix by Workspai — artifact-card sessions in Studio
- Change Impact — workspace evidence before risky edits
- Terminal Evidence Review for logs and test failures
- Agent Context Pack + Agent Sync surfaces
- Command Evidence History for reports and freshness
- Module Advisor for FastAPI/NestJS RapidKit Core modules
- @workspai in Chat — /ask and /debug with workspace context
- FastAPI · NestJS · Go / Fiber · Go / Gin · Spring Boot · ASP.NET Core · Frontend Apps
- VS Code Studio/Advisor · CLI syncs Cursor, Claude, Codex, and CI via agent-sync
Pro
PopularDeeper generation depth and architecture-aware flows — currently in active development, not yet GA.
- Everything in Free
- Module Generator — multi-file feature generation
- Studio Debugger (Advanced) — deeper root cause analysis
- Test Generator
- DevOps Assistant
- Priority support
Team
Shared intelligence and policies for engineering teams.
- Everything in Pro
- Shared team workspace memory
- Naming and code conventions
- AI Architecture Advisor
- Centralized billing
- Dedicated support channel
Workspai CLI · same workspace truth
Roadmap
Wave 2 is executed as vertical slices, not feature count. We prioritize predictive debugging, architecture-aware reasoning, and sandbox proof before broadening surfaces.
MVP
Shipped baseline — core loop in production
Incident loop baseline
Detect -> Diagnose -> Plan -> Verify workflow is available in the current extension baseline.
Workspace + module platform
Explorer, scaffolding, module advisor, and health doctor are available in the free baseline.
Telemetry and release-gate foundations
Flow telemetry, KPI snapshots, and release-stop automation are active for shipped slices.
Contract hardening baseline
Key payload contracts and flow-level checks are already enforced in current release gates.
Pro
Wave 2 in progress — moat-forming slices
F15 System Graph Indexer
Route -> controller -> service -> model -> datastore graph baseline with incremental updates for impact reasoning.
A08 + C11 Architecture Lens
Impact navigator and blast-radius scoring before mutation with confidence and affected scope.
B08 Predictive guidance
Pre-failure warnings with scoped confidence and one safe next action with verify checklist.
Studio Debugger (Advanced)
Free editor issue actions are already shipped; this advanced layer adds deeper structured diagnosis with confidence, scope evidence, and prevention guidance.
F14 Sandbox verification
Disposable simulation path for high-risk actions before apply, with evidence surfaced in Workspai Studio.
Claim-control parity
Docs/UI/release claims are constrained to evidence-backed shipped scope only.
Team
After first vertical slice is proven
Cross-repo architecture intelligence
Advanced recovery automation
Portfolio-level reliability scoring
Shared policy memory at scale
Workspai CLI · same workspace truth
Start building with AI today
One workspace. One truth. Humans and AI aligned. Install the free extension and run your first guided AI action in minutes, with explicit verify paths for shipped safety-critical flows.
No account needed · Workspai CLI + VS Code · Supported workspace stacks · Free forever