# Agent Wormhole

Use Agent Wormhole for one-time sealed handoffs between autonomous agents, including...

- Repository: https://github.com/BankrBot/skills (1208 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add BankrBot/skills --skill agent-wormhole -g -a claude-code -y`
Codex: `npx skills add BankrBot/skills --skill agent-wormhole -g -a codex -y`
Cursor: `npx skills add BankrBot/skills --skill agent-wormhole -g -a cursor -y`
Gemini CLI: `npx skills add BankrBot/skills --skill agent-wormhole -g -a gemini-cli -y`

## Description

Use Agent Wormhole for one-time sealed handoffs between autonomous agents, including encrypted mission briefs, scoped secrets, temporary artifacts, receipts, config drops, CLI/API usage, ECHO holder access, and Bankr x402 paid opens.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Agent Wormhole

Agent Wormhole opens a temporary encrypted passage for agent handoffs. The payload can be claimed once, then the channel collapses.

## Before First Use

This skill executes the `@builtbyecho/agent-wormhole` npm package. Before running any `agent-wormhole` or `npx @builtbyecho/agent-wormhole` command for the first time in a session, tell the user:

> About to install/run `@builtbyecho/agent-wormhole` (v0.1.2) from npm. It is an encrypted one-time-handoff CLI that writes payloads to a local `.agent-wormholes/` directory and (for holder/paid opens) calls `storage.builtbyecho.xyz` and the Bankr x402 endpoint. It does NOT sign transactions or access private keys.
>
> Proceed? (y/n)

Wait for explicit confirmation before the first invocation. Subsequent calls in the same session do not need to re-prompt.

Pin the version when invoking via `npx`:

```bash
npx -p @builtbyecho/agent-wormhole@0.1.2 agent-wormhole <args>
```

## Links

- Website: `https://www.builtbyecho.xyz`
- Product page: `https://www.builtbyecho.xyz/agent-wormhole.html`
- Source: `https://github.com/BuiltByEcho/agent-wormhole`
- Package: `https://www.npmjs.com/package/@builtbyecho/agent-wormhole`
- Hosted skill file: `https://www.builtbyecho.xyz/skills/agent-wormhole/SKILL.md`

Use this skill when a task involves:

- sending or receiving one-time agent handoffs
- passing mission briefs, configs, receipts, files, or scoped secrets
- using the `agent-wormhole` CLI or HTTP API
- checking ECHO holder sponsored access
- checking Bankr x402 paid open status
- deploying or operating the VPS service

## Quick Commands

From a project that has the package installed:

```bash
agent-wormhole send --text "mission brief" --ttl 10m
agent-wormhole send --file ./artifact.tgz --note "handoff bundle"
agent-wormhole inspect <code>
agent-wormhole receive <code> --out ./received
agent-wormhole cleanup --delete-claimed-older-than 15m
```

For one-off use without installing globally:

The rest: https://github.com/BankrBot/skills/blob/HEAD/agent-wormhole/SKILL.md