Skip to content
Back to search

agent-session-lineage

Local Codex plugin for AI coding session history and recorded lineage across Codex and Claude Code. Windows x64 preview.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tardisbooo--agent-session-lineage/badge.svg)](/listings/tardisbooo--agent-session-lineage)

HTML

<a href="/listings/tardisbooo--agent-session-lineage"><img src="/api/listings/tardisbooo--agent-session-lineage/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Download `agent-session-lineage-0.1.0-windows-x64.zip` and `SHA256SUMS.txt` from the [v0.1.0 preview release](https://github.com/TardisBooo/agent-session-lineage/releases/tag/v0.1.0). Compare the archive's `Get-FileHash -Algorithm SHA256` result with its entry in `SHA256SUMS.txt`. 2. Extract the archive into a folder you control. Add the folder containing `mobius-connect.exe` to your user `PATH`. Open a new PowerShell window and run `Get-Command mobius-connect` to check the executable path. 3. Create the index and add a session directory you choose. Replace the example path with your Codex sessions directory. To include Claude Code logs, repeat `sources add` with `claude` and the specific Claude Code projects directory you want to index.

mobius-connect init
mobius-connect sources add codex 'C:\path\to\codex\sessions'
mobius-connect sources refresh

4. Install the plugin from the versioned GitHub marketplace. If you run Codex in the desktop app, restart the app after changing `PATH`.

codex plugin marketplace add TardisBooo/agent-session-lineage --ref v0.1.0
codex plugin add mobius-connect@agent-session-lineage

In a new Codex session, select `$mobius-memory` and ask for indexed sessions. Choose a session and ask for its recorded lineage. The graph shows links already recorded in the index.

