Commons for VS Code

Share code, notes, links and files with your team's Commons spaces without leaving the editor. Works in VS Code and in editors built on it: Antigravity, Cursor, Windsurf and VSCodium.

Features

Spaces sidebar: every space you've joined that hasn't expired, with unread counts, "view only" labels and time left. ★ marks your default space.
Rooms open as editor tabs: click a space to open the full live room in a tab, styled with your theme. You can paste, react, reply, pin and resize cards there.
Insert at cursor / Open in editor: on any code or note card, put a teammate's snippet straight into your file, or open it in a new editor with the right language.
Send selection: right-click in the editor → Send Selection to Commons, or press Ctrl+Alt+Shift+C (Cmd+Alt+Shift+C on macOS). The language and the file's relative path and line numbers are included.
Send terminal selection: right-click in the terminal to share an error or log.
Send file: right-click a file in the Explorer → Send File to Commons (up to 10 MB).
Status bar: ◉ Hackathon team · 3 here shows your default space and who's in it. Click it to switch.
Unread badge: a count on the Commons icon when teammates drop something new. No pop-ups.

Getting started

Click the Commons icon in the activity bar.
Create a Space, or Join a Space by pasting a link like https://commons.sophon.in/s/brave-otter-4821 (or just the code).
Select some code → right-click → Send Selection to Commons.

Settings

Setting	Default
`commons.serverUrl`	`https://commons.sophon.in`	The Commons server to use
`commons.includeSourcePath`	`true`	Include the file path and line numbers when sending code

Privacy

Access tokens are stored in VS Code's encrypted SecretStorage.
The extension only reads code, terminal text or files when you explicitly send them.
File paths are sent relative to the workspace. Files outside the workspace send only their name.

Development

cd extension
npm install
npm run build:webview      # builds the room UI from ../src into media/webview
npm run build              # bundles the extension into dist/
npm run package            # → commons-vscode-<version>.vsix
COMMONS_TEST_SERVER=http://localhost:3001 node test/runTest.mjs   # integration tests in a real VS Code

Install the .vsix from the Extensions view: ⋯ → Install from VSIX…

Commons