Skip to main content

Zeq for VS Code

Zeq — Physics Virtual Machine turns VS Code into a full client for ZeqVM. Build real applications on 316 deployable state contracts and 1,597 operators, run real physics with a verifiable ZeqProof — language-agnostic, AI-optional, without leaving your editor.

Install​

  1. Download the VSIX above.
  2. In VS Code: Cmd/Ctrl+Shift+P → Extensions: Install from VSIX… → pick the file.
  3. Reload the window (required for VS Code to load it).
  4. Click the status-bar button (bottom-right) to open the Control Center.

The Control Center​

One dashboard, every capability as a clickable card — open it from the status bar. Tabs:

  • Home — what ZeqVM is, a live 1.287 Hz pulse, and the start-to-finish build pipeline.
  • Build — scaffold web / API / Python / CLI starters and one-click-install from 70+ curated libraries (npm · pip · cargo · go) straight into your folder.
  • State Contracts — the core build primitive: deploy from 84 real templates, or describe a contract in plain English and the framework drafts an operator-grounded definition. See the contracts running on your machine.
  • Compute — run real operator chains and get a CKO envelope: operator chips (KO42 first), Master Sum, R(t), phase, Zeqond tick, ZeqProof, and a precision gauge (≤ 0.1%).
  • Operators — search the full 1,500+ operator registry with formulas.
  • Protocols — browse 234 protocol building blocks, each with a ready-made deployable state contract, with one-click insert.
  • Skills — 90 drop-in capability packs (kernel, security, awareness, temporal, plus industry packs for healthcare, aerospace, biotech, energy and more).
  • Channels — state machines, the entangled state, and oracles, explained.
  • Agent tools — @zeq chat, the 7-step wizard, and Claude Code setup.
  • SDK & Docs — the full SDK opens inside VS Code (Simple Browser tab), with an open-external option.
  • Account — create an account or sign in (Simple · Expert · .ZEQ), settings, sign out. Creating an account first shows a screen to save your generated password/equation and download your .ZEQ recovery file — there is no password reset — before you're signed in.

Commands​

Everything is also a command — open the palette and type Zeq:. You never need them (the dashboard surfaces all of it), but they're there: Compute, Prove, Verify, Browse Protocols/Operators, Chain — Recent / My Activity, Machines — Top, Observer, Build Anything, Run 7-Step Wizard, Open SDK Docs, Check all framework domains, and more.

Keyboard: Cmd/Ctrl+Alt+Z runs a compute · Cmd/Ctrl+Alt+C opens chat.

ZeqGit — your workspace is a repo​

The folder you have open is a ZeqGit project. The extension binds it to a unique private repo named from the folder, with a stable hash appended so it never collides with another project — and because the hash is derived from the folder, reopening re-binds to the same repo and a rename keeps it (renaming never forks a new repo). This is the same per-project repo system as the web Workbench and the Chrome extension, driven by one shared module so the three never drift.

  • Zeq: Sync workspace to ZeqGit — confirms/renames the project, then mirrors your workspace (text files, sensibly capped, node_modules/.git/build excluded) into the repo. Every file is a ZeqProof-anchored commit. The success notification links straight to the repo and to the Observer for proof-of-computation.
  • Zeq: Open this workspace's ZeqGit repo — opens the repo on zeq.dev/zeqgit.
  • Status bar shows the bound repo at a glance; click it to sync.
  • Optional auto-save — enable zeq.zeqgit.autoSave and every file you save in the workspace is mirrored to the repo automatically, each commit ZeqProof-anchored.

One ZID is one ZeqGit account — the same repos you see in the editor are the ones on the web and in the browser.

The contract​

The extension honours the framework's locked rules on every surface:

  • KO42 is always operatorChain[0]; never skipped.
  • Numeric answers are never fabricated — every value comes from /api/zeq/compute (or the free-tier /api/zeq/prove).
  • Awareness operators (ON0, ZEQ000, VX) are clearly labelled speculative.
  • precisionBound ≤ 0.1% — above that, a shift is triggered.
  • Time is in Zeqonds (0.777 s), phase-locked to the 1.287 Hz HulyaPulse.