KODEO for VS Code

Edit KODEO projects live from VS Code. Open a project straight from KODEO — nothing to download, and it works on vscode.dev — or a folder on your computer that stays in sync. Either way you're in the room: your teammates in the browser see your cursor as you type, and you see theirs.

Works in VS Code, VS Code Insiders, vscode.dev and github.dev, GitHub Codespaces, Remote SSH / WSL, and — from Open VSX — Cursor, Windsurf and VSCodium.

What you get

Live editing — character by character with teammates in the browser or in VS Code. Every keystroke is merged by the same CRDT the web editor uses, so nobody overwrites anybody. A ✓ in the status bar says the room has every edit you've made.
A side bar with room for everything — Project (live, who's here and in which editor, who's typing, who's following you, who's running the project, your plan's usage), Comments (every thread, filtered), Activity (your notifications), Pull Requests & Checks and Project Tools (shared terminals, checkpoints, the trash, your sign-ins).
Chat, Assist, Help and Support in one panel — the room's chat with @mentions, KODEO Assist with past conversations, the whole Help Center searched as you type, and your support tickets. Next to the terminal, or beside your code.
Notifications everywhere — they reach VS Code even with no project open. Mentions open the comment thread itself; your own settings, pause and quiet hours decide what pops up — once, in the window you're using. "Send to my computer" from your phone pops up straight away.
Presence — teammates' cursors and selections in their colours; their initials on the files they have open (explorer, tabs, Go to File). Follow someone's file, cursor and scrolling; see who follows you and ask them to stop.
Teammates' terminals — watch a terminal a teammate shares from the browser, live in a VS Code terminal, and ask for the keyboard.
Comments — the project's comment threads in VS Code's own Comments UI, pinned to the right line even after edits above them. Alt+C comments on the current line; @ suggests teammates.
Source Control — the project's own Git: per-person staging, commits with co-authors, the commit graph, KODEO History, blame for a line or the whole file, branches (GitHub's too), merges in the 3-way merge editor, stashes, tags, GitHub, CI — and pull request reviews right in VS Code (files, line comments, approve, request changes, merge, check out). Branch rules are shown before anything is refused. GitHub tokens never reach VS Code.
Switch and start projects — Alt+K for recent and every project; New Project… from a template.
Undo is yours — Ctrl+Z / ⌘Z undoes your own edits, never a teammate's.
Nothing is load-bearing — if the live connection drops, KODEO switches to Solo mode: saves are version-checked and nothing you type is lost; a kodeo:// save made offline waits on your computer and goes out — version-checked — when you're back. Uninstalling the extension changes nothing for anyone else.

Two ways to open a project

	Straight from KODEO (`kodeo://`)	Linked folder
Download	Nothing — files arrive as you open them	The whole project, once
Works on vscode.dev	Yes	No (it needs a disk)
Live editing	Every open file	Every open file
Other files	Saved straight to KODEO	Sent when you save, all or nothing
Local terminal, tests, dev servers	—	Yes, private, no runtime hours

Open one with KODEO: Open Project…, clone one with KODEO: Clone Project into a Folder…, or click Open in VS Code in the KODEO editor.

Signing in

