CosmicCode for VS Code
Pre-release, private pilot. CosmicCode is available to invited developers
only. Without pilot access and an API key the extension can't connect.
Request access.
CosmicCode gives your AI assistant (GitHub Copilot agent mode, or any MCP
client in VS Code) tools to search your repository by meaning, look up
signatures, trace dependencies and see its architecture, from an index of your
code hosted by PanSynapse.
Get started
- Install the extension. A Get started with CosmicCode walkthrough opens.
- Run CosmicCode: Sign In (or click CosmicCode: Sign in in the status bar).
Your browser opens app.pansynapse.com:
- Have an account with CosmicCode: click Connect. VS Code gets its own API
key, kept in VS Code's secret storage; there's nothing to copy.
- New to PanSynapse: choose Create an account. One approval gives you the
account and CosmicCode; we email you, you set a password, then run
CosmicCode: Sign In again.
- Account without CosmicCode: click Request access; we email you when it's on.
- Open a repository. CosmicCode asks before indexing it: its source files are
uploaded to PanSynapse, and each repository counts toward your repository limit.
- In Copilot Chat (agent mode), the CosmicCode tools appear under the
CosmicCode server.
The status bar shows the index state. Click it for actions.
Claude Code
Run CosmicCode: Connect Claude Code (or accept the offer after indexing). It
adds CosmicCode to Claude Code for the open repository with claude mcp add --scope local, so it lives in your private Claude Code settings for that project,
not in a committed file. Start a new Claude Code session in the folder and the
cosmic_* tools are available. Keep the extension installed: it keeps the index
in sync.
Without VS Code: claude mcp add --transport http --scope local cosmiccode https://mcp.pansynapse.com/code --header "Authorization: Bearer <key>" --header "X-CosmicCode-Repo: <repository ID>".
What gets uploaded
Files CosmicCode can parse (Python, TypeScript/JavaScript, Go, Rust, C) that
git doesn't ignore: tracked and untracked files, honouring .gitignore. Files
over 1 MB or not UTF-8 are skipped. Outside git, everything except
node_modules, virtualenvs, dist/build and similar folders.
After the first index, only changed files are sent: on save, branch switch,
pull or rebase, and on a check every 30 minutes.
Commands
| Command |
What it does |
| CosmicCode: Sign In / Sign Out |
Sign in through the browser (VS Code gets its own key) / remove the key from this machine |
| CosmicCode: Enter API Key Manually |
Paste a key from the web app's API keys page instead |
| CosmicCode: Index This Repository |
Start indexing the current folder |
| CosmicCode: Re-index Repository |
Upload everything again |
| CosmicCode: Delete This Repository's Index |
Delete the uploaded code and index from PanSynapse; frees a repository slot |
| CosmicCode: Connect Claude Code |
Add CosmicCode to Claude Code for this repository |
| CosmicCode: Copy Repository ID |
The ID PanSynapse uses for this repository |
| CosmicCode: Show Status / Show Log |
Details and troubleshooting |
Settings
cosmiccode.appUrl: the PanSynapse web app used for sign-in. Leave as is unless PanSynapse asks.
cosmiccode.serverUrl: the CosmicCode endpoint. Leave as is unless PanSynapse asks.
cosmiccode.sync.enabled: keep indexes in sync as you work (default on).
cosmiccode.sync.maxFiles: stop syncing repositories with more files than this (default 20,000).
Development
npm install
npm test # compile + unit tests (node:test)
npm run package # builds cosmiccode-<version>.vsix
Releasing
- Bump
version in package.json and add a ## <version> entry to CHANGELOG.md.
Odd minor = pre-release (0.1.x, 0.3.x), even minor = release (0.2.x).
- Merge to
main, then git tag v<version> && git push origin v<version>.
- The Release workflow checks the tag matches
package.json, the changelog
entry exists and the commit is on main, runs the tests and builds the .vsix.
- Approve the
marketplace deployment in the run (Actions → Release → Review
deployments). It then publishes that .vsix to the Marketplace and creates a
GitHub Release with it attached.
Needs the VSCE_PAT secret on the marketplace environment (Azure DevOps token,
organization "All accessible organizations", scope Marketplace → Manage; expires,
renew before it does).
Press F5 ("Run CosmicCode") to try it in an Extension Development Host. To use
the dev environment, set cosmiccode.appUrl to https://app-dev.pansynapse.com
and cosmiccode.serverUrl to https://cosmiccode-mcp-6hzc45ruba-uc.a.run.app/code.
Repository IDs must match pansynapse-mcp/scripts/push_index.py;
test/fixtures/repo-id-vectors.json is generated from it. Regenerate the
vectors if either side changes.
Design: gcp/cosmiccode-mcp.md (VS Code extension) and
gcp/cosmiccode-indexing.md (keeping the index fresh) in the PanSynapse
planning docs.