passalong

passalong

AI コーディングエージェントに作業を引き継ぎ、実施内容と確認方法を受け取りましょう。

タスク、バグ、完了した変更を一度だけ記述します。引き受けたエージェントは、何をもって完了とするか、すでに決まっていることを把握した状態で作業を開始し、進捗を報告しながら進めます。そして、依頼した各項目の証拠を添えた報告書を引き渡し、あなたが承認するか、差し戻します。1 つの仕事につきエージェントは 1 つで、誰が何を担当しているかは全員が確認できます。Claude Code、Codex、ChatGPT、Claude、または MCP や HTTP に対応するものであれば何でも利用できます。passalong.dev をご覧ください。

npm i -g passalong
passalong setup      # installs the Claude Code capture skill + registers the MCP server
passalong login      # optional: sync guides across machines and get share links
codex mcp add passalong -- passalong mcp   # Codex: the same MCP server

一連の流れ

1. Claude Code（または任意のエージェント）で作業を完了します。「pass this along」と伝えるか、/passalong-capture を実行するか、自分で passalong share を実行します。
2. 整えて公開します。下書きがエディターで開きます。保存すると、短い ID とリンクが発行されます。
3. 引き継ぎ先で取得します。対象のリポジトリで passalong pull <id> を実行するか、Passalong MCP サーバーを使う任意のエージェントにリンクを貼り付けます。ガイドがコンテキストに取り込まれ、ASSUMES: と記された部分を調整しながら実装されます。
4. 完了します。引き継ぎ先に反映されたら passalong done <id> を実行します。繰り返し取得される場合は passalong promote <id> を実行します。

コマンド

passalong share [file] [--to team[/handle]]  publish a guide → id + link, Ready; --to addresses it
passalong pull <id|link>      print a guide; --save also writes ./.passalong/<id>.md (git-ignored)
passalong inbox               guides handed to you that you have not pulled yet
passalong board               waiting on you, in flight, landed, worth keeping
passalong activity [--all]    what happened while you were away; clears unless --all
passalong list [query]        your guides and your teams'
passalong open <id> [--print] view a guide in the browser (or the terminal)
passalong hub                 open your synced guides in the browser
passalong archive <id>        off your board and out of the free tier's count (was `done`)
passalong promote <id>        deprecated: mark promoted
passalong rm <id>             delete a guide locally and from sync
passalong export [dir]        dump every guide as plain markdown
passalong login               sign in from the browser
passalong login --with-token  read a token from stdin instead (CI, scripts)
passalong login --new         add another account to this machine
passalong accounts            the accounts signed in here, and which is the default
passalong use <name>          make one of them the default
passalong logout [name]       forget one of them (default: the current one)
passalong me [--handle H] [--name N] [--email E]   who you are to teammates
passalong team                current team and its members
passalong team create <name>  start a team (you become its owner)
passalong team invite [email] make an invite link (mailed when an email is given)
passalong team join <link>    accept an invite
passalong team use <slug>     switch the current team
passalong setup               install the Claude Code capture skill + register the MCP server
passalong mcp                 run the MCP server over stdio
passalong version             print the installed version (also -v, --version)

チーム

チームは共有の単位です。メンバーはチームに共有されたすべてのガイドを見つけて取得し、消化済みとしてマークできます。ガイドは 1 人に引き継ぐこともでき、その人の受信トレイに表示されます（サーバーでメールが設定されている場合はメールでも通知されます）。

passalong me --handle lukman            # how teammates address you
passalong team create Khaime            # you become owner; "khaime" is now current
passalong team invite [email protected]   # or no email: prints a link to send yourself
passalong team join <link>              # on Ada's machine — or she just opens the link
passalong share --to khaime/ada         # hand this guide to Ada
passalong inbox                         # on Ada's side: what was handed to you
passalong activity                      # back on your side: it landed, and who pulled it

種類にかかわらず、すべてのガイドは同じ流れで進みます。共有されると Ready になり（または、誰かが passalong ready <id> を実行するまで status: draft の下書きになります）、引き受けた人が passalong take <id> を実行して担当し、証拠を添えて提出します。その後、担当者が承認するか、理由を添えて差し戻します（passalong approve / passalong reject）。

ハブでメールアドレスとパスワードを使ってサインインし、CLI と MCP サーバー用の API トークンを発行します。トークンには名前を付けられ、取り消し可能で、発行時に一度だけ表示されます。パスワードがターミナルに渡ることはありません。引数なしの passalong login でもアカウントを作成できますが、サインインや復旧ができるようにするには、後からメールアドレスとパスワードを追加してください。

ガイドを受け取った人全員が実装するとは限りません。すべてのガイドページには Verify ビュー（?view=verify）があり、Problem、Verification、Gotchas を先頭に表示し、実装部分は折りたたみます。作業するのではなく、テストや確認を行う人向けです。招待はブラウザーで承認できるため、チームに参加するのにターミナルは必要ありません。

passalong activity は引き継ぎのもう半分です。引き継いだガイドを誰かが取得したとき、消化済みとしてマークしたとき、招待が承諾されたときに通知します。個人宛ての引き継ぎはメールでも通知されますが、チーム全体への共有では送信されません。宛先が指定されていないメールは、真っ先にフィルターされるからです。繰り返し取得されるガイドには、チームが継続的に管理する少数のリファレンスに昇格するよう通知が届きます。

MCP

passalong setup を実行すると、Claude Code にサーバーが登録されます。ほかのクライアントでは、passalong mcp を stdio 経由で実行してください。

ツール：search_guides、inbox、get_guide、publish_guide（to を指定）、guide_template、set_guide_status。

ガイドはプレーンな Markdown です

フロントマター付きのプレーンな Markdown としてサーバーに保存されるため、マシン上にファイルがたまることはありません。ファイルが必要なときは、passalong pull <id> --save を実行するか、すべてのガイドを取得する passalong export を実行します。

セルフホスト型サーバーを利用するには、passalong login の前に PASSALONG_API=https://your-host を設定します。

複数のアカウント

1 台のマシンで、仕事用と個人用など、複数のアカウントにサインインできます。 passalong login --new で最初のアカウントにもう 1 つ追加でき、passalong accounts で一覧を表示できます。passalong use <name> で、ターミナルを使う人のデフォルトを選択します。

エージェントには質問を受け付けるターミナルがないため、アカウントが 2 つ以上あり、どれを使うか指定されていない場合は処理を拒否し、確認するよう促します。エージェントが平易な言葉で質問し、あなたが答えると、エージェントはその名前で use_account を呼び出します。この設定はセッション中のみ有効で、ディスク上のファイルは変更されません。シェルからは、--as <name> または PASSALONG_ACCOUNT=<name> を指定すると、1 つのコマンドに対して同じようにアカウントを指定できます。所属するチーム（passalong team use）はマシンではなく、アカウントに属します。