session-logs

by Unknown v1.0.0

This skill enables you to search and analyze your agent's complete conversation history stored in JSONL session log files. It provides various queries and tools for extracting information, summarizing costs, and understanding past interactions. Useful for recalling details from previous sessions or analyzing agent behavior over time.

What It Does

Allows searching and analyzing session logs to recall past conversations, analyze usage costs, and understand agent behavior over time.

When To Use

When a user references older/parent conversations, asks what was said before, or when analyzing agent behavior and costs across multiple sessions.

Inputs

None. Relies on access to the agent's session logs stored in `~/.openclaw/agents/<agentId>/sessions/`.

Outputs

Returns relevant information extracted from the session logs, such as specific messages, cost summaries, or tool usage statistics, formatted as text or JSON.

Limitations

Requires `jq` and `rg` to be installed and available in the system's PATH. Performance may be limited when analyzing very large session logs without targeted filtering.

Installation

1. Ensure `jq` and `rg` are installed on your system. You can typically install them using your system's package manager (e.g., `apt-get install jq ripgrep` on Debian/Ubuntu). 2. Verify that `jq` and `rg` are in your system's PATH. 3. No further installation is required; the skill will automatically access the session logs in the default location.

View Claude (Anthropic) documentation

1. Open the Cursor IDE terminal. 2. Install `jq` and `rg` using your system's package manager (e.g., `brew install jq ripgrep` on macOS). 3. Ensure the paths to `jq` and `rg` are correctly configured in your Cursor environment. 4. The skill is ready to use once `jq` and `rg` are accessible from the terminal within Cursor.

View Cursor IDE documentation

1. Install `jq` (a lightweight command-line JSON processor) from [https://stedolan.github.io/jq/download/](https://stedolan.github.io/jq/download/). 2. Install `rg` (ripgrep, a line-oriented search tool that recursively searches directories for a regex pattern) from [https://github.com/BurntSushi/ripgrep#installation](https://github.com/BurntSushi/ripgrep#installation). 3. Add the directories containing the `jq` and `rg` executables to your system's PATH environment variable.

View Cline documentation

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.