Knot for VS Code

Your code. Your machine. Your team. No middleman — now in your editor.

Knot is a peer-to-peer version control system: it takes any folder, turns your saves into real git commits, and replicates them directly between collaborators — no central server, no cloud account. This extension brings Knot into VS Code. It's a client of your local Knot daemon (the same one the CLI, desktop app, and mobile app talk to), so it shows the live state of every folder Knot watches and lets you drive it without leaving the editor.

Nothing this extension shows or does leaves your machine except through Knot's own end-to-end-encrypted peer-to-peer sync.

Requirements

This extension is a client — it needs Knot itself running on your machine:

• The Knot app / daemon (knotd + the knot CLI). If it isn't installed, the Knot sidebar shows a Download Knot button. Get it at pointbreaklab.com/knot.
• Knot AI (Scribe & Delta) — optional. The Delta view's project intelligence (hotspots, untested files, TODOs, "what to work on next") works with just the daemon. The model-powered per-commit review needs the local Knot AI model — the Delta view's status row tells you if it's set up and offers a one-click Set up Knot AI.

What you get

Open the Knot icon in the Activity Bar for three views, plus two webviews.

🗂 Projects

Every folder Knot watches, with a live sync state (synced / saving… / paused / manual). Expand a project to:

• Toggle Live mirror, Auto-commit, and Auto-push with a click.
• See recent commits — real messages, with ✨ for AI-polished and 🤖 for agent-authored; click one to view its diff.
• Decide: Sync now · Set next commit message · Undo an AI session · Resolve a diverged push (3-way merge/keep-mine/keep-theirs) · Manage git remotes.

🔎 Delta

Project intelligence from the local Delta reviewer, computed from your dependency graph + git history (no model required):

• What to work on next — a ranked radar, each item with the evidence behind it.
• Hotspots (churn), files without tests, TODOs & FIXMEs, reverts.
• A status row showing Knot AI / Delta readiness.

🧠 Memory

The lessons in your project's knot.md — the glass-box memory an AI agent recalls each session, synced privately to your devices. Add, search, open, and delete lessons; curate what the AI learns.

📊 Dashboard

A visual overview: projects watched, syncing, unsaved changes, peer connections, and a card per project. Command Palette → Knot: Open Dashboard.

⚡ Activity (live)

A real-time, color-coded feed of what's happening across your repos — agent actions, Delta/AI events, the deletion/scope guards firing, sync, peers. Command Palette → Knot: Open Activity, or the pulse icon in the sidebar.

Notifications

Toasts for the things worth interrupting for — a diverged remote, an error, the deletion guard restoring a file, an incoming push to resolve — with Resolve / Manage buttons. Everyday noise is filtered out. Tune with knot.notifyLevel.

Getting started

1. Install Knot and make sure the daemon is running.
2. Install this extension and open a folder.
3. Open the Knot sidebar → Protect This Folder. Your saves are now commits.

Settings

How it connects

• Reads go over the daemon's unix socket as newline-delimited JSON-RPC.
• Actions shell out to the knot CLI. No feature is CLI-only or UI-only.

Status

Preview / pre-alpha, matching Knot itself. Windows uses a named-pipe IPC that this extension doesn't speak yet (macOS and Linux only for now).

Knot is a PointBreakLab project. Reach out via the contact form at pointbreaklab.com.