OpenSkillIndex← back to search
claude-code

PythonClaw session_logs

Search and analyse your own conversation history from session files. Use when: user references older conversations, asks what was said before, or needs historical context from past sessions. NOT for: current session messages (already in context), non-session files, or external logs.

install
source · Clone the upstream repo
git clone https://github.com/ericwang915/PythonClaw
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ericwang915/PythonClaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/pythonclaw/templates/skills/system/session_logs" ~/.claude/skills/ericwang915-pythonclaw-session-logs && rm -rf "$T"
manifest: pythonclaw/templates/skills/system/session_logs/SKILL.md
source content

Session Logs

Search your complete conversation history stored in session Markdown files.

When to Use

✅ USE this skill when:

  • "What did we talk about yesterday?"
  • "Find the conversation where I asked about X"
  • "How many sessions have I had?"
  • "What was the decision we made about Y?"
  • User references a past conversation not in current context

When NOT to Use

❌ DON'T use this skill when:

  • Current session context → already in your message history
  • Application error logs → use 
    read_file
    on log files directly
  • Non-PythonClaw logs → use 
    run_command
    with grep/rg

Session File Location

Session files are stored under 

~/.pythonclaw/context/sessions/
.

Each session is a Markdown file named 

<session_id>.md
containing the full conversation transcript.

Commands

List all sessions by date and size

ls -lhS ~/.pythonclaw/context/sessions/*.md

Search across ALL sessions for a keyword

python {skill_path}/search_sessions.py "keyword"

Or with grep:

grep -rl "keyword" ~/.pythonclaw/context/sessions/*.md

Read a specific session

cat ~/.pythonclaw/context/sessions/<session_id>.md

Count sessions

ls ~/.pythonclaw/context/sessions/*.md | wc -l

Notes

  • Session files are append-only Markdown
  • Large sessions can be several hundred KB — use 
    head
    /
    tail
    for sampling
  • Session IDs follow the pattern 
    <channel>_<id>
    (e.g. 
    telegram_123456
    , 
    web_default
    )
  • The 
    history_detail.jsonl
    file contains structured tool-call logs

Resources

FileDescription
search_sessions.py
Search across all session files by keyword