v1.0.5 — Latest Release

WorkspaceGPT Extension Docs

Everything you need to install, configure, and get the most out of WorkspaceGPT inside VS Code, Cursor, or Antigravity.

🔐

Privacy-First

100% local with Ollama — no data leaves your machine. Cloud providers available optionally.

🤖

RAG-Powered

Retrieval-Augmented Generation over your codebase, Confluence docs, and ADO tickets.

⚡

Zero Setup

Install from the marketplace and start chatting in under 2 minutes.

Installation

Available in the VS Code and Cursor marketplaces, and on Open VSX for Antigravity.

Via Extensions Marketplace

Open VS Code, Cursor, or Antigravity and navigate to the Extensions view:

Ctrl+Shift+X or Cmd+Shift+X on macOS

Search for WorkspaceGPT and click Install.

Via Command Palette

Press Ctrl+P to open Quick Open and run:

bash

ext install Riteshkant.workspacegpt-extension

Via Marketplace Website

Visit the VS Code Marketplace page and click Install.

On Antigravity (or other VS Code forks)

Antigravity, Windsurf, and VSCodium install from Open VSX instead of the Microsoft Marketplace. Search WorkspaceGPT in the Extensions view, or open the Open VSX page and click Download.

Minimum VS Code version: 1.98.0. WorkspaceGPT activates automatically on startup (onStartupFinished).

AI Providers

Choose between fully local operation with Ollama or cloud-based providers for maximum capability.

Provider	Privacy	Requires API Key	Notes
Ollama	100% Local	No	Default. Run llama3.2:1b or any local model.
OpenAI	Cloud	Yes	GPT-4o, GPT-4-turbo, GPT-3.5 etc.
Gemini	Cloud	Yes	Google's Gemini Pro/Flash models.
Groq	Cloud	Yes	High-speed inference on Llama / Mixtral.
OpenRouter	Cloud	Yes	Access 100+ models via one API key.
Requestly	Cloud	Yes	Custom API endpoint proxy integration.

Configuring Ollama (Recommended)

Install Ollama

Download from ollama.com and follow the installer for your OS.

Pull a model

bash

ollama pull llama3.2:1b

For better responses, try a larger model:

bash

ollama pull llama3.2:4b
# or
ollama pull gemma3:4b
# or
ollama pull mistral

Select in WorkspaceGPT

Open the WorkspaceGPT sidebar → Settings → Providers → Ollama. Your locally running models will appear automatically.

Configuring Cloud Providers

Open Settings → Providers, select your provider, and paste your API key. Keys are stored securely in VS Code's secret storage and never logged.

Codebase Indexing

WorkspaceGPT indexes your local workspace files so you can chat with your own code.

Open the Codebase panel

In the WorkspaceGPT sidebar, go to Settings → Codebase.

Start Sync

Click Start Sync. The extension will walk the workspace folder tree, generate embeddings using the bundled local model (all-MiniLM-L6-v2), and store them in VS Code's global storage.

Chat with your code

Once indexing is complete, your questions will automatically draw context from your codebase alongside any other connected data sources.

Note: Large monorepos may take a few minutes to index on first run. Subsequent syncs are incremental and much faster.

Embeddings & Vector Storage

Every connected source (codebase, Confluence, ADO) is turned into vector embeddings and stored so WorkspaceGPT can retrieve the right context. You control both halves: which model makes the embeddings, and where the vectors live.

Embedding provider

Provider	Model	API key	Best for
Local Default	Xenova/all-MiniLM-L6-v2 (384-dim)	Not needed	Full privacy — runs on-device, nothing leaves your machine. First run downloads ~200 MB.
Google Gemini	gemini-embedding-001 (768-dim)	Required	Faster, higher quality, and required for sharing to the Chrome extension.

Configure under Settings → Embeddings. Keys are stored in VS Code's encrypted secret storage.

Vector storage

💾

Local (on this machine)

Vectors are written to binary files in the extension's storage. Nothing leaves your machine. The default — ideal for solo, privacy-critical use.

☁️

Cloud — Qdrant

Vectors live in a Qdrant cluster (self-hosted or Qdrant Cloud). Provide the cluster URL and API key, then click Test connection. Enables sharing and larger datasets.

