書留 kakitome — Registered mail for AI agents

なぜ、いま書留か Why registered mail, why now

agent（エージェント）は、指示を受けてコードやタスクを自動でこなす AI のことです。Claude Code や Codex、Gemini がその代表。一人ひとりの手元では大活躍なのに、チームの依頼はいまも人から人へ——Slack や issue で頼まれて、受け取った人が自分の agent に文脈を貼り直して説明して、ようやく動き出します。agent 同士は、まだつながっていない。
Agents are great solo — but between teammates, work still travels human-to-human, re-pasted and re-explained.

いまのやり方 — WITHOUT KAKITOME

誰かの依頼a request

→

Slack / issue で人に届くlands in your inbox

→

agent に貼り直して説明you re-explain to your agent

→

ようやく動くfinally runs

文脈はコピペのたびに削れ、「誰が・いつ引き受けたか」は流れていく。
Context erodes in every paste; who took it on, when — nobody keeps track.

書留 — WITH KAKITOME

依頼の送り状an envelope

→

相手の agent 宛に直接届くstraight to their agent

→

本人が受領印they stamp it

→

文脈ごと動き出すruns with full context

貼り直しも説明し直しも不要。押すまで動かない安心と、受領の記録つき。
No re-pasting. Nothing runs before the stamp, and every acceptance is on record.

agent 同士が、直通

宛先は「人の受信箱」ではなく「相手の agent」。受領後は export で文脈ごと引き渡せて、依頼 → 受領 → 完了（reply）が 1 本の線でつながります。
Send work agent-to-agent, hand over full context, get the result back as a reply.

引き受けが、形になる

受領印（accept）で「誰が・いつ引き受けたか」が残ります。押すまで動かないから、頼む側も受ける側も安心。
Every acceptance is stamped, dated, and on record — nothing runs before it.

だから、安心して開ける

本文はデータであって命令ではなく、secret の塊は送信時の検査が止め、差出人は GitHub の実アカウントで確認。直通の線を、安全側に倒したまま開けます。
Bodies are data, secrets are linted out, identity is verified — a direct line you can leave open.

仕組み How it works

01 — send

送り状を送る

CLI から相手の agent 宛に依頼を送付。kind（handoff / review_request / question）と本文が封入され、折り鶴の配達員が運びます。

02 — claim

本人が受領印を押す

受取人にはリンクが届くだけ。「あなた宛の書留が届いています」。受領係のとめ丸が片目のまま、あなたの印を待ちます。

03 — run

それから、動く

受領印が押された瞬間、とめ丸に両目が入り、相手の agent が文脈ごと実行を開始。依頼から完了までが 1 本の記録として残ります。

received

seen

留

accepted

done

試してみる Try it

STEP 0 · 10秒

まずこのページの封筒デモで受領印を押してみる。それが体験のすべての原型です。
Try the stamp demo above — that's the whole idea.

github.com/zen-jp/kakitome ↗

必要なもの — WHAT YOU NEED

GitHub アカウント / a GitHub account
ターミナル / a terminal
bun（STEP 1 の1行目でインストール） / bun, one line
STEP 2 まで Claude Code などの agent は不要 / no AI agent needed until step 3

STEP 1 · 2分 — 初期セットアップ(1回だけ)

bun を入れて kakitome を取得し、GitHub で本人確認してログイン。scope は read:user のみで、GitHub の token は保存されません。
One-time setup: install bun, clone, sign in with GitHub.

terminal — setup

# bun が無ければ(1行・macOS / Linux / WSL)
$ curl -fsSL https://bun.sh/install | bash

# kakitome を取得してログイン(GitHub で本人確認するだけ)
$ git clone https://github.com/zen-jp/kakitome && cd kakitome && bun install
$ bun packages/cli/src/cli.ts login --api https://kakitome.zenplace.dev

STEP 2 · 30秒 — 自分宛てに本物を送る

相手がいなくても大丈夫。自分の GitHub アカウント宛てに送ると、送る側と受け取る側を1人で体験できます。
No partner needed — send one to yourself.

terminal — send

# --to は自分の GitHub login でも OK(@ 付きでも可)
$ bun packages/cli/src/cli.ts send --to <github-login> --kind handoff \
    --subject "kakitome を試す" --body "自分宛てのテスト便" \
    --provenance <issue や PR の URL> --yes
送信しました: 019f2e0a-…
◉ 受領印待ち — 相手が accept するまで agent は動きません

STEP 3 · 1分 — 受領して、agent に引き継ぐ

内容を確認して受領印を押したら、export で文脈ごと自分の agent（Claude Code / Codex など）へ。作業が終わったら reply --outcome done で完了が差出人に返り、一往復が記録として残ります。
Stamp it, export the context to your agent, reply when done.

terminal — accept & handoff

# 中身を確認して、受領印を押す
$ bun packages/cli/src/cli.ts read 019f2e0a
$ bun packages/cli/src/cli.ts accept 019f2e0a --yes

# 文脈ごと Markdown に書き出して、自分の agent に渡す
$ bun packages/cli/src/cli.ts export 019f2e0a --out handoff.md
$ claude "handoff.md を読んで、書かれた依頼の範囲だけ作業して"

よくある質問 FAQ

agent を使ったことがなくても試せる？

はい。必要なのはターミナルと GitHub アカウントだけです。agent は「受け取った後に働く側」なので、送る・受け取る体験に agent は要りません。

Yes — you only need a terminal and a GitHub account. The agent is what runs after acceptance, not what you need to try this.

書留（kakitome）ってどういう意味？

受取人のサインがないと配達が完了しない日本の郵便のことです。サインするまで何も始まらない、がこのプロダクトの動作そのものなので、名前にしました。

Kakitome is Japanese registered mail: delivery completes only when the recipient signs. That is exactly how this product behaves.

Slack や issue で頼むのと、何が違う？

宛先が「人の受信箱」ではなく「相手の agent」であること。受領印の瞬間に文脈ごと（export で）引き継がれ、依頼 → 受領 → 完了が 1 本の記録として残ります。貼り直しも「あれどうなった？」の追いかけも要りません。

The address is their agent, not their inbox. Context transfers whole at the stamp, and request → acceptance → outcome stays on one record.

相手がまだ kakitome を使っていなくても送れる？

送れます。相手には claim ページのリンクが届き、GitHub でログインして受領します。中身は本人がログインするまで封のまま（メタ情報だけ）です。

Yes — they get a claim link and sign in with GitHub to accept. Contents stay sealed until it's really them.

agent 同士をつないで、勝手に動いたりしない？

しません。本文は「データ」であって命令ではなく、受領印を押すまで相手の agent は read-only。secret や個人情報の塊は送信時の検査（lint）が止めます。直通の便利さは、この安心の上に載っています。

No. Bodies are data, not commands; agents stay read-only until the stamp, and secrets are linted out at send time.

とめ丸って誰？

受領係のだるまです。だるまは願いが叶うと目を入れる縁起物。kakitome では、あなたが受領印を押した瞬間に両目が入ります。claim ページで会えます。

Tomemaru, the receiving officer. A daruma doll gets its eye painted when a wish comes true — here, when you stamp. One eye waits; your stamp opens the other.