Arc → Zen Migration
shub-rajput/arc-to-zen-migration
Migre seus espaços Arc para Zen automaticamente, preservando estrutura
Ver no GitHubSkill Claude Code que migra automaticamente seus espaços do navegador Arc para o Zen, preservando a estrutura de pastas, abas fixadas e favoritos globais. Lê os arquivos de configuração do Arc e reconstrói tudo no Zen sem necessidade de cópia manual.
Instalação
npx convez-ai shub-rajput/arc-to-zen-migration1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Migrar espaços de navegação do Arc para Zen com um comando
- Preservar hierarquia de pastas e abas fixadas entre navegadores
- Transferir favoritos globais do Arc como essenciais do Zen
Veredito

Ferramenta prática e bem executada para quem quer migrar entre esses navegadores. Lida com a lacuna de importação/exportação entre Arc e Zen de forma elegante, rodando como skill ou script standalone com bom controle sobre o processo.
README
A tradução para o português deste README ainda está na fila.
Arc → Zen Migration
A Claude Code skill that migrates your Arc browser spaces into Zen Browser, automatically, straight from the files. No manual copy-pasting of tabs.
Arc has no Zen exporter and Zen has no Arc importer, but both store everything in inspectable files. This skill reads Arc's sidebar and rebuilds your spaces inside Zen: folders stay folders (nesting preserved), pins stay pins, and Arc's global Favorites become Zen global essentials.
The scripts/ are plain Python and also run standalone. Installed as a Claude Code skill, you just ask in natural language ("migrate my Arc spaces to Zen") and Claude drives the whole flow.
Install as a Claude Code skill
Drop the folder into your skills directory and the skill becomes available by name:
git clone https://github.com/shub-rajput/arc-to-zen-migration.git \
~/.claude/skills/arc-to-zen-migration
Then in Claude Code, just say: "migrate my Arc browser spaces into Zen". The arc-to-zen-migration skill activates and handles extraction, workspace creation, and import. (New to skills? See the Claude Code skills docs.)
Prefer to run it yourself? Skip to Usage; the scripts work without Claude Code.
What it migrates
| Arc | → | Zen |
|---|---|---|
| Space | → | Workspace (auto-created, with the same emoji icon) |
| Folder / nested folder | → | Folder / nested folder |
| Space top-level tab | → | Pinned tab |
Global Favorites (topApps) | → | Global essentials |
Not handled (use the browser's own tools): bookmarks (Arc → export HTML → Zen import), passwords (a password manager or keychain export), history, extensions.
Requirements
- macOS, Linux, or Windows with Arc and Zen installed (and run at least once)
- Python 3.8+
- liblz4, because Zen's session file is
mozLz4-compressed:- macOS:
brew install lz4 - Debian/Ubuntu:
sudo apt install liblz4-1 - Windows: ship a
liblz4DLL and add its path to_LZ4_CANDIDATESinzen_session.py
- macOS:
Usage
Always quit Zen first (Cmd/Ctrl+Q). Zen rewrites its session on exit and will clobber changes made while it's running. Every run auto-creates a .bak next to the session file.
cd scripts
# Preview what's there
python3 migrate.py --list
# Migrate EVERYTHING from zero (creates all workspaces + favorites)
python3 migrate.py --all --favorites
# Or one space at a time (creates the workspace if missing)
python3 migrate.py "Home" --favorites
python3 migrate.py "Work" --zen "Job" # map to a differently-named Zen workspace
python3 migrate.py "Home" --essentials 4 # promote first 4 top pins to essentials
Runs are idempotent: re-running clears that workspace's content first, so iterate freely.
Global favorites need one setting
Arc Favorites are the same in every space. Zen's essentials are per-workspace by default. To get Arc-style global favorites, set this once (Zen quit):
# in <profile>/user.js
user_pref("zen.workspaces.separate-essentials", false);
Without it, --favorites essentials only appear in the default/first workspace.
No Arc on this machine?
Use scripts/migrate_example.py: fill in ESSENTIALS / PINS / FOLDERS by hand (Arc sidebar screenshots are enough) and run it.
How it works
- Arc keeps everything in
~/Library/Application Support/Arc/StorableSidebar.json(plain JSON): a flatitems[]of nodes linked byparentID/childrenIds, where each node is atab(withsavedURL) or alist(folder).arc_extract.pywalks it into per-space trees. - Zen keeps its state in
<profile>/zen-sessions.jsonlz4(mozLz4JSON) withspaces[],tabs[],folders[],groups[].zen_session.pyreads/writes it and provides builders. A folder is two synced records (folders[]+groups[]) sharing oneid; member tabs carrygroupId+zenWorkspace.
See SKILL.md for the full schema notes and the essentials-scoping gotcha.
Inspecting / debugging
python3 scripts/zen_session.py --dump # dump live Zen folders/groups/tabs
python3 scripts/arc_extract.py # pretty-print Arc spaces
python3 scripts/arc_extract.py --json # Arc trees as JSON
If Zen changes its schema in a future release, create one folder with two tabs by hand in Zen, quit, --dump, and compare the shapes against the builders in zen_session.py.
Safety
- Quit Zen before running.
- Each run writes a
.bak(and you can pass custom suffixes via the library). Restore by copying the.bakback overzen-sessions.jsonlz4. arc://*URLs are skipped (they don't resolve in Zen).
License
MIT. See LICENSE.