workspai
Documentation

Workspai docs

Everything you need to install, explore, and run AI workflows inside VS Code — from project scaffolding to daily fix and impact analysis.

Quick start

Install from VS Code Marketplace and scaffold your first project in under 5 minutes.

Install Workspai — Free
01

Install from VS Code Marketplace

Open VS Code → Extensions panel → search "Workspai" → Install. Or click the direct link below.

Open Marketplace
02

Open the Workspai sidebar

Click the Workspai icon in the VS Code activity bar. The Workspace Explorer and quick-action panel will open immediately.

03

Create your first project with AI

Click "Create with AI" or press ⌘⇧P and run Workspai: AI Flows. Describe your project in plain language and confirm the AI plan.

Supported stacks

Workspai scaffolds full, runnable projects for the following frameworks. Each kit ships with a pre-configured directory structure, settings module, and entry point.

FastAPI

Python 3.11+

fastapi.standardfastapi.ddd
NestJS

Node.js / TypeScript

nestjs.standard
Go / Fiber

Go 1.21+

go-fiber.standard
Go / Gin

Go 1.21+

go-gin.standard

More frameworks planned. See changelog for updates.

Command reference

All commands are accessible from the VS Code command palette.

⌘⇧P/Ctrl+Shift+P→ type "Workspai:"

Workspace & Navigation

Workspai: Open Dashboard

Open the main dashboard webview — project tree, health overview, module inventory, and AI entry points.

Workspai: Open Workspace Explorer

Open the sidebar tree for workspaces, projects, and RapidKit modules with AI inline actions on every item.

Workspai: AI Flows

Smart-route picker: choose Create, Debug, Impact, or Memory — each opens a scoped AI input for that specific goal.

Workspai: AI Quick Actions

Flat picker listing every free AI action for fast keyboard-first access.

Workspai: Run Doctor

Automated health check across workspace and projects. Flags missing env vars, broken deps, port conflicts, and kit config issues.

Workspai: View Logs

Open the Workspai extension output channel to inspect debug and runtime logs.

Workspai: View Telemetry

Open the AI usage telemetry panel with 24h / 7d / all-time windows and per-command stats.

AI Actions (Free · Powered by Copilot)

Workspai: Fix Preview Lite

Select an error or paste a description → returns root cause, candidate file edits, and patch-style guidance. No auto-apply.

Workspai: Change Impact Lite

Analyze what could break before a change. Returns impacted files/modules, risk level, and required test targets.

Workspai: Terminal → AI Bridge

Send terminal output, stack traces, or test failures to AI for structured root-cause + fix guidance in project context.

Workspai: Workspace Memory Wizard

Step-by-step guided setup for workspace-memory.json — stack decisions, naming rules, module boundaries saved once, used everywhere.

Workspai: AI Recipe Packs

Pick from 10 reusable AI workflows: root-cause analysis, endpoint planning, safe refactor, test-gap check, ship-readiness review.

Workspai: Module Advisor

AI-powered module recommendations for your project type. Suggests compatible RapidKit modules and explains how to wire them.

Chat Participant

@workspai /ask [question]

Context-aware architecture Q&A grounded in your workspace files, modules, and project structure — not generic LLM answers.

@workspai /debug [error]

Structured Root Cause → Safe Fix → Prevention flow. Uses your live VS Code editor diagnostics as context.

AI actions

All 14 AI actions are free and powered by GitHub Copilot. Each action is scoped to your live project context — not a generic prompt.

AI Create

"Build a SaaS billing API with auth, Stripe, and Postgres"

Project Assistant

"What breaks if I change this settings model?"

Workspace Brain

"Explain the auth module and its dependencies"

@workspai in Chat

"@workspai /debug Why does this return 500?"

AI Debug Actions

"Why does this endpoint return 422 Unprocessable?"

Doctor Fix with AI

"Fix missing ENV variable in billing-platform"

Fix Preview Lite

"Preview the safest fix for this 500 error"

Change Impact Lite

"If I change this auth middleware, what breaks?"

Terminal → AI Bridge

"Analyze this pytest failure and suggest a fix"

Workspace Memory

"Always use async SQLAlchemy, no sync sessions"

Memory Wizard

"Set API naming conventions step by step"

AI Recipe Packs

"Run ship-readiness recipe for this workspace"

Module Advisor

"How do I wire db_postgres with auth_core?"

Telemetry Insights

"Show AI usage stats for the last 7 days"