Beam — VS Code Extension

Ultra-fast AI inline code completions backed by the Beam edge API.

How it works

VS Code → beam-agent (localhost:7878) → Beam edge API → AI model

The extension talks to a local beam-agent daemon that manages your API key, caches completions, and prefetches the next suggestion in the background. The daemon starts automatically when the extension activates.

Getting started

1. Install beam-agent

The extension will try to start beam-agent automatically using one of:

Bundled binary — shipped inside the .vsix (no extra steps)
Global install — npm install -g beam-agent
npx fallback — npx beam-agent (slower first start, no install needed)

2. Set your API key

Sign up at beam.resynapse.dev and go to Account → API Keys.
Create an API key (starts with rudy_).
Open the Command Palette (Cmd+Shift+P) and run Beam: Set API Token.
Paste your key — it is forwarded to the daemon and stored at ~/.beam/config.json.

The status bar shows ⚡ Beam when authenticated and ⚡ Beam (add API token) when no key is set.

Usage

Action	How
Auto-trigger	Just type — completions appear after a short delay
Explicit trigger	`Cmd+Shift+Space` (Mac) / `Ctrl+Shift+Space` (Windows/Linux)
Accept suggestion	`Tab`
Dismiss	`Escape`

Running locally (development)

Prerequisites: Node 18+, VS Code 1.85+

1. Install dependencies

cd vscode
pnpm install

2. Build (watch mode)

pnpm watch

This compiles TypeScript into out/ and rebuilds on every change.

3. Open in VS Code Extension Development Host

Open the vscode/ folder in VS Code
Press F5 (or Run → Start Debugging)

VS Code opens a new Extension Development Host window with Beam loaded.

4. Point at your local API

In the Extension Development Host window:

Open Settings → search for Beam
Set beam.daemonUrl to http://localhost:7878 (default, no change needed)

Run the local daemon:

cd agent
pnpm dev

Run the local API:

cd api
pnpm dev

Configuration reference

Setting	Default	Description
`beam.daemonUrl`	`http://localhost:7878`	URL of the local beam-agent daemon
`beam.autoStartDaemon`	`true`	Automatically start beam-agent if not running
`beam.enableAutoTrigger`	`true`	Show completions automatically while typing
`beam.debounceMs`	`0`	Delay (ms) before auto-trigger fires
`beam.maxPrefixLength`	`8000`	Characters sent before the cursor
`beam.maxSuffixLength`	`2000`	Characters sent after the cursor

Packaging

pnpm package

Produces a .vsix file that can be installed via Extensions → Install from VSIX.