← Back to Skills Marketplace
Session-logs
by
guogang1024
· GitHub ↗
· v1.0.0
46447
Downloads
31
Stars
0
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 conversation logs. When using it, ask for narrow searches by date, topic, or session, and avoid requesting raw transcript output when summaries or redacted results are enough.
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 searching and analyzing prior/parent conversation logs, and the provided jq/rg examples are directly aligned with that read-only log-analysis purpose.
Instruction Scope
The instructions explicitly include complete conversation history and all-session searches, which is broad but disclosed and tied to the skill's purpose; they would benefit from stronger privacy and minimization guidance.
Install Mechanism
The artifact is a single markdown skill requiring jq and rg; no install scripts, package mutation, or executable payloads were identified.
Credentials
Access is scoped to the agent session-log directory, but that directory may contain sensitive prior user messages, tool output, or unrelated historical context.
Persistence & Privilege
No persistence, privilege escalation, destructive behavior, credential harvesting, background execution, or network exfiltration is present in the artifacts.
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 46447 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