Configure under Settings → Vector Storage. Cloud-Qdrant URLs from the dashboard are auto-normalized to include the :6333 port.

Re-index when you switch: changing the embedding provider or the storage location means existing vectors no longer match — WorkspaceGPT will prompt you to re-index your connected sources. (Different models also produce different vector dimensions.)

Confluence Integration

Connect your Atlassian Confluence space with one-click OAuth 2.0 authentication.

Open Confluence settings

In the WorkspaceGPT sidebar, navigate to Settings → Confluence Integration.

Sign in with Atlassian

Click Sign In. A browser window will open to Atlassian's OAuth consent screen. Sign in and grant access — no passwords are stored.

The extension spins up a short-lived local HTTP server to capture the OAuth callback securely.

Select a space

After authentication, your accessible Confluence sites and spaces will load. Select the spaces you want to index.

Start Sync

Click Start Sync. Pages are fetched, converted to Markdown, embedded, and stored locally. Progress is shown in real-time.

Automatic background sync

The ConfluenceSyncScheduler starts automatically on extension activation and keeps your index up-to-date in the background.

Token security

OAuth access + refresh tokens are stored in VS Code's encrypted context.secrets — never in plaintext settings.

Disconnect anytime

Go to Settings → Confluence → Disconnect to revoke access and clear all synced data.

Azure DevOps Integration

Connect Azure DevOps to chat with work items, user stories, and pull requests.

Generate a Personal Access Token (PAT)

In Azure DevOps, go to User Settings → Personal Access Tokens → New Token.

Grant at minimum: Work Items — Read Code — Read

Open ADO settings

In the WorkspaceGPT sidebar, go to Settings → Azure DevOps Integration.

Enter your organization URL and PAT

