puenteo 0.4.0

Puenteo — the bridge between coding agents. List, search, and export Claude/Codex/Grok/Pi sessions to md/html/pdf/json/zip (Python library + CLI).

puenteo

The bridge between coding agents.

Python library + CLI to discover, search, and export local sessions from Claude Code, Codex, Grok, and Pi — to Markdown, HTML, PDF, JSON, ZIP, CSV, XML, YAML.

Puenteo ← Spanish puente (bridge) + puentear (to bridge / jump across).

Zero runtime dependencies · Python ≥ 3.9

Install

pip install puenteo
# or
uv add puenteo
# or
pipx install puenteo

From source:

git clone https://github.com/mano7onam/puenteo.git
cd puenteo
python3 -m venv .venv && .venv/bin/pip install -e .

Library

import puenteo

print(puenteo.status())

for s in puenteo.list_sessions(limit=10):
    print(s.provider, s.session_id[:8], s.title)

t = puenteo.load("019f7a24", include_tools=True)
hits = puenteo.search("gatekeeper dmg")
msgs = puenteo.pull("019f7a24", query="export", mode="query")

puenteo.export_session("019f7a24", fmt="md", output="chat.md")
puenteo.export_session("019f7a24", fmt="pdf", output="chat.pdf")
puenteo.export_session("019f7a24", fmt="all", output="./exports/")

data, media_type, filename = puenteo.export_bytes("019f7a24", fmt="html")

CLI

puenteo status
puenteo list -n 20 --json
puenteo list --provider claude,grok --cwd ~/dev/myapp
puenteo show <id> --last 40
puenteo search "topic" --json
puenteo pull <id> --query "topic" --mode query --max-chars 8000
puenteo export <id> -f md -o chat.md
puenteo export <id> -f pdf -o chat.pdf
puenteo export <id> -f html|json|zip|csv|xml|yaml -o …
puenteo export <id> -f all -o ./out/

Short alias after install: pto (same as puenteo).

<id> = full uuid, prefix, path, or unique title substring.

Providers

Provider	Store
Claude Code	~/.claude/projects/**/*.jsonl
Codex	~/.codex/sessions/**/rollout-*.jsonl
Grok	~/.grok/sessions/**/chat_history.jsonl
Pi	~/.pi/agent/sessions/**/*.jsonl

Export formats

md · txt · html · pdf · json · zip · csv · xml · yaml

Agent skill

./scripts/install_skills.sh

Used by

Terminal Dashboard imports puenteo for chat export (shared parsers, no duplication).

License

MIT · mano7onam/puenteo