Still copy-pasting agent outputs to your teammates—and watching them paste everything into their agents? Send the files. Explain the context. Repeat for the next task.
Meet AgentDrop. From your agent to theirs.
Ask your agent to send the result. Your teammate gets notified where they work, then asks their agent to pick it up. The files and explanation arrive together, ready for the next step.
Works with Codex CLI, Claude Code, opencode, Cursor, oh-my-pi and WorkBuddy. Each person keeps their own account and sessions.
See it in action
Wang, in Codex: “Send the ablation results, results.csv and notes.md to @alice.”
Alice, in Claude Code: “Read the ablation results from Wang.”
Built for the handoff
The handoff comes to you
In Codex, get notices when you start a session, submit a prompt or finish a turn. In Claude Code, the AgentDrop mod keeps new messages above your prompt: Read, On it, or Later. You can see who sent what and respond without switching to the dashboard. Optional browser push and Feishu notifications keep you in the loop when your agents are closed.
The mod requires Claude Code 2.1.287 or later; older versions use a status line alongside session and turn notices. See Agent clients for each integration's notification behaviour and requirements.
Direct messages go to accepted contacts or people in a shared group; group messages go to groups you belong to.
Agent uploads stay within folders you allow, and sensitive filenames and paths such as .env and private-key
files are blocked. Received content is treated as untrusted data; receiving a message does not execute it or
download its attachments.
Quick start
You need Node.js 22 or later, a supported coding agent, and an account on an AgentDrop server. If you do not have a server yet, start with Self-hosting.
npm install -g agentdrop-cli
agentdrop setup --server https://drop.example.com
Replace https://drop.example.com with your server's address. setup finds your agents, pairs each one with your
browser approval, installs the integration and checks the result. Each paired agent gets its own credential;
you do not share your agent login with teammates.
Open a new agent session (or reload your client) to load the integration, then try your first message:
Send a test message to @agentdrop.
Every account starts with the @agentdrop assistant, which sends back a receipt. Then ask your agent to add a
teammate as a contact. Once they accept, you can exchange messages and files. To send local files, allow their folder during setup, or
add it later with agentdrop allow-dir add <folder> --profile <profile> (use the profile name shown by setup).
See the user guide for pairing, contacts and your first file transfer.
Self-hosting
For a local trial, with Docker Compose installed:
git clone https://github.com/Interwork-ai/agentdrop.git
cd agentdrop
echo "AUTH_SECRET=$(openssl rand -hex 32)" >> .env
docker compose -f compose.local.yaml up -d --build
Open http://localhost:3000, create an account, then pair your agent:
agentdrop setup --server http://localhost:3000
The local stack builds from source and keeps its data in Docker volumes. For a team server, use compose.yaml
with compose.production.yaml behind HTTPS. Configuration, storage, backups and upgrades are covered in
Deploying; administration and recovery are in Operating a server.
A dashboard when you need one
Browse messages, manage contacts and groups, and pair your agents in the browser. The dashboard supports English and Chinese, with dark and light themes.
How it works
Your machines Your team's server
┌─────────────────────────────────┐ ┌────────────────────────────────┐
│ Codex · Claude Code · opencode │ HTTPS │ API + web dashboard │
│ Cursor · oh-my-pi · WorkBuddy │ ─────────▶ │ PostgreSQL (messages, access) │
│ └─ agentdrop mcp (bridge) │ │ worker (notices, cleanup) │
│ agentdrop CLI │ │ attachments (disk or S3) │
└─────────────────────────────────┘ └────────────────────────────────┘
Pairing creates a persistent mailbox and credential for each agent. Messages stay on the server across sessions. By default, your agents can read mail sent or received by your other agents; read, starred and archived state belong to you. Details are in Architecture and the decision records.
Documentation
Contributing
Bug reports, feature requests, documentation improvements and pull requests are welcome. Start with CONTRIBUTING.md; the development rules are in AGENTS.md.
pnpm install && cp .env.example .env # then set AUTH_SECRET
docker compose up -d postgres
pnpm db:migrate && pnpm dev # API on :3000; pnpm dev:web for the dashboard
pnpm verify # what CI checks
Report security issues privately: SECURITY.md.
License
Apache-2.0 © yitianlian and the AgentDrop contributors