Supervisor

Supervisor is a local, read-only extension for VS Code, Cursor, and compatible VS Code–family editors. It helps you check whether a Git workspace is safe to hand off to an AI coding agent before the agent starts work.

It surfaces dirty working trees, default-branch risk, open PR context, stale or cleanup branches, and terminal branches. It can copy honest handoff evidence into your agent prompt. Supervisor does not merge PRs, delete branches, publish extensions, run billing, upload code, or certify remote CI.

Marketplace item: FreeSpirit.supervisor
Publisher: FreeSpirit
Pricing: Trial, with optional Early Access unlock

Install and Open

1. In Extensions, search Supervisor: Agent Readiness and install the item from publisher FreeSpirit.
2. Reload the editor window when prompted.
3. Open a Git workspace folder.
4. Run Supervisor: Open Dashboard from the Command Palette, or select the Supervisor Activity Bar icon and open Status.

Installed extension id may appear as freespirit.supervisor in some editors.

What You Get

Early Access Unlock

Use Unlock Early Access — €9 one-time in the dashboard, or open the live Stripe Payment Link:

https://buy.stripe.com/aFa7sEbz5fnRbybgY91ck00

After purchase, the operator fulfils a local license key manually using the support/contact path from your purchase or the Marketplace listing. Enter the key with Supervisor: Enter Early Access License. The license key is stored locally in your editor only; v1 has no license server, webhook, payment-data sync, or network validation.

The extension accepts Early Access payment links only from trusted HTTPS Stripe Payment Link hosts (buy.stripe.com or pay.stripe.com) and rejects /test_ Stripe paths.

Who This Is For

• Developers who use Cursor, VS Code, or compatible forks with AI agents daily.
• Anyone who wants a repeatable pre-agent check and a copyable handoff block.
• Anyone who has started agent work on the wrong branch or with a dirty tree.

Requirements

• VS Code 1.80+ or a compatible VS Code–family editor.
• Git on PATH for local snapshot and readiness features.
• Optional: GitHub CLI (gh) for read-only PR/review evidence. Supervisor does not write to GitHub.

Status Cockpit (Activity Bar)

After install, open the Supervisor icon in the Activity Bar and select Status for a compact view:

• Can you delegate work to an agent now? (Ready / Blocked / Needs attention / Limited)
• What to do next (plain-language action)
• Quick buttons: Open Dashboard, Copy Next Safe Action, Copy Agent Handoff, Refresh

The full Supervisor Dashboard editor tab remains the detail surface for setup checklist, Branch & PR Overview, readiness gates, and evidence.

Cockpit, dashboard, and the status bar share one workspace observation refresh (one Git/gh pass per refresh). Refresh in the cockpit or dashboard updates all surfaces together.

Status Meanings

PR complete means the prior PR on this branch is merged or closed — switch to default branch and start fresh; do not delegate on the terminal branch.

First-Run Onboarding

1. Supervisor: Open Dashboard — review setup state (Git, optional gh, proof availability).
2. Supervisor: Run Agent Readiness Gate — advisory safe_to_start / needs_attention / blocked from local Git rules.
3. Supervisor: Generate Agent Handoff Preflight — copy the block into your agent prompt.
4. Optional: Supervisor: Run Local Proof when the workspace includes the Supervisor proof script.
5. Supervisor: Clear Local State — removes Supervisor-owned editor storage only (not your Git history).

A one-time dashboard hint may appear after install; dismiss it when you are oriented.

Standard agent workflow is the default public path (everyday language on primary surfaces). Macro / AGENT_RUN workflow is optional and advanced — enable it under Workflow settings only if you use structured operator runs; it is not required for normal agent handoff.

Commands

What Supervisor Does Not Do

• Automerge or approve pull requests (claims_ready_to_merge: false by policy).
• Write to GitHub (read-only git / gh evidence only).
• Delete or clean up branches automatically (cleanup labels are advisory only).
• Backend accounts, cloud sync, telemetry, or billing.
• Guarantee Open VSX listing, legal compliance, privacy certification, or merge readiness.

Privacy

Supervisor is local-first and read-only. It does not operate a cloud backend, create user accounts, collect product telemetry, handle payment instruments, or upload your Git data. Local Git snapshots, optional gh output, and copied handoff text stay under your control unless you choose to share them.

Support and Changes

Use the public Marketplace Q&A/contact controls on the Supervisor listing for install, purchase, and license-fulfilment questions. For paid Early Access, include your purchase reference when contacting support. Never post secrets, tokens, cookies, .env contents, or private credentials publicly.

The packaged VSIX also includes SUPPORT.md, PRIVACY.md, CHANGELOG.md, and LICENSE for local reference after install. The source repository is private; public buyers do not need repository access to install or use the Marketplace build.

Version

Version 1.0.1 is a public Marketplace README/link-hardening update only. It does not change publisher, extension id, pricing, payment URL, licensing model, or product scope.