arkaigrowth

Chromium Profile Migrator — Development skill for Claude Code

Development community

Inspect, compare, and safely migrate Chromium-family browser profile configuration: extensions, shortcuts, allowlisted settings.

How to install Chromium Profile Migrator

This entry records only its repository, not the path inside it, so there is no exact command to give. Open arkaigrowth/chromium-profile-migrator and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Chromium Profile Migrator does

Inspect, compare, and safely migrate Chromium-family browser profile configuration: extensions, shortcuts, allowlisted settings. Dry-run by default, hash-verified backup and rollback, agent-ready JSON.

Alternatives in Development

  • Backup 14.5k ★
  • Agent Skills Platform — Build tested agent skills and govern their lifecycle through a user-defined marketplace: evidence, discovery 2.4k ★
  • Agent Skill Creator — Build tested agent skills and govern their lifecycle through a user-defined marketplace: evidence, discovery 2.3k ★

README

Chromium Profile Migrator

`cpmigrate` is a local CLI for inspecting, comparing, and safely migrating selected configuration between Chromium-family browser profiles.

It is Brave-first because Brave profile migration exposed the problem, but its normalized readers also understand Chrome, Chromium, Edge, and Vivaldi profile layouts. Version 0.1 writes only to Brave targets on macOS; the other products and platforms are read-only.

What it solves

  • Find profiles by their human names instead of guessing whether they are Profile 1 or Profile 5.
  • See which extensions are installed, enabled, disabled, pinned, or missing.
  • Compare extension keyboard shortcuts, detect extension conflicts, and detect stored Brave browser-shortcut conflicts.
  • Compare a small, documented allowlist of portable browser settings.
  • Build a one-time migration plan without joining a continuous sync chain.
  • Apply supported Brave shortcut and setting changes only after a dry-run.
  • Back up every changed Preferences file and support guarded rollback.
  • Emit stable JSON for Codex, Claude Code, shell scripts, and tests.

What it deliberately does not do

`cpmigrate` never edits `Secure Preferences`, recomputes protected-preference MACs, copies wallet data, migrates passwords/cookies/sessions, or claims that copying an extension folder installs an extension safely.

Chromium blocks silent extension installation for good security reasons. Missing extensions are returned as `manual_install` items with Chrome Web Store URLs. Install them in the target, approve their permissions, then rerun the shortcut migration.

For bookmarks, history, and tabs, use a tool designed for browsing data, such as [`browser-migrate`](https://github.com/navotvolkgroundup/browser-migrate). This project focuses on the configuration layer that tool does not cover.

Quick start

Install from a checkout with [`uv`](https://docs.astral.sh/uv/):

uv tool install .
cpmigrate --help

To pick up a ne