henhouse

Parse Claude Code and Cursor JSONL transcripts into typed session summaries and tool-call events. Stdlib only. Read-only: it never writes a transcript, a registry, or a git tree.

This package is the data layer. It is not the curses dashboard (that stays in leghorn) and it is not top for sessions (that stays in roost). Those products link this schema; they do not take a pip dependency on it.

Schema fields for henhouse.tools.v1 and henhouse.session.v1 are documented in docs/SCHEMA.md. 0.1.x treats those shapes as stable for downstream tools; additive fields are OK.

Install

Python 3.10+:

pip install henhouse

Or install a tagged release from GitHub:

pip install git+https://github.com/gmhoward9289-ops/henhouse@v0.1.1

Develop from a clone:

pip install -e ".[dev]"

One-file / no-deps install is still how roost and leghorn ship: copy this package's src/henhouse/ tree, or keep using the vendored parser in those repos until an optional import lands.

from henhouse import iter_tool_calls, load_tool_calls, summarize, read_tail, ToolCall, SCHEMA_TOOLS

If a pip install leghorn put a top-level henhouse.py on sys.path, that file wins over this package. Use PYTHONPATH=src or uninstall the leftover module file; roost and leghorn themselves keep their vendored parser and do not pip install henhouse.

CLI

python -m henhouse path.jsonl

prints

{"schema": "henhouse.tools.v1", "calls": [ ... ]}

--legacy-json prints a bare list of call objects.

cost_usd on session summaries is always None. Token counts are not a subscription bill; this package will not invent money.

Used by

• leghorn — live git/CI dashboard
• roost — top for sessions
• pytest-session-trace — CI assertions (plan 3)

License

Apache-2.0