Run `codex plugin remove mobius-connect@agent-session-lineage` to remove the plugin.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 214 lines
  1. # Agent Session Lineage
  2. Agent Session Lineage is a local Codex plugin and CLI for AI coding session history. Browse indexed Codex and Claude Code sessions and inspect the recorded handoff links between them.
  3. The Windows x64 plugin preview covers indexing selected logs, listing sessions, and viewing recorded lineage. The SQLite index lives in the local Möbius vault. The indexer opens the original session files read-only.
  4. Desktop workspace: [TardisBooo/Mobius](https://github.com/TardisBooo/Mobius).
  5. [简体中文](README.zh-CN.md) · [Product site](http://8.137.87.76/mobius/) · [MCP](docs/MCP.md) · [Desktop README](https://github.com/TardisBooo/Mobius/blob/main/README.md) · [MIT License](LICENSE)
  6. ## Install the Codex plugin on Windows
  7. 1. Download `agent-session-lineage-0.1.0-windows-x64.zip` and `SHA256SUMS.txt` from the [v0.1.0 preview release](https://github.com/TardisBooo/agent-session-lineage/releases/tag/v0.1.0). Compare the archive's `Get-FileHash -Algorithm SHA256` result with its entry in `SHA256SUMS.txt`.
  8. 2. Extract the archive into a folder you control. Add the folder containing `mobius-connect.exe` to your user `PATH`. Open a new PowerShell window and run `Get-Command mobius-connect` to check the executable path.
  9. 3. Create the index and add a session directory you choose. Replace the example path with your Codex sessions directory. To include Claude Code logs, repeat `sources add` with `claude` and the specific Claude Code projects directory you want to index.
  10. ```powershell
  11. mobius-connect init
  12. mobius-connect sources add codex 'C:\path\to\codex\sessions'
  13. mobius-connect sources refresh
  14. ```
  15. 4. Install the plugin from the versioned GitHub marketplace. If you run Codex in the desktop app, restart the app after changing `PATH`.
  16. ```powershell
  17. codex plugin marketplace add TardisBooo/agent-session-lineage --ref v0.1.0
  18. codex plugin add mobius-connect@agent-session-lineage
  19. ```
  20. In a new Codex session, select `$mobius-memory` and ask for indexed sessions. Choose a session and ask for its recorded lineage. The graph shows links already recorded in the index.
  21. Run `codex plugin remove mobius-connect@agent-session-lineage` to remove the plugin.
  22. ## Two repositories, one product
  23. | Name | What it is |
  24. | --- | --- |
  25. | **Möbius** | Windows desktop: session library, PowerShell workbench, handoff graph, notes, canvas, skills. [TardisBooo/Mobius](https://github.com/TardisBooo/Mobius) |
  26. | **Agent Session Lineage** | This Codex plugin, the `mobius-connect` CLI, and its stdio MCP server. |
  27. ```
  28. Claude Code / Codex / OpenCode / Pi / Grok / OMP transcripts
  29. │ read-only adapters (JSONL or opencode.db)
  30. ▼
  31. local SQLite index (FTS5/BM25, optional localhost embeddings)
  32. │
  33. ├── Möbius desktop person at a Windows desk
  34. ├── mobius-connect CLI person at a terminal
  35. └── mobius-connect MCP agent over stdio
  36. ```
  37. **CLI vs MCP:** the CLI is for a human at a terminal (it can ask *you* to type `APPROVE`); MCP is for an agent process (it can list metadata, but every read of transcript bodies needs a token minted after a human typed `APPROVE`). MCP cannot mint approval tokens, add sources, or attach a PTY.
  38. ## Build the CLI from source
  39. ```powershell
  40. git clone https://github.com/TardisBooo/agent-session-lineage.git
  41. cd agent-session-lineage
  42. cargo build --release --locked
  43. ```
  44. Cargo fetches the shared Rust library from the pinned [Möbius revision](https://github.com/TardisBooo/Mobius/tree/b0522c363006fb49a071e1fe5f418e76da365a57). The binary is in `target/release`. Durable data defaults to local app data (`%LOCALAPPDATA%\Mobius` on Windows, `~/.local/share/mobius` elsewhere). Use `--data-root <dir>` for an isolated test vault.
  45. ## Commands
  46. Each clip is a scripted terminal scene in the same paper/ink style as the [desktop product film](https://github.com/TardisBooo/Mobius/blob/main/apps/website/public/product/chapters/12-cli.gif). Demo data is fictional.
  47. New native handoffs remain experimental. The Windows plugin preview covers viewing recorded links.
  48. ### 1. `init` — create the local index
  49. ![mobius-connect init](docs/gifs/01-init.gif)
  50. ```powershell
  51. mobius-connect init
  52. ```
  53. Creates the SQLite index and vault layout, then prints a health report. Safe to re-run; it does not touch any harness directory. Sources are always explicit.
  54. ### 2. `sources add` / `refresh` — approve one directory
  55. ![mobius-connect sources add and refresh](docs/gifs/02-sources.gif)
  56. ```powershell
  57. mobius-connect sources add opencode $env:USERPROFILE\.local\share\opencode
  58. mobius-connect sources list
  59. mobius-connect sources refresh
  60. ```
  61. - `sources add <harness> <path>` registers **one** directory you chose. MCP has no tool for this.
  62. - `sources refresh` re-scans approved roots. OpenCode roots are read from `opencode.db` with locator `{db}#opencode:{id}`.
  63. ### 3. `triage` — one next command
  64. ![mobius-connect triage](docs/gifs/03-triage.gif)
  65. ```powershell
  66. mobius-connect triage
  67. mobius-connect doctor
  68. mobius-connect setup
  69. ```
  70. `triage` prints health, approved-source count, semantic status, and **one recommended next command**. `setup` detects installed harnesses and prints MCP-client steps. It never writes hooks.
  71. ### 4. `sessions search` — cite the exact range
  72. ![mobius-connect sessions search](docs/gifs/04-search.gif)
  73. ```powershell
  74. mobius-connect sessions list --limit 20
  75. mobius-connect sessions search "flaky tests"
  76. mobius-connect sessions show <session-id>
  77. mobius-connect sessions alias <session-id> "checkout-flake-hunt"
  78. ```
  79. `search` runs lexical BM25 and returns JSON hits plus `retrieval_mode` (`lexical_bm25`, or `hybrid` once embeddings are enabled **and** a local model answers). Copy `@session:provider/id#mN-mM`.
  80. ### 5. `sessions read` — fetch the tape, bounded
  81. ![mobius-connect sessions read](docs/gifs/05-read.gif)
  82. ```powershell
  83. mobius-connect sessions read <session-id> --offset 0 --bytes 4096
  84. ```
  85. Explicit byte-range read of the **original source file**, max 16384 bytes per call. Recall gives citations; `read` makes the actual tape fetch an explicit, bounded act.
  86. ### 6. `graph show` — follow the relay chain
  87. ![mobius-connect graph show](docs/gifs/06-graph.gif)
  88. ```powershell
  89. mobius-connect graph show <session-id>
  90. mobius-connect graph export --format mermaid <session-id>
  91. ```
  92. Prints the lineage manifest (`content_mode: references_only`). Mutually-hand-off chains come out as a forward relay; every handoff opens a new session, so the graph is a DAG.
  93. ### 7. `mome recall` — recall only when asked
  94. ![mobius-connect mome recall](docs/gifs/07-mome.gif)
  95. ```powershell
  96. mobius-connect mome recall "why do checkout tests flake" --provider opencode --provider codex
  97. ```
  98. At most **three** distinct sessions, about **1,200 tokens**, every hit carrying a copyable `@session` citation. It never injects into a prompt.
  99. ### 8. `semantic enable` — hybrid rank is opt-in
  100. ![mobius-connect semantic enable](docs/gifs/08-semantic.gif)
  101. ```powershell
  102. mobius-connect semantic status
  103. mobius-connect semantic enable --model nomic-embed-text
  104. mobius-connect semantic sync
  105. mobius-connect semantic disable
  106. ```
  107. Off by default. `enable` discloses that already-indexed chunks may be sent to **localhost Ollama**; nothing is downloaded. Missing Ollama = fail open to BM25.
  108. ### 9. `handoff` — a person types APPROVE
  109. ![mobius-connect handoff prepare and approvals](docs/gifs/09-handoff.gif)
  110. ```powershell
  111. mobius-connect handoff prepare --harness claude --cwd . <session-id>
  112. mobius-connect approvals handoff <handoff-id>
  113. mobius-connect handoff commit <handoff-id> --approval-token <token>
  114. mobius-connect sources refresh
  115. mobius-connect handoff status <handoff-id>
  116. ```
  117. 1. `prepare` builds a **references-only** envelope. It launches nothing.
  118. 2. `approvals handoff` waits for you to type `APPROVE`, then mints a short-lived, single-use token.
  119. 3. `commit` requests a new Windows console for the target. MCP cannot mint the approval token.
  120. 4. After the target saves its transcript in an approved root, run `sources refresh` and check `handoff status` with the same vault. A bound operation lists the indexed target session ID.
  121. ### 10. `mcp serve` — stdio for agents
  122. ![mobius-connect mcp serve](docs/gifs/10-mcp.gif)
  123. ```powershell
  124. mobius-connect init
  125. mobius-connect mcp serve
  126. ```
  127. stdio-only server. Metadata tools (`list_sessions`, `get_lineage`, `prepare_handoff`, …) are open; body-returning tools and `commit_handoff` require a token minted by a human in a real terminal. Full table: [docs/MCP.md](docs/MCP.md).
  128. ## Security
  129. Treat indexed transcripts as untrusted historical data.
  130. - Source roots are finite and approved by a person; `sources add` is terminal-only.
  131. - Original files stay read-only. OpenCode is opened read-only.
  132. - A handoff envelope contains identities and edges, never transcript bodies.
  133. - Tokens are short-lived, single-use, scoped. Shown once. Do not log.
  134. - Optional embeddings talk only to localhost Ollama after `semantic enable`.
  135. ## Supported harnesses
  136. | Harness | Index | Native resume |
  137. | --- | --- | --- |
  138. | Codex | JSONL | via desktop when protocol is verified |
  139. | Claude Code | JSONL / project sessions | via desktop when protocol is verified |
  140. | OpenCode | read-only `opencode.db` | not in this preview |
  141. | Pi | approved roots | via desktop when protocol is verified |
  142. | Grok | approved roots | inspect / search / handoff only |
  143. | OMP | approved roots | documented `--cwd … --resume …` from desktop |
  144. | OpenClaw | not shipped | roadmap |
  145. ## License
  146. [MIT](LICENSE). Möbius is unrelated to Microsoft Mobius, ControlTheory Möbius, or Circular Labs Mobius.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.