Skip to content

Installation

KoNiMa Claude Sync is an extension for Visual Studio Code. Installation takes only a few minutes; right after, you move on to the first launch and setup to activate your license and connect your repository.

Prerequisites

Before you begin, make sure you have:

  • Visual Studio Code 1.90 or later, on Windows, macOS, or Linux. The extension is fully native: no WSL, no extra runtime.
  • Git available on your PATH.
  • Node.js 20 or later, needed only if you intend to sync memories (access to the memory database goes through Node).
  • Claude Code installed: it’s exactly what we’re going to sync.
  • A private, empty git repository you control — GitHub, GitLab, Gitea, Azure DevOps, or any remote reachable over HTTPS — with a personal access token (PAT) that has read and write permissions. You connect it on first launch.
  • A valid license for KoNiMa Claude Sync. There’s no free version, but you can start a self-service trial of any edition right from the extension.

Install the extension

You can install the extension from a store or from a file:

  • From the marketplace: search for KoNiMa Claude Sync in the VS Code Marketplace or on Open VSX and click Install.
  • From VSIX: open the Extensions view, choose Install from VSIX… from the … menu, and select the konima-claude-sync-<version>.vsix file. From a terminal this is equivalent to code --install-extension konima-claude-sync-<version>.vsix.

The KoNiMa Claude Sync extension page in the VS Code store, with the install button and the details panel (identifier, version, categories) The extension page in the VS Code store: from here you click Install.

Once done, the extension activates when VS Code starts and, on first run, opens the setup dashboard on its own (a behavior you can adjust with the Open on startup checkbox). Subsequent updates are detected and installed by the extension itself: you don’t have to manually redistribute the VSIX to your whole team.

Next step

With the extension installed, continue with the first launch and setup — license activation, connecting your repository, and the first sync.

Uninstalling

To remove the product completely:

  1. Remove license (System tab or dedicated command) — deactivates the license on this machine.
  2. Remove local data — frees up the seat and deletes local clones, backups, credentials, and the license. Your ~/.claude folder is not touched.
  3. Uninstall the extension from the VS Code Extensions view.