whatisgithub

What is browser-migrate?

navotvolkgroundup/browser-migrate — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A macOS CLI and MCP server that migrates bookmarks, history, and tabs between browsers like Chrome, Firefox, and Safari.

Mindmap

mindmap
  root((browser-migrate))
    What it does
      Exports browser profiles
      Migrates bookmarks and history
      Lists extensions to reinstall
    Tech stack
      TypeScript
      Bun
      MCP
    Use cases
      Switch to a new default browser
      Move bookmarks across machines
      Drive migration from Claude via MCP
    Audience
      macOS power users
      Developers who test many browsers
    Safety
      Backs up before writing
      Dry run supported

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Move your bookmarks and history when switching from one browser to another on the same Mac.

USE CASE 2

Export a portable bundle of your browser data to carry over to a new machine.

USE CASE 3

List your installed extensions and open their store pages in a new browser to reinstall them.

USE CASE 4

Let an AI assistant run the migration for you through the included MCP server.

What is it built with?

TypeScriptBunMCP

How does it compare?

navotvolkgroundup/browser-migrate0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Safari reads require granting Full Disk Access to your terminal, only macOS is supported so far.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

browser-migrate is a macOS command line tool that moves your bookmarks, browsing history, and open tabs from one web browser to another, so switching browsers does not mean losing everything you had saved in the old one. It currently supports Chrome, Dia, Brave, Edge, and Arc, which all share a similar underlying format, along with Firefox, Zen, and Safari, which each use a different format internally. There are two ways to move your data. The safe, universal path exports your browser profile into a portable bundle of files, including a standard bookmarks.html file that any browser can import through its own built in import feature. The more direct path writes bookmarks straight into another Chromium based browser's profile. Every direct write first checks that the destination browser is not currently running, backs up its existing profile so the change can be undone, and produces files with the checksums that Chromium based browsers expect so they will actually accept the change. Passwords are never included in an exported bundle, since properly moving them would require breaking into each browser's encrypted password storage. Browser extensions cannot be copied directly, since they are installed programs tied to your account rather than plain data, so instead the tool lists your installed extensions and can open their store pages in the new browser so you can reinstall them with a click. The same actions are also available as an MCP server, meaning an AI assistant like Claude can call these same import, export, and migrate operations directly instead of you typing commands yourself, with the same safety checks and a dry run option. Internally, the project reads each browser's data into one shared neutral format through a separate adapter file per browser, then exports from that shared format, so supporting a new browser only requires writing one new adapter rather than a separate conversion for every possible pair of browsers. The tool currently only supports macOS, is built with TypeScript and the Bun runtime, and is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me export my Chrome profile with browser-migrate and import it into Firefox.
Prompt 2
Explain the difference between browser-migrate's portable export and its direct write mode.
Prompt 3
Show me how to register browser-migrate as an MCP server for Claude Code.
Prompt 4
Walk me through undoing a browser-migrate write using the restore command.

Frequently asked questions

What is browser-migrate?

A macOS CLI and MCP server that migrates bookmarks, history, and tabs between browsers like Chrome, Firefox, and Safari.

What language is browser-migrate written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, MCP.

What license does browser-migrate use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is browser-migrate to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is browser-migrate for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.