Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(vscode-3d): make the extension Marketplace-ready with working README links, a leaner vsix, and owner publish steps

nirholas2c78c6fa7c9a
diff --git a/marketing/growth/opportunities.csv b/marketing/growth/opportunities.csv
index 215adab3d..6e5c96859 100644
--- a/marketing/growth/opportunities.csv
+++ b/marketing/growth/opportunities.csv
@@ -20,7 +20,7 @@
"P2","15","OpenAI share-your-story","existing-partner","not_started","Submit a founder story after Showcase submission with measurable product outcomes","Owner","2026-10-09","marketing/openai-select-partner/partnership-and-gpt-briefing.md","A human story about making 3D creation accessible through OpenAI products","Submission confirmation or editorial contact","https://openai.com/form/share-your-story/","2026-09-15"
"P2","15","NVIDIA GTC 2027 startup route","existing-member","pavilion_invite_only_cfp_watching","Keep the member profile and NVIDIA demo current for invite-only Pavilion review; monitor the separate public CFP weekly","Owner","2026-10-01","docs/nvidia-visibility-map.md","A browser digital-human demo for agentic AI and media audiences","Submission ID or pavilion acceptance","https://www.nvidia.com/gtc/","2026-09-15"
"P2","14","QuickNode startup spotlight","existing-program","not_started","Send a one-page RPC failover field note and request a founder spotlight","Owner","2026-10-09","docs/solana.md","A practical reliability story with a production QuickNode integration","Published QuickNode-domain story or social post","https://www.quicknode.com/startup-program","2026-09-15"
-"P0","18","VS Code Marketplace: three.ws 3D","installable-distribution","ready_to_package","Resolve publisher identity; package, test, inspect, and publish","Engineering+Owner","2026-09-25","packages/vscode-3d","A complete 3D workflow inside a Microsoft-owned developer surface","Live Marketplace URL and activated install","https://code.visualstudio.com/api/working-with-extensions/publishing-extension","2026-09-15"
+"P0","18","VS Code Marketplace: three.ws 3D","installable-distribution","ready_to_publish","Publisher threews already exists and is verified; packaged vsix (15 files, 694 KB) passes 71 tests and installs into VS Code 1.138. Owner: create a Marketplace Manage PAT, vsce login threews, npm run publish:marketplace, then OVSX_PAT=<token> npm run publish:openvsx (packages/vscode-3d/PUBLISHING.md)","Owner","2026-09-25","packages/vscode-3d","A complete 3D workflow inside a Microsoft-owned developer surface","Live Marketplace URL and activated install","https://code.visualstudio.com/api/working-with-extensions/publishing-extension","2026-09-17"
"P1","17","Comfy Registry and Manager","installable-distribution","submission_ready","Owner: create Registry publisher `threews` and API key, then run `comfy node publish` from integrations/comfyui/three_ws_nodes (steps in integrations/comfyui/SUBMITTING.md)","Owner","2026-10-02","integrations/comfyui","Working Forge nodes available through the native manager","Live Registry URL and first completed generation","https://docs.comfy.org/registry/publishing","2026-09-17"
"P1","16","Blender Extensions","installable-distribution","compliance_needed","Honor online-access setting; add manifest; package and submit","Engineering+Owner","2026-10-09","integrations/blender","A working Forge add-on on Blender's own discovery surface","Live Extension URL and first completed generation","https://developer.blender.org/docs/handbook/extensions/addon_guidelines/","2026-09-15"
"P0","20","three.ws agent starter template and Codespaces","owned-product-loop","live_template_unverified","Live at https://github.com/nirholas/threews-agent-starter as a template; open a fresh Codespace and confirm port 4173 renders the live agent before linking it from campaigns","Owner","2026-09-21","satellites/agent-starter","A first avatar rendered before a newcomer must clone or understand the monorepo","Live template URL plus template uses Codespaces starts and successful first renders","https://docs.github.com/en/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template","2026-09-16"
diff --git a/packages/vscode-3d/.vscodeignore b/packages/vscode-3d/.vscodeignore
index 59078ac7a..810bddd9c 100644
--- a/packages/vscode-3d/.vscodeignore
+++ b/packages/vscode-3d/.vscodeignore
@@ -7,3 +7,6 @@ build.mjs
**/*.map
**/tsconfig.json
node_modules/**
+package-lock.json
+PUBLISHING.md
+*.vsix
diff --git a/packages/vscode-3d/PUBLISHING.md b/packages/vscode-3d/PUBLISHING.md
new file mode 100644
index 000000000..22bd26130
--- /dev/null
+++ b/packages/vscode-3d/PUBLISHING.md
@@ -0,0 +1,154 @@
+# Publishing three.ws 3D
+
+How to release `threews.vscode-3d` to the
+[Visual Studio Marketplace](https://marketplace.visualstudio.com/vscode) and to
+[Open VSX](https://open-vsx.org) (the registry VSCodium, Cursor, Windsurf,
+Gitpod and other VS Code forks install from). Official references:
+[Publishing Extensions](https://code.visualstudio.com/api/working-with-extensions/publishing-extension)
+and the [Open VSX publishing guide](https://github.com/eclipse/openvsx/wiki/Publishing-Extensions).
+
+This file is excluded from the `.vsix` by `.vscodeignore`.
+
+## Where things stand
+
+- **Publisher identity is resolved.** `package.json` declares
+ `"publisher": "threews"`. That publisher already exists on the Visual Studio
+ Marketplace (display name "three.ws", verified, with another three.ws
+ extension live under it), so no new publisher has to be created. The
+ `threews` namespace also already exists on Open VSX.
+- **The package is ready.** `npm run package` builds a production bundle and
+ writes `vscode-3d-0.2.0.vsix`: 15 files, about 694 KB. It has been installed
+ into a real VS Code 1.138.0 server build with
+ `code-server --install-extension`, and `--list-extensions` reports
+- **What only the owner has:** a Marketplace token for the `threews` publisher
+ and an Open VSX token for the `threews` namespace. Neither is stored on this
+ machine.
+
+## 0. Preflight (one minute)
+
+```bash
+cd packages/vscode-3d
+npm ci
+npm test # 71 tests, must all pass
+npm run package # builds and writes vscode-3d-<version>.vsix
+npx --yes @vscode/vsce ls --no-dependencies # the exact file list that ships
+```
+
+The list must be `CHANGELOG.md`, `LICENSE`, `README.md`, `package.json`,
+`dist/extension.cjs`, `media/icon.png`, `media/cube.svg`, `media/viewer.css`,
+`media/viewer.js`, and the four decoder files under `media/vendor/`. Anything
+else (sources, tests, source maps, `node_modules`) means `.vscodeignore` has
+regressed. Delete the `.vsix` afterwards; it is gitignored and never committed.
+
+Marketplace rules the package already satisfies, worth keeping when editing:
+the icon is a 128x128 PNG (SVG icons are rejected), the README uses only
+absolute `https` links and no SVG images, `repository`, `bugs`, `homepage`,
+`license`, `pricing`, `galleryBanner`, `categories` and `keywords` are set, and
+`engines.vscode` matches `@types/vscode`. A version can be published only once:
+bump `version` in `package.json` and add a `CHANGELOG.md` section for every
+release after 0.2.0.
+
+## 1. Visual Studio Marketplace
+
+### 1a. Get access to the `threews` publisher
+
+1. Sign in at <https://marketplace.visualstudio.com/manage> with the Microsoft
+ account that owns the `threews` publisher. If you are a different account,
+ the owner adds you under **threews > Members** with the **Contributor** role.
+2. Only if the publisher were ever missing: **Create publisher** on the same
+ page, ID `threews`, name `three.ws`. The ID must equal the `publisher` field.
+
+### 1b. Create a Personal Access Token
+
+1. Open <https://dev.azure.com>. Any Azure DevOps organization under the same
+ Microsoft account works; create one if the account has none.
+2. User settings (top right) > **Personal access tokens** > **New Token**.
+3. **Organization: All accessible organizations.** A token scoped to one
+ organization fails with a 401 at publish time.
+4. **Scopes: Custom defined > Show all scopes > Marketplace > Manage.**
+5. Pick an expiry, create, and copy the token.
+
+### 1c. Log in and publish
+
+```bash
+cd packages/vscode-3d
+npx --yes @vscode/vsce login threews # paste the token when prompted
+npx --yes @vscode/vsce verify-pat threews # optional sanity check
+npm run publish:marketplace
+```
+
+`publish:marketplace` runs `vsce publish --no-dependencies`, which runs the
+production build (`vscode:prepublish`), packages, and uploads. The bundles
+already contain every runtime dependency, so `--no-dependencies` is correct.
+
+Non-interactive alternative: `VSCE_PAT=<token> npm run publish:marketplace`.
+If the account signs in through Microsoft Entra ID instead of a token:
+`az login`, then `npx --yes @vscode/vsce publish --no-dependencies --azure-credential`.
+
+## 2. Open VSX (free second listing)
+
+1. Sign in at <https://open-vsx.org> with the GitHub account that is a member of
+ the `threews` namespace (the account that published the existing three.ws
+ extension there). The Eclipse Foundation publisher agreement must be signed
+ under **Settings**; it already is if that account published before.
+2. **Settings > Access Tokens > Generate New Token**, copy it.
+3. Publish:
+
+```bash
+cd packages/vscode-3d
+OVSX_PAT=<token> npm run publish:openvsx
+```
+
+`publish:openvsx` runs `ovsx publish --no-dependencies`, which builds and
+packages the same way. To upload the exact file already published to the
+Marketplace instead: `npx --yes ovsx publish vscode-3d-0.2.0.vsix -p <token>`.
+
+The namespace is currently unverified on Open VSX, so the listing shows a
+warning badge. To remove it, claim the namespace by opening an issue at
+<https://github.com/EclipseFdn/open-vsx.org/issues> (template "Claim namespace
+ownership"). This is optional and does not block publishing.
+
+## 3. Verify the release
+
+Marketplace listings pass an automated scan first, usually within a few
+minutes, before the page and install work.
+
+```bash
+# Marketplace: the gallery API returns the published version
+curl -s -X POST 'https://marketplace.visualstudio.com/_apis/public/gallery/extensionquery' \
+ -H 'Content-Type: application/json' \
+ -H 'Accept: application/json;api-version=7.2-preview.1' \
+ -d '{"filters":[{"criteria":[{"filterType":7,"value":"threews.vscode-3d"}]}],"flags":1}' \
+ | grep -o '"version":"[^"]*"' | head -1
+
+# Open VSX: the registry API returns the published version
+curl -s https://open-vsx.org/api/threews/vscode-3d | grep -o '"version":"[^"]*"'
+
+# A real install into a clean profile
+code --user-data-dir /tmp/vsc3d-profile --extensions-dir /tmp/vsc3d-ext \
+ --install-extension threews.vscode-3d
+code --user-data-dir /tmp/vsc3d-profile --extensions-dir /tmp/vsc3d-ext \
+ --list-extensions --show-versions
+```
+
+Then check by hand:
+
+1. <https://marketplace.visualstudio.com/items?itemName=threews.vscode-3d>
+ shows the icon, the dark banner, the README with working links, and the
+ changelog tab.
+2. <https://open-vsx.org/extension/threews/vscode-3d> shows the same.
+3. In VS Code, open any `.glb` (for example a model from
+ <https://three.ws>): it renders in the **three.ws 3D Viewer** tab, the
+ **three.ws 3D** activity bar icon lists workspace models, and
+ **3D: Generate a Model from Text** returns a model.
+
+## 4. After the first publish
+
+- In `docs/vscode.md`, replace the "not on the Marketplace yet" install section
+ with the Marketplace and Open VSX install, matching this package's README.
+- Add a `data/changelog.json` entry announcing the listing (tags `feature`,
+ `sdk`) and run `npm run build:pages` from the repository root.
+- Set the "VS Code Marketplace: three.ws 3D" row in
+ `marketing/growth/opportunities.csv` to `live`, with the listing URL as
+ evidence.
diff --git a/packages/vscode-3d/README.md b/packages/vscode-3d/README.md
index 64f69f9bc..320919246 100644
--- a/packages/vscode-3d/README.md
+++ b/packages/vscode-3d/README.md
@@ -95,22 +95,31 @@ platform's own inspectors, and generation calls the live studio API.
## Install
-From the workspace root:
+Search for **three.ws 3D** in the Extensions view, or install it by ID:
```bash
-cd packages/vscode-3d
-npm install
-npm run build
+code --install-extension threews.vscode-3d
```
-Then press <kbd>F5</kbd> in VS Code with `packages/vscode-3d` open to launch an
-Extension Development Host, or build a `.vsix` and install it:
+It is listed on the
+[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=threews.vscode-3d)
+and, for VSCodium, Cursor, Windsurf and other Open VSX editors, on
+[Open VSX](https://open-vsx.org/extension/threews/vscode-3d).
+
+To build it from source instead:
```bash
+git clone https://github.com/nirholas/three.ws.git
+cd three.ws/packages/vscode-3d
+npm install
npm run package
code --install-extension vscode-3d-0.2.0.vsix
```
+For development, open `packages/vscode-3d` in VS Code and press <kbd>F5</kbd> to
+launch an Extension Development Host. Maintainers: releasing a new version is
+covered in [PUBLISHING.md](https://github.com/nirholas/three.ws/blob/main/packages/vscode-3d/PUBLISHING.md).
+
## Use it
Open any `.glb` or `.gltf` in the explorer. That is the whole setup: the viewer
@@ -229,13 +238,13 @@ and real committed GLBs.
## Related
-- [`docs/vscode.md`](../../docs/vscode.md) walks through the whole workflow.
-- [`@three-ws/vscode-x402`](../vscode-x402) is the sibling extension for paying
+- [`docs/vscode.md`](https://github.com/nirholas/three.ws/blob/main/docs/vscode.md) walks through the whole workflow.
+- [`@three-ws/vscode-x402`](https://github.com/nirholas/three.ws/tree/main/packages/vscode-x402) is the sibling extension for paying
x402 endpoints from the editor.
-- [`docs/embedding.md`](../../docs/embedding.md) documents every `<agent-3d>`
+- [`docs/embedding.md`](https://github.com/nirholas/three.ws/blob/main/docs/embedding.md) documents every `<agent-3d>`
attribute the diagnostics and completions know.
-- [`@three-ws/glb-diff`](../glb-diff) is the structural differ behind the
+- [`@three-ws/glb-diff`](https://github.com/nirholas/three.ws/tree/main/packages/glb-diff) is the structural differ behind the
compare command, also available as a CLI for CI.
-- [`@three-ws/glb-tools`](../glb-tools) does inspection and baking from the shell.
+- [`@three-ws/glb-tools`](https://github.com/nirholas/three.ws/tree/main/packages/glb-tools) does inspection and baking from the shell.
Apache-2.0. Built by [three.ws](https://three.ws).
diff --git a/packages/vscode-3d/build.mjs b/packages/vscode-3d/build.mjs
index 9a87cab4e..def16afd6 100644
--- a/packages/vscode-3d/build.mjs
+++ b/packages/vscode-3d/build.mjs
@@ -21,9 +21,10 @@ const watch = process.argv.includes('--watch');
const threeLibs = dirname(dirname(require.resolve('three/examples/jsm/libs/basis/basis_transcoder.js')));
// Only what the loaders fetch at runtime: the Draco encoder alone is a megabyte
-// of dead weight in the .vsix.
+// of dead weight in the .vsix. DRACOLoader takes the pure-JS decoder
+// (draco_decoder.js) only when WebAssembly is missing, and every VS Code webview
+// has it (the CSP grants 'wasm-unsafe-eval'), so only the wasm pair ships.
const DECODERS = [
- ['draco/gltf/draco_decoder.js', 'draco/draco_decoder.js'],
['draco/gltf/draco_decoder.wasm', 'draco/draco_decoder.wasm'],
['draco/gltf/draco_wasm_wrapper.js', 'draco/draco_wasm_wrapper.js'],
['basis/basis_transcoder.js', 'basis/basis_transcoder.js'],
diff --git a/packages/vscode-3d/package.json b/packages/vscode-3d/package.json
index 8b6ca72fa..ea28568e9 100644
--- a/packages/vscode-3d/package.json
+++ b/packages/vscode-3d/package.json
@@ -5,6 +5,7 @@
"version": "0.2.0",
"publisher": "threews",
"license": "Apache-2.0",
+ "pricing": "Free",
"homepage": "https://three.ws",
"repository": {
"type": "git",
@@ -386,6 +387,8 @@
"watch": "node build.mjs --watch",
"test": "node build.mjs && node --test \"test/*.test.mjs\"",
"package": "npx --yes @vscode/vsce package --no-dependencies",
+ "publish:marketplace": "npx --yes @vscode/vsce publish --no-dependencies",
+ "publish:openvsx": "npx --yes ovsx publish --no-dependencies",
"vscode:prepublish": "node build.mjs --production"
},
"dependencies": {