Migration

Coming from Claude Code? Migrate your setup in seconds.

One Command

If you're coming from Claude Code, a single command imports your entire setup:

bash

franklin migrate

Franklin scans your Claude Code configuration directory and imports everything it finds. The process takes a few seconds.

What Gets Imported

The migration command brings over all of your existing Claude Code configuration:

MCP server configs— all your connected MCP servers and their settings
Session history— past conversations and context
Project memories— learned preferences and project-specific knowledge
CLAUDE.md preferences— your custom instructions and rules

Non-destructive

Migration copies your configs — it never modifies or deletes your original Claude Code setup. You can continue using both tools side by side.

Auto-Detection

On first run, Franklin automatically detects if you have Claude Code installed. If it finds an existing setup, it offers to migrate:

text

$ franklin
Detected Claude Code installation at ~/.claude/
Import your existing config? [Y/n]

Press Y (or just Enter) to migrate immediately, or n to skip and start fresh.

Manual Import

If you prefer to import specific configs manually, you can copy files directly from the Claude Code config directory:

bash

# Copy MCP server configs
cp ~/.claude/mcp-servers.json ~/.franklin/mcp-servers.json

# Copy project memories
cp ~/.claude/memories.json ~/.franklin/memories.json

# Copy custom instructions
cp ~/.claude/CLAUDE.md ~/.franklin/FRANKLIN.md

Selective migration

Manual import is useful when you only want to bring over specific parts of your setup, or when you want to review and edit configs before Franklin uses them.