← Back to Skills Marketplace
Session-logs
by
guogang1024
· GitHub ↗
· v1.0.0
41842
Downloads
30
Stars
1458
Active Installs
1
Versions
Install in OpenClaw
/install session-logs
Description
Search and analyze your own session logs (older/parent conversations) using jq.
Usage Guidance
Install only if you are comfortable letting the agent search older local session logs. Ask it to limit searches by date, topic, or session when possible, and avoid surfacing unrelated sensitive content from prior conversations.
Capability Analysis
Type: OpenClaw Skill
Name: session-logs
Version: 1.0.0
The skill is designed to search and analyze the agent's own session logs using standard Unix utilities like `jq` and `rg`. All shell commands provided in `SKILL.md` operate exclusively on files within the agent's internal log directory (`~/.clawdbot/agents/<agentId>/sessions/`) and are directly relevant to the stated purpose. There is no evidence of data exfiltration, malicious execution, persistence, or prompt injection with harmful intent. The instructions guide the agent to perform its intended function of log analysis.
Capability Assessment
Purpose & Capability
The stated purpose is session-log search and analysis, and the described commands are aligned with reading local agent session logs.
Instruction Scope
The scope includes historical and parent session logs, which is expected for the purpose but can expose sensitive prior conversation content.
Install Mechanism
No concerning install behavior, package mutation, background service, or dependency execution was identified from the supplied evidence.
Credentials
Access is limited to the agent's internal session-log directory rather than the broader filesystem, but that directory may contain private information from unrelated past chats.
Persistence & Privilege
No evidence of persistence, privilege escalation, credential harvesting, destructive actions, or network exfiltration was found.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install session-logs - After installation, invoke the skill by name or use
/session-logs - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of session-logs.
- Enables searching and analyzing your session logs (past conversations) with jq and ripgrep (rg).
- Provides bash command examples for session discovery, keyword searches, extracting messages, cost summaries, and tool usage breakdowns.
- Documents JSONL session file structure, roles, and content types.
- Lists session log file locations and naming conventions.
- Includes tips for managing and querying large, append-only session histories.
Metadata
Frequently Asked Questions
What is Session-logs?
Search and analyze your own session logs (older/parent conversations) using jq. It is an AI Agent Skill for Claude Code / OpenClaw, with 41842 downloads so far.
How do I install Session-logs?
Run "/install session-logs" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Session-logs free?
Yes, Session-logs is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Session-logs support?
Session-logs is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Session-logs?
It is built and maintained by guogang1024 (@guogang1024); the current version is v1.0.0.
More Skills