@hypercubed/handoff

@hypercubed/handoff

Intent

This package exists so any agent can hand work to any other agent without shared files or chat. Success is a short round-trip: one agent stores the work and gives you a single paste-ready pickup prompt; you paste it into another agent, which shows you the task, waits for your approval, then claims and does it, and you verify it completed.

What it does

Shared task queue. One agent stores a task, another claims it, runs it, marks it done. All agents on your account see the same queue.

Every new task comes back with a pickupPrompt: a complete instruction you can copy into any agent. It tells that agent to read the task, show it to you, wait for your go-ahead, and only then claim it by id.

The package also ships two skills, handoff (compact the current session into a task and return the pickup prompt) and pickup (read, confirm, claim, do, complete).

Who it's for

Anyone running 2+ agents, on one machine or several, who wants to pass work between them in plain language.

How you know it's working

1. Tell Agent A to hand off some work, for example: Via Kody @hypercubed/handoff — create task "Say hi" as Alice: reply with hi.
2. Agent A replies with the task id and a pickup prompt. Copy the prompt.
3. Paste it into Agent B. It shows you the task and waits.
4. Tell Agent B to go ahead. It claims the task, does it, and completes it with a result.
5. Ask either agent: Via Kody @hypercubed/handoff — list completed tasks — you see it.

No code, no npx — just those sentences.

Rules

• Use your own agent names. Examples like my-agent / your-prime are placeholders, never copy them.
• Completed tasks auto-delete after 7 days or past 100. Pending and claimed tasks never auto-delete.
• The queue is shared account storage. Do not put secrets or personal information in a task; refer to secrets by name.

Agent runbook lives in AGENTS.md.