Zubin Pather - generate zethis-style Path Packs from agent session logs
Project description
zather
zather/ generates Path Packs: zethis-style procedural docs that teach a coding agent how to recreate the context-building pathway from an excellent Claude Code / Codex CLI session.
Unlike compaction systems that try to reproduce the final patch, zather compacts the path: the ordered set of reads/searches/commands and intermediate “what we learned” checkpoints that got the agent to a useful semantic state.
Install (editable)
From this repo root:
uv pip install -e zather/
Quick start
Generate a Path Pack from a Codex CLI session file:
zather build --source codex --session-file ~/.codex/sessions/.../rollout-...jsonl --out path-pack.md
Generate from a Claude Code session:
zather build --source claude --project . --session <session-id> --out path-pack.md
Inspect the rendered prompts without calling the LLM:
zather build --source codex --session-file ~/.codex/sessions/...jsonl --out /tmp/zather_dry.md --dry-run
Prompting
zather uses a YAML prompt template (default: zather/zather/prompts/path_pack.yaml) to turn a parsed trajectory into a Path Pack markdown document.
Note: some OpenAI models reject temperature; zather will automatically retry without it.
Override with:
zather build ... --prompt zather/zather/prompts/path_pack.yaml --model gpt-5-mini
LLM backend
By default, zather prefers WBAL when installed (fallback to direct OpenAI client). Override with:
zather build ... --backend wbal
zather build ... --backend openai
Checkpoints
To target a “checkpoint” inside a longer session, use timestamp filters:
zather build ... --since 2026-01-07T20:04:00Z --until 2026-01-07T20:10:00Z
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zather-0.2.0.tar.gz.
File metadata
- Download URL: zather-0.2.0.tar.gz
- Upload date:
- Size: 12.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
55d3fab493f316a7ea1498023c6723c76d1bacf70149793ba55ae42193b41236
|
|
| MD5 |
f3f705f37e762e3af4ad87f96a07879a
|
|
| BLAKE2b-256 |
340e62ac82bba6335559d9ab6e9384e81d70006884818da60057dd20c58b9340
|
File details
Details for the file zather-0.2.0-py3-none-any.whl.
File metadata
- Download URL: zather-0.2.0-py3-none-any.whl
- Upload date:
- Size: 16.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
969b2a6bf399414b05f9f4be63cecc0deeb0c5b5458528f3f8026f3159e3d5ed
|
|
| MD5 |
c830adb87df4b3a87e2cb33cb039e001
|
|
| BLAKE2b-256 |
b50cb6e76e125f4e4a376e350fbe21d27a600dc231e01369f520275a7d59943d
|