Choose KODEO: Sign In (or KODEO in VS Code's Accounts menu) and approve the request on kodeo.website with your passkey or two-factor, as usual.

The code that comes back works once, for one minute, and only with a secret this editor holds (PKCE).
Your sign-in is bound to an Ed25519 key only this editor has; every refresh is signed with it, so a copied token is useless.
It's kept in VS Code's secret storage (your operating system's keychain on desktop) — never in settings, the workspace or a log.
It's listed in KODEO under Settings → Local access and ends with everything that ends a sign-in: signing out, a password change, "This wasn't me", or a workspace policy.

No browser on this machine? Use KODEO: Sign In with a Code. Already signed in with the kodeo CLI? KODEO: Use My kodeo CLI Sign-In makes a new sign-in for VS Code; nothing is copied.

Security

The same roles as the browser: a Viewer gets a read-only file system, and the server drops their edits whatever the client does.
In an untrusted folder KODEO is read-only until you trust it.
Chat, comments and notifications are shown as text, never HTML. Webviews use a strict Content Security Policy with no remote scripts.
A token (or anything that looks like a secret) typed into a comment or chat is masked before it's sent.

Commands

All 83 commands are in the Command Palette under KODEO: and KODEO Git:.

Command	What it does
KODEO: Sign In	Approve in your browser (passkey or two-factor as usual). The code comes back through the extension’s own link and works once.
KODEO: Sign In with a Code	For machines without a browser: approve a short code at kodeo.website/device.
KODEO: Use My kodeo CLI Sign-In	A new VS Code sign-in from your signed-in kodeo CLI — nothing is copied. Desktop only.
KODEO: Sign Out	Ends this editor’s sign-in on KODEO too.
KODEO: Manage Sign-ins and Tokens	Your computers signed in to the CLI, VS Code or Git, and your tokens, in Settings → Local access. Project Tools → Sign-ins signs one out from VS Code.

Projects

Command	What it does
KODEO: Switch Project… (Alt+K)	Recent projects first, then every project you can reach, by workspace — the button on a row opens it in a new window.
KODEO: Open Project…	Pick a project (or paste acme/storefront:src/app.ts:42): your linked folder if this computer has one, otherwise straight from KODEO.
KODEO: New Project…	A workspace, a name and a template — KODEO writes the starter files, then it opens here.
KODEO: Clone Project into a Folder…	Real files that stay in sync — the same folder `kodeo clone` makes. Desktop only.
KODEO: Sync Linked Folder Now	Pull teammates’ changes and send yours, right now.
KODEO: Send Offline Saves Now	Saves made while offline wait on this computer and go out by themselves when KODEO is back — this tries at once (version-checked, never over a teammate’s newer save).
KODEO: Go to File… (Ctrl+P (kodeo://))	Every file in the project, with who has it open — also ⌘P / Ctrl+P in a kodeo:// window.
KODEO: Search in Project… (Ctrl+Shift+F (kodeo://))	KODEO’s own project search, results opening at the line — also ⌘⇧F / Ctrl+Shift+F in a kodeo:// window.
KODEO: Open in Browser	This file and line in KODEO’s web editor.
KODEO: Copy Link to This Line	A link teammates can open in the browser or VS Code.
KODEO: Create Checkpoint	A named checkpoint of this file — the same history as the web editor.
KODEO: Checkpoints…	Pick one to compare with the file now, and restore it from there (for everyone, undoable).
KODEO Trash: Empty Trash	Project Tools → Trash lists deleted files for 7 days — Restore brings one back for everyone; this empties it for good.
KODEO: Run in KODEO	Opens the project’s Run panel in the browser — the shared runtime teammates can watch.
KODEO: Open Billing	The workspace’s plan, storage and runtime hours (Project → Plan & usage shows them here).

In the room

Command	What it does
KODEO: Follow a Teammate…	Follow their file, cursor and scrolling. Typing, scrolling or Esc stops.
KODEO: Stop Following (Esc)	Stop following.
KODEO: Stop Everyone Following Me	Anyone following you stops (in the browser too), and nobody can follow you for a minute.
KODEO: Bring Everyone Here	Send the room to your line, with a note.
KODEO: Watch a Teammate’s Terminal…	A terminal a teammate shares from the browser, live in a VS Code terminal — read-only; press Enter in it to ask for the keyboard.
KODEO: Comment on This Line (Alt+C)	Start a comment thread on the line — teammates see it in the browser at once; @ suggests people to mention.
KODEO: Suggest a Change to These Lines	A comment that proposes new text for the selected lines: paste the ```suggestion block it copies, edit it, and post. Anyone who can edit applies it with one click — Apply Suggestion on the thread here, or Apply in the browser.
KODEO: Filter Comments…	The Comments view: open threads, resolved ones, yours, or where you’re mentioned.
KODEO: Share Port with KODEO…	Desktop: an app running on this computer gets its own link on KODEO’s preview domain — teammates, signed-in people, anyone, a password or a webhook URL. Loopback only; requests are logged to the “KODEO Preview” output. The Previews view lists everything shared in the project — open a teammate’s running app in your browser or beside your code.
KODEO: Shared Ports…	The ports you’re sharing from this computer: copy a link, open it, see who’s watching, stop.
KODEO: Open Preview in VS Code	A live app — yours or a teammate’s — in a VS Code tab: pick the app, reload, phone / tablet / laptop sizes, who’s watching (and from where), copy the link, open in your browser. The Previews view lists the project’s live apps, one per person and port; click one to watch it here.
KODEO: Show People (Ctrl+Shift+J / ⌘⇧J)	Who’s here (and in which editor), who’s following whom, who’s running the project.
KODEO: Keyboard Shortcuts (Alt+/)	Every KODEO shortcut in one list — pick one to run it, or change the keys.
KODEO: Undo My Last Edit (Ctrl+Z / ⌘Z)	Undo in a live file — only your own edits, never a teammate’s.
KODEO: Redo My Last Edit (Ctrl+Shift+Z / ⌘⇧Z)	Redo your own edit.
KODEO: Show KODEO Menu	Everything you can do from here, grouped (also the status bar item).
KODEO: Open KODEO Dashboard in Terminal	Runs `kodeo ui` — the kodeo CLI’s full-screen dashboard — in a terminal tab, for this linked folder or the open project. Needs the CLI (2.0+).
KODEO: Install or Update the kodeo CLI	Runs `npm i -g @kodeohq/cli` in a terminal you can see.
KODEO: Refresh	Reload the project’s files, Git state, comments, usage and notifications.

Chat, Assist, Help and Support

Command	What it does
KODEO: Open Chat (Alt+J)	The room’s chat, in the KODEO panel — @ suggests teammates.
KODEO: Open Chat in an Editor Tab	The chat as an editor tab — as wide as you like.
KODEO: Ask Assist (Alt+A)	KODEO Assist in the KODEO panel — answers stream in, with the Help articles they come from, and past conversations to resume. It’s told which editor you’re in and whether you’re live — never your code.
KODEO: Search Help…	The whole Help Center, searched instantly as you type; articles open in the panel.
KODEO: Support Tickets	Your tickets: follow the replies, mark one solved, rate the help.
KODEO: New Support Ticket…	A person from KODEO replies. VS Code attaches its state (editor, live or not, version) — never code.

Notifications

Command	What it does
KODEO: Mark All as Read	Your KODEO notifications (the Activity view), all read.
KODEO: Notification Pop-ups…	Which notifications pop up in VS Code (important · everything · off), pause them for an hour, unmute a project — or open your KODEO notification settings.

Source Control (the project’s Git)

Command	What it does
KODEO Git: Commit	Commit your staged changes — with co-authors from the room. Live files are settled first, so the commit holds what’s on screen.
KODEO Git: Commit & Push	Commit, then push to GitHub (on KODEO’s server).
KODEO Git: Commit (Amend)	Amend the last commit — refused once it’s pushed.
KODEO Git: Stage All Changes	Your staging is yours — teammates stage their own.
KODEO Git: Unstage All Changes	Unstage everything you staged.
KODEO Git: Switch Branch…	Your branches and GitHub’s (checked out as a local branch) — switches the project for everyone; your uncommitted changes are parked and come back.
KODEO Git: Create Branch…	A new branch, optionally switching to it.
KODEO Git: Pull	From GitHub, merged on KODEO’s server.
KODEO Git: Push	To GitHub — your GitHub token never reaches VS Code. A protected branch says so before anything is refused.
KODEO Git: Fetch	What’s new on GitHub.
KODEO Git: Fetch the Full History	A shallow clone’s whole history, on demand.
KODEO Git: Show Branch Rules	This workspace’s rules for the default branch: protected (admins only) and pull requests required.
KODEO Git: Publish to GitHub…	Create a GitHub repository for this project.
KODEO Git: Initialize Repository	Start Git for this project (for everyone in it), with an optional .gitignore.
KODEO Git: Clone from GitHub…	Any public repository by link, or one of yours — its files become the project’s (the old ones go to the trash).
KODEO Git: Link a GitHub Repository…	Point pushes and pulls at an existing GitHub repository.
KODEO Git: Unlink GitHub Repository	Stop syncing with GitHub; the history stays.
KODEO Git: Merge Branch…	Merge another branch into the current one — conflicts show up in Source Control and in the files.
KODEO Git: Open in Merge Editor	Resolve a conflicted file in VS Code’s 3-way merge editor (or with Accept Current / Incoming / Both above each conflict).
KODEO Git: Abort Merge	Put the files back as they were before the merge.
KODEO Git: Rename Branch…	Rename a branch.
KODEO Git: Delete Branch…	Delete a branch (asks before dropping unmerged work).
KODEO Git: Stash Changes…	Put your changes aside; Pop / Apply / Drop Stash… bring them back or discard them.
KODEO Git: Pop Stash…	Apply a stash and drop it.
KODEO Git: Apply Stash…	Apply a stash and keep it.
KODEO Git: Drop Stash…	Delete a stash for good.
KODEO Git: Create Tag…	Tag the current commit (a message makes it annotated). Right-click a commit in KODEO History to tag that one.
KODEO Git: Delete Tag…	Delete a tag on KODEO.
KODEO Git: File History	The commits that changed this file, in KODEO History (Source Control) — each opens as a diff; right-click to restore that version.
KODEO Git: Show Commit Graph	Every branch drawn as lanes, in an editor tab — click a commit for its files and diffs, right-click for branch, tag, copy and GitHub.
KODEO Git: Toggle File Blame	Who changed every line of this file, and when — shaded by age.
KODEO Git: Refresh	Reload the repository state.
KODEO Git: Create Pull Request…	From the current branch to the default one.
KODEO Git: Refresh	Reload pull requests and CI checks. Click a pull request to review it in VS Code: files, line comments, approve or request changes, merge, check out.

This computer

Command	What it does
KODEO: What’s New	The walkthrough: what KODEO for VS Code does, step by step.
KODEO: Reset KODEO on This Computer…	Sign out and forget what KODEO keeps here — cached files, recent projects, the Help index, pop-up choices, offline saves (it says how many first). Settings and projects are untouched.

Settings

Setting	What it does
`kodeo.server`	The KODEO server (https only; http://localhost for development). Default https://www.kodeo.website. Not synced between computers.
`kodeo.notifications.popups`	Which KODEO notifications pop up in VS Code: important (default — Push-on types, mentions, replies, reviews, support replies, anything sent to this computer) · all · off. KODEO’s pause and quiet hours apply.
`kodeo.presence.showNames`	Show teammates’ names next to their cursors (initials once they’re still); hover a cursor for who, where and what. Left unset (2.2+), it follows your KODEO editor setting — always, while typing, or on hover only; on or off here overrides it.
`kodeo.presence.explorerBadges`	Badge files teammates have open — explorer, tabs, Go to File — with their initials. Default on.
`kodeo.roomMessages`	Pop up teammates’ comments, replies, chat messages and someone starting to follow you. Default on.
`kodeo.git.inlineBlame`	Who last changed the line your cursor is on, at the end of the line. Default on.
`kodeo.linkedFolder.syncOnSave`	In a linked folder, send saved files to KODEO right away. Default on.
`kodeo.openLinksIn`	Where Open in VS Code links open a project: linked (default) · remote · ask. Per computer.
`kodeo.accessibility.announce`	Announce who joins or leaves the room, and the room going offline or back: auto (default — with VS Code’s screen-reader mode) · always · never.
`kodeo.telemetry.sharePerformance`	Send a few anonymous speed numbers (activation, opening a project, joining the room, edit round trips). Off by default, and never while VS Code’s telemetry is off.

Requirements

A KODEO account (free) — kodeo.website.
On vscode.dev: a current Chrome, Edge, Firefox or Safari (for Ed25519 in Web Crypto).

Help

Licensed under the MIT licence.

KODEO