MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Hand tasks from Claude Code, Cursor or Codex to a personal agent through a folder of markdown notes.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 26/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 38/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 43 (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala handoff-desk. Sigue https://mcp.popnx.com/i/voyageurworks-handoff-desk.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server handoff-desk para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "handoff-desk": { "command": "npx", "args": [ "-y", "@voyageurworks/handoff-desk" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de handoff-desk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}Usa handoff-desk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando handoff-desk o muestra una herramienta de handoff-desk en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HANDOFF_DIR Carpeta que contiene el escritorio (las notas en markdown). Por defecto es una carpeta llamada handoff en tu directorio personal. HANDOFF_TELEGRAM_BOT_TOKEN Timbre de Telegram opcional: el token del bot (o use HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND). HANDOFF_TELEGRAM_CHAT_ID Timbre de Telegram opcional: el chat al que escribe el bot. HANDOFF_SLACK_WEBHOOK_URL Aviso opcional de Slack: una URL de webhook entrante (o usar HANDOFF_SLACK_WEBHOOK_COMMAND). HANDOFF_NOTIFY_INCLUDE_REQUEST Establezca 1 para añadir una solicitud abreviada a los mensajes de Telegram y Slack. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar handoff-desk
handoff-desk se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar handoff-desk
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server handoff-desk para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user handoff-desk -- npx -y @voyageurworks/handoff-desk 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de handoff-desk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user handoff-desk -- npx -y @voyageurworks/handoff-deskDeberías ver handoff-desk en la lista como conectado
Usa handoff-desk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando handoff-desk o muestra una herramienta de handoff-desk en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HANDOFF_DIR Carpeta que contiene el escritorio (las notas en markdown). Por defecto es una carpeta llamada handoff en tu directorio personal. HANDOFF_TELEGRAM_BOT_TOKEN Timbre de Telegram opcional: el token del bot (o use HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND). HANDOFF_TELEGRAM_CHAT_ID Timbre de Telegram opcional: el chat al que escribe el bot. HANDOFF_SLACK_WEBHOOK_URL Aviso opcional de Slack: una URL de webhook entrante (o usar HANDOFF_SLACK_WEBHOOK_COMMAND). HANDOFF_NOTIFY_INCLUDE_REQUEST Establezca 1 para añadir una solicitud abreviada a los mensajes de Telegram y Slack. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server handoff-desk para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "handoff-desk": { "command": "npx", "args": [ "-y", "@voyageurworks/handoff-desk" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de handoff-desk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa handoff-desk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando handoff-desk o muestra una herramienta de handoff-desk en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HANDOFF_DIR Carpeta que contiene el escritorio (las notas en markdown). Por defecto es una carpeta llamada handoff en tu directorio personal. HANDOFF_TELEGRAM_BOT_TOKEN Timbre de Telegram opcional: el token del bot (o use HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND). HANDOFF_TELEGRAM_CHAT_ID Timbre de Telegram opcional: el chat al que escribe el bot. HANDOFF_SLACK_WEBHOOK_URL Aviso opcional de Slack: una URL de webhook entrante (o usar HANDOFF_SLACK_WEBHOOK_COMMAND). HANDOFF_NOTIFY_INCLUDE_REQUEST Establezca 1 para añadir una solicitud abreviada a los mensajes de Telegram y Slack. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server handoff-desk para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "handoff-desk": { "type": "stdio", "command": "npx", "args": [ "-y", "@voyageurworks/handoff-desk" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de handoff-desk aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Usa handoff-desk y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando handoff-desk o muestra una herramienta de handoff-desk en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HANDOFF_DIR Carpeta que contiene el escritorio (las notas en markdown). Por defecto es una carpeta llamada handoff en tu directorio personal. HANDOFF_TELEGRAM_BOT_TOKEN Timbre de Telegram opcional: el token del bot (o use HANDOFF_TELEGRAM_BOT_TOKEN_COMMAND). HANDOFF_TELEGRAM_CHAT_ID Timbre de Telegram opcional: el chat al que escribe el bot. HANDOFF_SLACK_WEBHOOK_URL Aviso opcional de Slack: una URL de webhook entrante (o usar HANDOFF_SLACK_WEBHOOK_COMMAND). HANDOFF_NOTIFY_INCLUDE_REQUEST Establezca 1 para añadir una solicitud abreviada a los mensajes de Telegram y Slack. Desactivado por defecto. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user handoff-desk -- npx -y @voyageurworks/handoff-deskClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"handoff-desk": {
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"handoff-desk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@voyageurworks/handoff-desk"
]
}
}
}HANDOFF_DIR envHANDOFF_TELEGRAM_BOT_TOKEN secreto envHANDOFF_TELEGRAM_CHAT_ID envHANDOFF_SLACK_WEBHOOK_URL secreto envHANDOFF_NOTIFY_INCLUDE_REQUEST envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub voyageurworks, dueña del repo
Último cambio de código: hace 4 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para @voyageurworks/handoff-desk@1.2.4
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/voyageurworks-handoff-desk)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 4 días, y la última versión (1.2.4) llegó al registro hace 9 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este handoff-desk | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | No | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Hand tasks from your coding session to a personal agent, and read the answer back.
handoff-desk is a small MCP server that runs on your computer. When you tell Claude Code, Cursor, Codex or another MCP client to "hand this to my agent", it writes a markdown note into a folder you own, optionally emails the agent a heads-up, and later reads the agent's reply from the same note.
New here? One command asks who sends the notes and who answers them (an agent on this computer, OpenClaw or a cloud agent), creates the desk and prints every step with your folder filled in:
npx -y @voyageurworks/handoff-desk setup
Or paste a ready-made prompt into an AI assistant that can run commands and let it do the steps. For just a demo desk:
npx -y @voyageurworks/handoff-desk init ~/handoff-demo
That creates a demo desk. The five-minute walkthrough below (add it to Claude Code, answer with a stand-in agent) needs nothing else installed but Node.js 22 or newer.
You, in Claude Code: "Hand this to my agent: book the dentist for Friday at 3."
handoff-desk writes: Desk/2026-11-02 Item 01 - Book dentist.md (status: waiting) Your agent (any): reads the note, does the task, writes "## Reply", sets status: done You, same chat: "What did my agent say?" -> the reply, read back from that note
Not to be confused with the "handoffs" inside an agent framework (one agent passing a conversation to another inside a single run). This is asynchronous and between separate programs: your coding assistant writes a note, a different agent (on your PC, in the cloud, or a person) answers when it can, and the note stays on disk as the record.
Status: 1.0. The tools and the note format are stable. Agent coverage is narrow: it is tested on every change with the bundled stand-in agent, and was tried with one real cloud agent over git and email (five rounds on 2026-10-26, all passed). Other agents are untested. See Compatibility.
sequenceDiagram
participant You as You + MCP client participant HD as handoff-desk (on your computer) participant Desk as Desk folder / private git repo participant Agent as Your agent You->>HD: handoff_send("book the dentist") HD->>Desk: write Desk/2026-10-29 Item 01 - dentist.md (status: waiting) HD-->>Agent: optional doorbell email Agent->>Desk: read note, do the task, write "## Reply", status: done You->>HD: handoff_wait / handoff_read HD->>Desk: read (and pull, with git) HD-->>You: the agent's reply
More detail, including the folder layout and the git flow, is in docs/architecture.md.
You need Node.js 22 or newer (this includes npm) and git. pnpm works too.
1. Create a demo desk. init creates Desk/, Inbox/, mail/ and a handoff.md template. Running it again never overwrites your edits. Nothing to install first; npx fetches the package from npm:
npx -y @voyageurworks/handoff-desk init ~/handoff-demo
2. Add the server to Claude Code (other clients: docs/clients.md). On macOS and Linux:
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" -- npx -y @voyageurworks/handoff-desk
On Windows PowerShell, run npx through cmd /c and write the double dash in quotes (PowerShell 5.1 drops a bare --, and claude then reports missing required argument 'commandOrUrl'):
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" '--' cmd /c npx -y '@voyageurworks/handoff-desk'
3. Start the stand-in agent in a second terminal and leave it running. It answers every waiting item with a fixed line. In macOS or Linux shells:
HANDOFF_DIR="$HOME/handoff-demo" npx -y @voyageurworks/handoff-desk stand-in
In Windows PowerShell:
$env:HANDOFF_DIR = "$HOME/handoff-demo"
npx -y @voyageurworks/handoff-desk stand-in
4. Try it. Start a new Claude Code session (servers load at startup) and say: "Hand this to my agent as a question using the handoff-demo tools: reply with pong." Claude calls handoff_send, then handoff_wait, and shows the stand-in's reply. Open ~/handoff-demo/Desk/ to see the note flip from status: waiting to status: done.
5. Clean up. Stop the stand-in (Ctrl+C) and run claude mcp remove handoff-demo. Delete ~/handoff-demo if you like.
init prints these commands again with your real folder filled in, and npx -y @voyageurworks/handoff-desk --help lists every command. Something not working? Run npx -y @voyageurworks/handoff-desk doctor, then see docs/troubleshooting.md.
Building from source instead (contributors)
The same server, run from a clone of this repository. In the quick-start steps above, use node /absolute/path/to/handoff-desk/dist/main.js wherever they say npx -y @voyageurworks/handoff-desk.
1. Install and build (macOS, Linux and Windows):
git clone https://github.com/voyageurworks/handoff-desk.git
cd handoff-desk npm install npm run build
With pnpm: pnpm install && pnpm build.
Releases are published to npm from GitHub Actions with a provenance statement; npm install -g @voyageurworks/handoff-desk also installs a handoff-desk command.
2. Create a demo desk. init creates Desk/, Inbox/, mail/ and a handoff.md template. Running it again never overwrites your edits.
node dist/main.js init ~/handoff-demo
3. Add the server to Claude Code (other clients: docs/clients.md). Use the absolute path to dist/main.js (on Windows with forward slashes, for example C:/Users/you/handoff-desk/dist/main.js):
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" -- node /absolute/path/to/handoff-desk/dist/main.js
In Windows PowerShell 5.1, write the double dash in quotes. PowerShell drops a bare --, and claude then reports missing required argument 'commandOrUrl':
claude mcp add handoff-demo -e HANDOFF_DIR="$HOME/handoff-demo" '--' node C:/absolute/path/to/handoff-desk/dist/main.js
4. Start the stand-in agent in a second terminal and leave it running. It answers every waiting item with a fixed line. In macOS or Linux shells:
cd handoff-desk
HANDOFF_DIR="$HOME/handoff-demo" node dist/main.js stand-in
In Windows PowerShell:
cd handoff-desk
$env:HANDOFF_DIR = "$HOME/handoff-demo" node dist/main.js stand-in
handoff-desk is built for these three. In each, the assistant uses the same tools, writes the same kind of note, and your agent reads it the same way. The note's from: line says which client sent it (claude-code, cursor or codex).
| Claude Code | Cursor | Codex (CLI and IDE) | |
|---|---|---|---|
| Set up | claude mcp add | install --client cursor, or mcp.json | codex mcp add, or config.toml |
| What has been run | The real client connected to the server (Windows 11) | The config is launched by a test and the install command is tested on a copy of Cursor's settings file; the Cursor app itself has not been run | The real client started the server, called handoff_send, a note was created, answered and read back (a scripted stand-in model, Windows 11) |
| Good to know | Codex asks before calling handoff_send; approve it, or pre-approve it in config.toml (docs/clients.md) |
Any client that can run a stdio MCP server works. You give it a command, its arguments and the environment variable HANDOFF_DIR.
| Client | Guide |
|---|---|
| Claude Code | claude mcp add (above) |
| Cursor | mcp.json, see docs/clients.md |
| VS Code (Copilot agent mode) | .vscode/mcp.json, see docs/clients.md |
| Codex (CLI and IDE) | codex mcp add or config.toml, see docs/clients.md |
| Claude Desktop | claude_desktop_config.json, see docs/clients.md |
| Gemini CLI, OpenCode, Kilo Code, Amp, Continue, Goose, Junie CLI, Windsurf, LM Studio, Cline, Roo Code, Amazon Q | handoff-desk config --client or install, see docs/clients.md |
Fastest: npx -y @voyageurworks/handoff-desk install --client cursor shows what it would add to Cursor's settings (add --write to do it; Gemini CLI, LM Studio and Amp work the same way). npx -y @voyageurworks/handoff-desk doctor checks your setup and says what to fix.
Not supported yet: Kiro, Warp, the JetBrains IDEs (the Junie CLI above was run) and Zed. config --client still prints a block for each from the client's own documentation, but none has been run, so expect to adjust it (docs/clients.md).
Pick the line that matches where your agent runs.
Desk/ directly. Nothing else to set up.HANDOFF_SYNC=auto) when the folder is a git work tree with an upstream branch. Details, the exact note format and the rules to give the agent: docs/cloud-agents.md.handoff_pending and handoff_answer, and an optional wake call tells it a note is waiting. Setup, and what the wake call does and never sends: docs/openclaw.md.Whichever you pick, give the agent the rules in your handoff.md and tell it to write its answer under ## Reply and set status: done. A ready-made instruction file for the agent, usable as a Claude Code skill or pasted into any other agent's instructions, is in docs/agent-contract.md.
| Agent |