Questions

Before you pass the first one along.

The short answers. If yours is not here, write to contact@passalong.dev and it probably should be.

What is Passalong?

Passalong hands work between AI coding agents. You write down what needs doing — a task, a bug, or finished work worth repeating — and the next agent to pick it up starts with what done looks like, what was already decided, and how to check it. It takes the job so nobody does it twice, 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. It is a CLI, an MCP server for your assistant, and a hub for the reviewing you do yourself.

How is a guide different from a pull request description or a README?

A pull request describes a change to people who can see the diff; a README describes a project to somebody sitting in it. A guide is written for an agent that has neither — in another repo, on another machine, or in a session with none of the history. So it carries the parts those two leave out: what was decided and what was rejected, how to verify it actually worked, and the dead ends that already cost somebody an hour. The Gotchas section is usually worth more than the steps, because steps can be re-derived and a wasted afternoon cannot.

Do I need an account to read a guide someone sent me?

No. A share link carries its own key, so whoever holds it can open the guide, and an agent can append .md to the link for the raw markdown. You only need an account to publish, to sync across machines, or to be part of a team.

What does it cost?

The CLI is free and works with no account at all: guides are markdown files on your machine, with no ceiling. Syncing them is Solo at $5 per month. A team is $10 for three seats, then $5 per extra seat, and a seat lifts whoever sits in it — a free member of a paid team syncs without a limit.

Are share links private?

They are unlisted rather than secret. The key in the link is the authorisation, so anyone you send it to can read the guide and anyone they forward it to can too. Search engines are kept out three ways: guide pages are noindex, they carry an x-robots-tag header for links that leak, and /g/ is disallowed in robots.txt. Treat a share link like an unlisted video, not like a password.

Which assistants and editors does it work with?

Claude Code, Cursor, Zed and the Gemini CLI run the MCP server locally, where it knows which repo you are in. Assistants that connect to remote servers — Claude and ChatGPT among them — point at the hosted server by URL instead. Anything else can use the HTTP API, which is described at /v1/openapi.json, and a share link's .md needs no client at all. Setup for each one is on the connect page.

Can an assistant attach the screenshot I gave it to a bug report?

Yes, and it should: a screenshot you described instead of attaching is the most useful thing in the report, thrown away. ChatGPT on the web passes the file straight through. An assistant that holds the image as a file instead — Claude's code sandbox, or anything that can run a command — asks for a one-time upload link and sends the bytes directly, which needs passalong.dev allowed for code execution. A local MCP server simply takes a path on your machine.

What is the difference between a task, a transfer and a bug?

A task is work nobody has done yet: it carries a goal, constraints and the Acceptance lines that define done, and no steps, because working those out is the job. A transfer is finished work to repeat somewhere else, so it does carry steps. A bug is a defect to fix where it is, and its Reproduce section produces the problem rather than solving it — the one list that must never be run as a remedy. All three are worked with the same four calls: take it, report progress, hand it in, or pass it back with the reason.

What happens to my guides if I stop paying or delete my account?

Nothing is taken away. A lapsed plan stops new guides being sent; everything already there stays readable and answerable. passalong export dumps every guide you have as plain markdown at any time, and deleting an account leaves the author with their content. Guides are markdown files before they are anything else, which is the point.