Skip to main content

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.

Override with:

zather build ... --prompt zather/zather/prompts/path_pack.yaml --model gpt-5-mini

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zather-0.1.0.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zather-0.1.0-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file zather-0.1.0.tar.gz.

File metadata

  • Download URL: zather-0.1.0.tar.gz
  • Upload date:
  • Size: 11.0 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

Hashes for zather-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ef9c72ea4183801fff253d33a010b57058ec9ce892152edc8a07c8a1cbc28a87
MD5 4d433086dd6a2afa575367a66629dd1d
BLAKE2b-256 4f05f3d4bddbb773c1373c8ac5597401a8e7745e9da2f4a11bc7d4c99ce25c9b

See more details on using hashes here.

File details

Details for the file zather-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: zather-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 14.9 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

Hashes for zather-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6029b48696eba24f9cc1826da479323ac628bd46bfd0ad03e049a776ac0c3941
MD5 027f5c858c73d3d62f41f6a5f56fc0fe
BLAKE2b-256 e5ef60a587c252e1913d34ae30567070f462e127a352999b1f0b26e419e5fdc6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page