Skip to content

Repository files navigation

ccdrop

Super easy way to copy a Claude Code chat between computers: upload it to a small RAM-only server, get a 4-digit PIN, then run npx ccdrop <PIN> on the other machine. The session is auto-deleted from the server the instant it lands.

npx ccdrop

Share: pick a session, get a 4-digit PIN, then npx ccdrop <PIN> on the other computer to import.

No accounts. No login. No setup.

How it works

  1. Share: run npx ccdrop on the computer with the chat, pick the session, get a 4-digit PIN.
  2. Import: run npx ccdrop <PIN> on the other computer. The session lands in ~/.claude/projects/ and is registered with the Claude desktop app, where it appears after a restart.

The chat is retargeted at the current directory on the way in, so a session shared from another machine - or another operating system - resumes cleanly. The sender's cloud-sync records are stripped.

Privacy

The session is uploaded to a small relay server so the second computer can fetch it.

  • RAM only: sessions live in an in-memory store (no database, no disk, no backups).
  • Auto-deleted on download: the payload is wiped from memory the instant the receiver grabs it.
  • 15-minute expiry: even if nobody downloads it, the PIN self-destructs after 15 minutes.
  • No accounts, no logs: there is no way to associate a PIN with a person.

Commands

Command Description
npx ccdrop Select a chat session and get a 4-digit PIN
npx ccdrop <code> Download and import a chat using the PIN

Self-hosting

By default npx ccdrop uses the public relay. Run your own to keep every byte on a machine you control.

Run the relay locally

npx ccdrop server                  # relay on http://localhost:3000
npx ccdrop server -p 8080          # custom port

The relay stores everything in RAM and wipes each session the moment it is downloaded.

Point the client at your relay

npx ccdrop -s http://localhost:3000               # share to your local relay
npx ccdrop -s http://localhost:3000 4829          # import from your local relay

Replace localhost with your server's LAN IP, hostname, or public URL as needed.

Deploy to Vercel

npm run deploy     # uses `vercel --prod`

Then point clients at your deployment:

npx ccdrop -s https://your-app.vercel.app

Links

License

MIT

About

Lightning-fast CLI to share and transfer Claude Code chat sessions between computers via 4-digit PIN code. RAM-only relay, auto-deletes on download, no accounts, no logs, privacy-first. npx ccdrop.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages