hub / github.com/amirkabiri/chvm

github.com/amirkabiri/chvm @v1.2.1

Chat with this repo

repository ↗ · DeepWiki ↗ · release v1.2.1 ↗ · + Follow

137 symbols 461 edges 52 files 2 documented · 1% ● updated 4mo agov1.2.1 · 2026-02-13★ 38

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

chvm — Chromium Version Manager

A lightweight CLI tool for managing multiple Chromium versions on MacOS (ARM/Apple Silicon) and Windows.

⚠️ Development Status

chvm is currently unstable. We recommend using it via npx to automatically get bug fixes:

alias chvm="npx -y chvm"

Add this alias to your ~/.zshrc or ~/.bashrc to make it permanent.

Requirements

Node.js >= 20.0.0

Quick Start

# Update available versions list
chvm update # will take a few minutes

# List versions
chvm ls

# Install and open a version
chvm open latest

# Install specific version
chvm install 92.0.4515.159

# Open with CORS disabled (for development)
chvm open 92 --disable-cors

# Uninstall a version
chvm uninstall 92.0.4515.159

Features

✅ Install and manage multiple Chromium versions
✅ Separate profiles per version
✅ Everything stored in ~/.chvm (no system pollution)
✅ CORS disable support for development

Commands

Command	Description
`chvm update [--force]`	Update list of available versions
`chvm ls [--json]`	List available and installed versions
`chvm install <version>`	Install a version (version number, revision, or latest/oldest)
`chvm open <version> [--disable-cors]`	Open a version (auto-installs if needed)
`chvm uninstall <version> [--force]`	Uninstall a version

License

MIT

Made with ❤️ for developers

Extension points exported contracts — how you extend this code

UninstallCommandOptions (Interface)

(no doc)

src/commands/uninstall.ts

ExtractProgress (Interface)

src/manifest/shared/types.ts

RunCLIOptions (Interface)

(no doc)

tests/helpers/test-utils.ts

UpdateCommandOptions (Interface)

(no doc)

src/commands/update.ts

AvailableVersion (Interface)

src/manifest/shared/types.ts

CLIErrorResult (Interface)

(no doc)

tests/helpers/test-utils.ts

Core symbols most depended-on inside this repo

acquireLock

called by 21

src/lib/lock.ts

readInstalledVersions

readAvailableVersions

Shape

Function 105

Interface 32

Languages

TypeScript100%

Modules by API surface

tests/helpers/test-utils.ts22 symbols

tests/helpers/test-utils.js17 symbols

src/lib/storage.ts12 symbols

src/lib/mapping.ts12 symbols

src/lib/installer.ts10 symbols

src/lib/downloader.ts10 symbols

src/lib/logger.ts8 symbols

src/lib/platform-check.ts5 symbols

src/lib/lock.ts5 symbols

src/commands/update.ts4 symbols

src/commands/uninstall.ts3 symbols

src/commands/open.ts3 symbols

For agents

$ claude mcp add chvm \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact