session-logs
SkillMonitoring & opsUse when the user references an older conversation, parent session, prior reply, missing context, or session JSONL that needs searching with jq or rg.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the session-logs skill
What this skill tells your AI
The instructions your AI receives, as published by qianleigood/crawclaw in skills/session-logs/SKILL.md and read by ahel’s review.
Search conversation history stored in session JSONL files.
Location
Session logs live under:
$CRAWCLAW_STATE_DIR/agents/<agentId>/sessions/
sessions.json: index mapping session keys to session IDs<session-id>.jsonl: full transcript for a session
Common queries
# User messages from one session
jq -r 'select(.message.role == "user") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl
# Assistant text matching a keyword
jq -r 'select(.message.role == "assistant") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl | rg -i "keyword"
# Tool usage breakdown
jq -r '.message.content[]? | select(.type == "toolCall") | .name' <session>.jsonl | sort | uniq -c | sort -rn
# Search across all sessions
SESSION_DIR="${CRAWCLAW_STATE_DIR:-$HOME/.crawclaw}/agents/<agentId>/sessions"
rg -l "phrase" "$SESSION_DIR"/*.jsonl
Notes
- Sessions are append-only JSONL.
- Large sessions can be several MB; sample with
headortailbefore full parsing. - Deleted sessions usually have a
.deleted.<timestamp>suffix.
Signals
- GitHub stars
- 30
- Forks
- 1
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
session-logs-qianleigood- Source
- github.com/qianleigood/crawclaw