git404hub

what is passation- fr?

spendinfr/passation- — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 1/5LicenseSetup · easy

tl;dr

A script that snapshots an interrupted Claude Code or Codex CLI session into one file so the other assistant can pick up the work where it left off.

vibe map

mindmap
  root((repo))
    What it does
      Handoff snapshot
      Reads Git and session state
      Passive one-shot script
    Tech stack
      Python
      Git
      Claude Code
      Codex CLI
    Use cases
      Recover from crashed session
      Switch between coding agents
      Preserve progress across quota limits
    Audience
      Developers
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Hand off an interrupted Claude Code session to Codex CLI, or the reverse, without losing context.

VIBE 2

Recover a summary of recent progress after a coding agent crashes or hits a quota limit.

VIBE 3

Generate a passationlive.md snapshot from a Git repository's history and uncommitted changes.

VIBE 4

Review recent commits, modified files, and the last unanswered instruction from an interrupted session.

what's the stack?

PythonGit

how it stacks up fr

spendinfr/passation-0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity1/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

No packages to install beyond Python 3.10+ and Git, just download the single script file.

Use, modify, and redistribute freely, including commercially, as long as you keep the copyright notice.

in plain english

Passation is a small script that helps you switch between two AI coding assistants, Claude Code and Codex CLI, without losing your place. If one of them stops working partway through a task, because it hit a usage limit, crashed, had its terminal closed, or was interrupted in some other way, you run this script inside the same Git repository, and it writes a single file called passationlive.md that the other assistant can read before picking up the work. The script does not install any hooks, does not change Claude or Codex's configuration, and does not run in the background, it runs once and exits. It works by reading local session files and Git state passively, treating your Git history as the most reliable record of what actually got done. From that, it pulls together things like the four most recent complete prompt and response exchanges, several earlier progress milestones from the session, how long the session ran, counts of prompts and tool actions, a list of currently modified or untracked files, a summary of uncommitted changes, and details from your most recent commits. If there was a clear next step mentioned in the interrupted session, it tries to include that too. To use it, you need Python 3.10 or newer, Git, and either Claude Code or Codex CLI using their normal local session storage, no extra packages need installing. After downloading the single script file, you run it with a path to your repository, and it creates the passationlive.md file. You can then open the other agent in the same repository and branch and ask it to read that file, check the current Git status and diff, and continue the interrupted work without redoing what is already done. The tool is meant to be used in one direction at a time, not with both agents running against the same working tree simultaneously. There are limits to what it can recover: it cannot see text that was never saved to disk, hidden reasoning the model didn't write down, or intentions that were never captured anywhere. Since the output file can include excerpts from prompts, commands, and local source files, it is worth reviewing before sharing or committing it. The script makes no network requests. It is released under the MIT license.

prompts (copy fr)

prompt 1
Show me how to download and run handoff_snapshot.py against my current repository.
prompt 2
Explain what information passationlive.md captures from an interrupted coding session.
prompt 3
Walk me through handing off from Claude Code to Codex CLI using this script.
prompt 4
Help me exclude passationlive.md from Git tracking using .git/info/exclude.

Frequently asked questions

what is passation- fr?

A script that snapshots an interrupted Claude Code or Codex CLI session into one file so the other assistant can pick up the work where it left off.

What language is passation- written in?

Mainly Python. The stack also includes Python, Git.

What license does passation- use?

Use, modify, and redistribute freely, including commercially, as long as you keep the copyright notice.

How hard is passation- to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is passation- for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.