Passalong

io.github.codellysonv0.13.1Updated Oct 3, 2026

Hand tasks, bugs and finished work to AI coding agents, and get back a write-up with evidence.

VerifiedStreamable HTTPWeb executableDeveloper ToolsKnowledge & MemoryProductivity & Workflow

Overview

AI-generated overview

Lets an assistant publish, search, and pull structured handoff guides so coding agents can pick up tasks and report evidence.

What it does
Passalong turns a task, bug, or finished change into a markdown guide with frontmatter, stored locally and optionally synced. Through MCP tools such as search_guides, inbox, get_guide, publish_guide, guide_template, and set_guide_status, an assistant can find guides, pull one into context, publish a new one, or change its status. Receivers can mark work as verified with a screenshot or report it broken with a reason, and the author sees the result on a board.
When to use it
Use it when work is handed between people and AI coding agents and you want each agent to start with the same definition of done and prior decisions. It suits teams that need a shared board of waiting, in-flight, and landed work, or that want a reviewable write-up with evidence rather than an unstructured prompt.
Requirements
Runs as a remote endpoint at passalong.dev or as a local npm package (passalong) over stdio; Node.js is needed for the local install. No account is required for local-only use; signing in with an email and password, or an API token minted at the hub, adds sync and share links. A self-hosted server can be set with the PASSALONG_API environment variable.
Before you install
Guides are shared with teammates and, when addressed to a person, also emailed, so anything published may leave your machine. Sign-in uses an email and password, and an API token for the CLI and MCP servers is named, revocable, and shown once; treat it as a secret. Commands such as rm, archive, and set_guide_status change or delete guides locally and in sync, and verification screenshots are kept until five days after a guide is closed.

Installation

In SourceWeft

  1. Open Passalong in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "passalong": {
      "type": "http",
      "url": "https://passalong.dev/v1/mcp"
    }
  }
}

README

passalong

Hand work to your AI coding agents, and get back what they did and how they checked it.

Write a task, a bug or a finished change once. The agent that takes it starts knowing what done looks like and what was already decided, reports as it goes, and hands back a write-up with the evidence for each thing you asked for, which you approve or send back. One agent per job, and everyone can see who has what. Works with Claude Code, Codex, ChatGPT, Claude, or anything that speaks MCP or HTTP. See passalong.dev.

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

The loop

  1. Finish work in Claude Code (or any agent). Say "pass this along", run /passalong-capture, or run passalong share yourself.
  2. Trim and publish. The draft opens in your editor. Save it and you get a short id and a link.
  3. Pull on the other side. passalong pull <id> in the target repo, or paste the link to any agent with the Passalong MCP server. The guide lands in its context; it implements, adapting the parts marked ASSUMES:.
  4. Close. passalong done <id> when it landed. passalong promote <id> if it keeps getting pulled.

Commands

passalong share [file] [--to team[/handle]]  publish a guide → id + link; --to hands it to a team or teammatepassalong pull <id|link>      fetch a guide into ./.passalong/ (git-ignored) and print itpassalong inbox               guides handed to you that you have not pulled yetpassalong board               waiting on you, in flight, landed, worth keepingpassalong activity [--all]    what happened while you were away; clears unless --allpassalong list [query]        your guides and your teams', local and syncedpassalong open <id> [--print] view a guide in the browser (or the terminal)passalong hub                 open your synced guides in the browserpassalong works <id> <shot>   you tried it and it holds up, with a screenshot of it workingpassalong broken <id> <why>   you tried it and it does not — the author is told, with your reasonpassalong archive <id>        off your board and out of the free tier's count (was `done`)passalong promote <id>        deprecated: mark promotedpassalong rm <id>             delete a guide locally and from syncpassalong export [dir]        dump every guide as plain markdownpassalong login [token]       sign in with your email and password, or attach this machine with a tokenpassalong me [--handle H] [--name N] [--email E]   who you are to teammatespassalong team                current team and its memberspassalong 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 invitepassalong team use <slug>     switch the current teampassalong setup               install the Claude Code capture skill + register the MCP serverpassalong mcp                 run the MCP server over stdiopassalong version             print the installed version (also -v, --version)

Teams

A team is the unit of sharing. Members can find, pull, and mark consumed every guide shared to the team; a guide can also be handed to one person, who sees it in their inbox (and by email when the server has mail configured).

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

A receiver who tries the work reports back with passalong works <id> <screenshot.png> or passalong broken <id> <why>. That is separate from done, which means implemented: a verdict means it actually runs. A passing one has to show it — at least one screenshot of it working, kept until 5 days after the guide is closed — a failing one has to say why, and the author sees it on their board and in their inbox.

Sign in at the hub with an email and password, and mint an API token there for the CLI and MCP servers — named, revocable, and shown once. Your password never goes near the terminal. passalong login with no arguments still makes an account without any of that; add an email and password later to be able to sign in from a browser and recover it.

Not everyone who receives a guide implements it. Every guide page has a Verify view (?view=verify) that leads with Problem, Verification and Gotchas and folds the implementation away — for a tester or anyone checking the work rather than doing it. Invites are accepted in the browser, so a teammate needs no terminal to be part of a team.

passalong activity is the other half of the transfer: it tells you when someone pulled a guide you handed over, when they marked it consumed, and when an invite was taken up. A handoff addressed to a person is also emailed; a team-wide share is not, because mail nobody is named in is the first thing people filter out. Guides that keep getting pulled get a nudge to promote them into the team's small set of maintained references.

MCP

passalong setup registers the server with Claude Code. For other clients, run passalong mcp over stdio.

Tools: search_guides, inbox, get_guide, publish_guide (with to), guide_template, set_guide_status.

Guides are files

Plain markdown with frontmatter in ~/.passalong/guides. Yours to edit, grep, and commit. passalong export dumps everything. Works with no account; passalong login adds sync and share links.

Point at a self-hosted server with PASSALONG_API=https://your-host before passalong login.

Source: packages/passalong/README.md at commit 32f5907

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.13.1LatestOct 3, 2026