Skip to content

georgelubaretsi/piebird-sessions

v0.1.0MIT

Read coding agents' session journals (omp, Claude Code, Codex): a session_read tool that reads, pages and searches a session by id and line, with asks shown in full, and the agent told its own session id

GitHubOpen Website

piebird-sessions

Let your agent read past sessions: omp's, Claude Code's and Codex's. What did we decide yesterday, what exactly did I say, what did the agent answer: the session_read tool finds it in the session's journal, by session id and line, without the agent opening a file whose lines run to tens of thousands of characters.

omp, Claude Code and Codex each find what an earlier session decided

Install

omp:

omp plugin marketplace add georgelubaretsi/piebird
omp plugin install piebird-sessions@piebird

Claude Code:

claude plugin marketplace add georgelubaretsi/piebird
claude plugin install piebird-sessions@piebird

Codex, ChatGPT and Claude on a Mac or a Windows PC: the piebird installer (Install), which puts the plugin's program in place with it.

What it adds

  • session_read: this project's sessions, newest first, with each one's title and first prompt; one entry and what it relates to (the message a reply answers, a question with its options and what you picked or typed); pages of messages around a line; a search; only your own words; or the raw lines. Each answer ends with the next call to make. It reads every agent's journals, whichever agent asks.
  • A line telling the agent its own session id and journal, so it can cite where you said something: in omp, in the chat before the agent's first turn and after a fork or compaction; in Claude Code, in the conversation's context.

It reads; it never changes a journal. Journals of hundreds of megabytes are read as they stream, never held whole.

What the model sees: the tool's description, its answers and errors, and the session line, word for word, in each agent.