evgolsh/handoff

Hand your work to someone else's AI assistant, with your notes and the original files.
Joe sorts out the car insurance renewal in Claude. Anna says "continue the handoff from joe" in ChatGPT and gets his notes and the two PDFs. You can hand off to your partner, a teammate, or yourself in another assistant or on another computer.
Your notes and the files. The brief says what you decided and what is left to do. PDFs and images go with it, byte for byte. Open a handoff in Assets to read the brief and see the files.
You see that it arrived. Assets shows when Anna picked it up and in which assistant, and your assistant can tell you the same.
Their own assistant. Anna can use ChatGPT while Joe uses Claude. Codex, Claude Code and Hermes work too. Each person signs in with their own username.
Storage, not AI. Handoff keeps the brief and files and deletes them when they expire. It makes no model calls and needs no API keys.
Free at handoff.infraworks.net, or open source on your own Cloudflare account for a small team that wants its files on its own infrastructure. MIT licensed. Watch the 29-second demo.
## Get started
1. Add Handoff to your assistant. The server address is https://handoff.infraworks.net/mcp. In Claude, this link opens the custom connector form with it filled in. For ChatGPT, Codex, Claude Code and Hermes, see Assistant setup.
2. Create a team. On the Handoff sign-in page that opens, choose Create a team and pick your username, and a team name if you like (without one, the team is named after you). You are its admin. Save the access code it shows once: your username and access code sign you in on any computer and in any assistant.
3. Invite your partner. Ask your assistant "invite anna to Handoff" and send her the link it gives you. She opens it, gets her own access code and connects her assistant.
4. Hand off. "Hand this off to anna with the two PDFs." She says "Continue the handoff from joe."
The hosted service is free: up to 10 people per team, files up to 25 MiB, handoffs deleted after 7 days by default (30 at most). See Privacy. Assistants can read the whole setup at llms.txt.
## Your own private server
Install it once for your whole team. It runs on Workers, D1 and KV in your Cloudflare account, on the free plan with no card. Teammates only sign in, and a new assistant, computer or teammate needs no new install. Your briefs and files stay on your account, and handoffs are kept 30 days by default.
There are three ways to install. Each one creates the same private server.
### From your browser
You need a Cloudflare account and a GitHub or GitLab account. Cloudflare copies the code there, creates the database and file store, and deploys your server.
Set HANDOFF_SETUP_CODE to a code of 12 or more characters. After the deploy, open /console/setup on your new server and enter it with your username. See Deploy button details.
### Ask a coding assistant
Claude Code, Codex, Gemini CLI, Hermes or any assistant that can run commands on your computer. Give it this request with your own usernames:
> Deploy https://github.com/evgolsh/handoff to my Cloudflare account. Follow llms-install.md. My username is tim; add tom as a teammate. Ask me to approve the Cloudflare login, then help me connect my assistants.