Give coding agents durable tasks that survive a disconnected session.
Passeur is a local delegation service for Codex and Muse workers. Sessions in the same repository share a coordinator, bounded queue and task history; implementation work runs in protected Git worktrees. One unpinned Codex registration follows each new session's repository, so opening another project needs no registration change.
Accepted work stays alive until it finishes, fails or is explicitly cancelled. Disconnecting a client does not cancel its tasks.
Use Node.js 20 or later and the complete repository with its pinned lockfile. Authorize dependency provisioning and its install scripts before running npm ci:
git clone https://github.com/MrScripty/Passeur.git
cd Passeur
npm ci
npm run check
npm test
npm run build:runtimeDependency installation includes native components and install scripts. Runtime builds require clean Git inputs and already provisioned dependencies; they do not install packages.
The build produces an identified runtime candidate. Follow installation and setup to install that exact candidate, configure agents once and register passeur with Codex. Start a fresh Codex session after registration.
Current status: the structural-coordination completion plan records acceptance of its exact source and installed build; the claim ledger owns the evidence and limits. The supported service environment is Linux on local filesystems with a matching native bundle. Complete installed acceptance before relying on a new installation; see compatibility for environment constraints.
- Check
passeur_statusandpasseur_agents; usepasseur_prepareto prepare the repository without inference. - Submit with
passeur_submitorpasseur_submit_batchand keep the durable receipt. - Observe with
passeur_tasksandpasseur_wait. - Answer an exact pending permission or clarification with
passeur_input, or explicitly stop work withpasseur_cancel. - Retrieve evidence with
passeur_result, then account for retained or externally integrated work withpasseur_finalize.
The caller chooses the task, worker, base and acceptance criteria. Passeur does not decide whether output is correct or automatically merge it.