jsonl-core
Installation
SKILL.md
JSONL Core — Conversation Parsing Infrastructure
Architecture
All parsing logic lives in ${CLAUDE_PLUGIN_ROOT}/scripts/echolib.py — a single Python module (stdlib only, Python 3.6+). The shell scripts are thin wrappers around it.
Data Locations
- Session index (fast path):
~/.claude/projects/<encoded-path>/sessions-index.json - Fallback index (built by echo-sleuth):
~/.claude/projects/<encoded-path>/.echo-sleuth-index.json - Full conversations:
~/.claude/projects/<encoded-path>/<uuid>.jsonl - Subagent conversations:
~/.claude/projects/<encoded-path>/<uuid>/subagents/agent-<id>.jsonl - Global prompt history:
~/.claude/history.jsonl
The <encoded-path> is the project's absolute path with / replaced by - (e.g., -Users-joker-github-myproject).
Important: Only ~10% of projects have sessions-index.json. The scripts automatically build a fallback index from raw .jsonl files for the remaining 90%, cached in .echo-sleuth-index.json.