Quick Start

1. Install the extension

Install from the VS Code Marketplace  or download a VSIX  for Cursor, VSCodium, or other forks.

On first use, the extension automatically installs:

• Deno  — the awesome secure TypeScript runtime that executes your tests. Think Node.js, but with built-in TypeScript, a permission model, and no node_modules.
• Glubean CLI  — where the magic happens. Every ▶ button click, every trace file, every diff — it’s all the CLI doing the work. The extension is the UI; the CLI is the engine.

Tip: Also install the Deno extension  to get full TypeScript type-checking and IntelliSense in your test files.

2. Create a project

Once the CLI is installed, scaffold a new project:

mkdir my-project && cd my-project
glubean init

glubean init creates:

• deno.json — with the @glubean/sdk import map
• explore/ — for quick, uncommitted API exploration
• tests/ — for permanent, CI-ready tests
• A starter test file to get you running immediately

You can also run Glubean: Initialize Project from the Command Palette (Cmd+Shift+P) to scaffold directly into the current workspace folder.

3. Run your first test

Open the generated *.test.ts file and click the ▶ button in the gutter next to any test( call. The response opens in Glubean’s Trace Viewer right beside your code.

Manual install

The extension auto-installs Deno and the CLI on first use. If that fails (e.g. network restrictions), install manually:

# Cross-platform via Deno
deno install -Agf -n glubean jsr:@glubean/cli
 
# Optional script-based install
curl -fsSLo /tmp/glubean-install.sh https://glubean.com/install.sh
sh /tmp/glubean-install.sh

What’s next?

• Running Tests — gutter buttons, Test Explorer, data-driven tests, Tasks Panel
• Traces & Diff — trace history, Copy as cURL, diff with previous run
• Environments & Secrets — .env files, secrets, status bar switcher
• AI Integration — generate tests from OpenAPI specs with any AI assistant