Description
Ferry is an open-source tool designed to manage Claude Code chat histories across multiple accounts on a single machine. Users often face the issue of losing access to their chat history when switching accounts, but Ferry addresses this by listing every Claude Code account on the machine, including those not currently signed in. It allows users to move, copy, and back up chats, ensuring that no conversation is lost due to account changes or the 30-day cleanup process.
The tool operates by accessing chat metadata stored per account and transcripts shared across accounts, making the transfer of chats quick and efficient. Users can download conversations in various formats, such as Markdown, plain text, or JSON, and restore deleted chats as long as the transcripts are available. Ferry does not require network access, ensuring privacy by reading and writing local files only.
Ferry is available for free under the MIT license and supports both macOS and Windows platforms. It is not affiliated with Anthropic, the creator of Claude Code, but provides a valuable service for users needing to manage their chat histories across different accounts. The tool also includes a command-line interface for automated backups, making it a versatile solution for maintaining chat records.
Ferry's Core Features
Move Claude Code chats between accounts
Copy Claude Code chats
Back up Claude Code chats
Archive chats to prevent 30-day cleanup loss
List all Claude Code accounts on a machine
Restore deleted chats
Download chats in Markdown, plain text, or JSON
No network code; local file operations only
How to use Ferry?
Configure: Set up Ferry on your machine
Use: Move or copy chats between accounts
Back up: Archive chats to prevent loss
Restore: Recover deleted chats from archive
Ferry's Use Cases
- Account switching
- Chat backup
- Chat restoration
- Offline operation
- Multi-format export