Provide your Azure DevOps organization URL (e.g. https://dev.azure.com/your-org) and the PAT you generated.

The PAT is stored in VS Code's context.secrets, never in globalState.

Select project and sync

Your ADO projects will load automatically. Select a project and click Start Sync.

Work items are embedded and indexed locally — no data is sent to third-party servers.

Auth format: The extension uses Basic base64(:PAT) (colon-prefixed PAT) as required by the Azure DevOps REST API.

Enterprise

Deployment Automation

Turn the manual release checklist — syncing feature flags, env vars, and component versions across environments — into a reviewable, one-click pipeline. The model is inspired by AWS CodePipeline: a pluggable Source feeds ordered Stages of Actions. Nothing is hardwired to one team's setup.

🧩

Pluggable

Pick a source, then add only the deploy actions your org actually uses. No provider is baked in.

🛡️

Plan → Approve → Apply

Every change is previewed as a diff you approve before anything is written. Backend changes open a PR — never an auto-merge.

🔍

Discover & select

Repos, workflows, projects, and table columns are detected from your connected accounts — choose from dropdowns, don't type IDs.

Full deployment guide

Sources, actions, connections (PAT/SSO + Vercel gotchas), the Releases workflow, environments, security, troubleshooting & FAQ.

Read the guide →

MCP Server

WorkspaceGPT ships a built-in MCP (Model Context Protocol) server for GitHub Copilot and Claude Code integration.

Connect the MCP Server

Open the Command Palette (Cmd/Ctrl+Shift+P) and run:

vscode command

WorkspaceGPT: Connect MCP Server

Use with GitHub Copilot or Claude

The MCP server is registered as a definition provider for Copilot Chat (@mcp). Once connected, Copilot and Claude can query your indexed data directly via the WorkspaceGPT context.

Status bar indicator: After connecting, a WorkspaceGPT button appears in the VS Code status bar showing MCP connection health.

Companion app

Chrome Extension

A browser side-panel that lets you (or a teammate) chat with your indexed Confluence pages and Azure DevOps work items — without opening VS Code. It runs entirely in the browser, talking directly to your providers; there's no WorkspaceGPT server in between.

🧭

Side panel

Ask questions and read grounded answers from a panel docked in Chrome.

🔗

One share code

Connect by pasting a single code generated in VS Code — no separate setup.

🚫

No server

Calls go browser → Gemini / Qdrant / your chat model directly. Nothing is proxied.

Prerequisites

Because the browser needs cloud-reachable services, the share flow requires: Gemini embeddings, a Qdrant Cloud vector store, and a chat model with an API key — all configured in VS Code first (see Embeddings & Vector Storage).

Setup

Install from the Chrome Web Store

Add WorkspaceGPT for Chrome to your browser.

Create a share code in VS Code

In the WorkspaceGPT sidebar, open Settings → Share to Chrome and click Create share code. It's copied to your clipboard.

If a prerequisite is missing, the button tells you exactly what to fix first.

Paste it into the extension

Open the Chrome side panel → Settings → paste the code → Connect. You'll see a confirmation with your Qdrant URL.

Ask away

Close settings and chat. The extension mirrors VS Code's retrieval, so answers stay consistent across Confluence and ADO.

Treat the share code like a password

It contains your real Qdrant, Gemini, and chat-model API keys in plain form. Anyone with it can query your data and incur API costs. Share only with people you trust.

Write creds are never shared

GitHub, Vercel, Confluence, and ADO tokens stay in VS Code secret storage and are excluded from the bundle. The share is read-only knowledge access.

Scope: the extension covers Confluence and Azure DevOps knowledge. Local codebase indexing stays in VS Code and is not part of the share. Regenerate the code if you rotate your keys.

Commands & Keyboard Shortcuts

All commands are accessible from the Command Palette.

Command	Shortcut	Description
WorkspaceGPT: Ask	Cmd+Shift+R / Ctrl+Shift+R	Open & focus the WorkspaceGPT chat panel.
WorkspaceGPT: New Chat	—	Start a fresh conversation, clearing history.
WorkspaceGPT: Settings	—	Open the settings panel inside the sidebar.
WorkspaceGPT: Chat History	—	Browse and restore previous chat sessions.
WorkspaceGPT: Connect MCP Server	—	Register the MCP server for Copilot / Claude.
WorkspaceGPT: Clear All Data and Cache	—	Wipe all embeddings, state, and tokens.

Activity Bar & Title Bar Icons

➕

New Chat

Click the + icon in the WorkspaceGPT title bar to start a new session.

⚙️

Settings

The gear icon opens provider and integration configuration.

🕐

History

Browse, restore, or delete previous chat sessions.

Reset & Clear Data

WorkspaceGPT stores all data locally in VS Code's global storage. You can wipe everything at any time.

Via Command Palette

Run WorkspaceGPT: Clear All Data and Cache from the Command Palette. A confirmation prompt will appear.

Via Settings panel

Open Settings → Reset VSCode State inside the WorkspaceGPT sidebar.

Warning: This action clears all embeddings, OAuth tokens, PATs, and chat history. It cannot be undone. Background schedulers are stopped automatically before the wipe.

Troubleshooting

Common issues and how to fix them.

⚠Extension not loading / sidebar not showing

Ensure VS Code ≥ 1.98.0. Check the Extensions panel for error banners. Try reloading the window (Cmd/Ctrl+Shift+P → Reload Window).

⚠Ollama models not appearing

Make sure the Ollama server is running (ollama serve). The default endpoint is http://localhost:11434. Verify at least one model is pulled: ollama list.

⚠Codebase indexing is slow

Large repos with many files take longer. Indexing is incremental after the first run. Exclude large generated/build directories by adding them to .gitignore.

⚠Confluence sync fails

Re-authenticate: Settings → Confluence → Disconnect, then Sign In again. Ensure your Atlassian account has read access to the target space.

⚠ADO sync not working

Verify your PAT has Work Items — Read and Code — Read scopes. Re-enter the PAT in Settings → Azure DevOps. Check the organization URL format: https://dev.azure.com/your-org.

⚠Chat returns no results or irrelevant answers

Confirm the relevant data source is indexed (check the sync status in Settings). Try re-syncing. For better quality answers, switch to a larger Ollama model or a cloud provider.

⚠MCP server not detected by Copilot

Run WorkspaceGPT: Connect MCP Server from the Command Palette. Reload the window after connecting.

Still need help?

Open a GitHub issue →Email support →Read the blog →