Agent skill

Session Search

by mikeyobrien in mikeyobrien/rho

Search across pi session JSONL logs (user prompts, tool calls, results).

MITAuto-check passed

Install Session Search

skills CLI
$ npx skills add mikeyobrien/rho --skill session-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install mikeyobrien/rho session-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/mikeyobrien/rho.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/session-search .claude/skills/session-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-search
GitHub stars
372
Token cost
~558 tokens
SKILL.md length
189 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Search across pi session JSONL logs (user prompts, tool calls, results).

  • Works in 2 steps: Generate digests for a time window → Search the digest markdown
  • SKILL.md covers Where sessions live, Method A (recommended):…, Method B: direct grep over raw… and Common queries, plus 1 more section
  • Calls rg

What it does

Session Search is an agent skill from mikeyobrien/rho. Search across pi session JSONL logs (user prompts, tool calls, results). Uses the session-digest tool and ripgrep for fast triage.

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: An AI agent that stays running, remembers across sessions, and checks in on its own. macOS, Linux, Android. Built on Pi. The licence is MIT.

Example prompts

  • “/session-search”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Generate digests for a time window
  2. Search the digest markdown

What it can do on your machine

Read from SKILL.md and the folder at commit 073a3ee. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Session Search loads about 558 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 189 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~558

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mikeyobrien/rho at commit 073a3ee, republished under its MIT licence (© mikeyobrien). 189 words, ~558 tokens.

Download SKILL.mdSave it as .claude/skills/session-search/SKILL.md (or your agent's skills folder).
name
session-search
description
Search across pi session JSONL logs (user prompts, tool calls, results). Uses the session-digest tool and ripgrep for fast triage.
kind
sop

Search historical pi sessions stored under ~/.pi/agent/sessions/.

This skill assumes the session-digest helper exists at ~/bin/session-digest.

Where sessions live

On this Termux setup, sessions are typically stored in:

  • ~/.pi/agent/sessions/--data-data-com.termux-files-home--/*.jsonl

If you are unsure which directory is active, list the session roots:

bash
ls -la ~/.pi/agent/sessions

session-digest parses session JSONL into readable markdown and writes files to:

  • ~/.rho/digests/YYYY-MM-DD.md
  1. Generate digests for a time window:
bash
# last 7 days
session-digest --week >/dev/null

# or a single date
session-digest 2026-02-04 >/dev/null

# or all history (can be slow)
session-digest --all >/dev/null
  1. Search the digest markdown:
bash
rg -n "<query>" ~/.rho/digests

Notes:

  • This is the safest way to skim history because session-digest also flags potential secrets.
  • If session-digest reports secrets, do NOT paste results into public logs.

Method B: direct grep over raw JSONL (fastest, messiest)

Search the raw session logs directly:

bash
SESSION_ROOT=~/.pi/agent/sessions/--data-data-com.termux-files-home--
rg -n --hidden "<query>" "$SESSION_ROOT"/*.jsonl

Useful variants:

bash
# show a little context around matches
rg -n -C 2 "<query>" "$SESSION_ROOT"/*.jsonl

# case-insensitive
rg -n -i "<query>" "$SESSION_ROOT"/*.jsonl

Common queries

  • Find when a specific tool was used:
    • rg -n '"type":"toolCall"' ... | rg '"name":"vault_search"'
  • Find a user prompt:
    • rg -n '"role":"user"' ... | rg "<phrase>"
  • Find a specific file path mentioned:
    • rg -n "projects/rho" ...

Guardrails

  • Session logs can contain credentials (tokens, API keys, private URLs).
  • Prefer Method A first: it surfaces warnings via secret scanning.
  • If you need to share excerpts, redact aggressively and re-run session-digest to confirm no secrets are present.

© mikeyobrien, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/session-search of mikeyobrien/rho.

Open the folder on GitHubat commit 073a3ee

Compare with similar skills

Session Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Session Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Search this skillmikeyobrien/rho372—~558Automated safety check: PassMIT
Growth Logaffaan-m/ECC276k1 repos~1.7kAutomated safety check: PassMIT
Clickhouse Logs Queriessupabase/supabase111k—~2.4kAutomated safety check: PassApache-2.0
Investigating LogsPostHog/posthog40k—~2.1kAutomated safety check: PassCustom licence
Logging and Error Reporting for Warpwarpdotdev/warp65k1 repos~5.6kAutomated safety check: PassAGPL-3.0
Analyze Logsactivepieces/activepieces25k1 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Growth Log

    affaan-m/ECC

    Write growth log entries that extract reusable patterns from completed work — root cause, transferable rule, and a recognizable signal — instead of diary-style event narration, with a 4-8 sentence…

    276k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Clickhouse Logs Queries

    supabase/supabase

    Official

    Write, review, and migrate Supabase logs queries against the ClickHouse-backed logs table (the logs.all.otel analytics endpoint).

    111k GitHub stars~2.4k tokensUpdated today
    DatabasesAuto-check passed
  • Investigating Logs

    PostHog/posthog

    Official

    Investigate logs in a PostHog project: verify a service or deployment is healthy, explain an error spike, triage an incident, or understand what a log stream is saying.

    40k GitHub stars~2.1k tokensUpdated today
    DatabasesAuto-check passed
  • Guides log level choices and when to raise a structured Sentry event instead of a plain log line in the Warp Rust codebase, keeping secrets out of logs.

    65k GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed
  • Analyze Logs

    activepieces/activepieces

    Analyze application logs from the .evlog/logs/ directory. An agent skill from activepieces/activepieces.

    25k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • KubeSphere WizTelemetry Logging

    kubesphere/kubesphere

    Installs and configures WizTelemetry Logging for KubeSphere, with container log and optional disk log collection, dependency checks and the log query API.

    17k GitHub stars~2.3k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed

More from mikeyobrien/rho

All 35 skills in this repo
  • Rho Cloud Onboard

    mikeyobrien/rho

    Register an agent email address on Rhobot Mail (name@rhobot.dev).

    372 GitHub stars~1.4k tokensUpdated 8 days ago
    Auto-check passed
  • Install Rho

    mikeyobrien/rho

    Install and configure Rho from scratch (Doom-style init.toml + sync).

    372 GitHub stars~1.6k tokensUpdated 8 days ago
    Auto-check: notes
  • Open URL

    mikeyobrien/rho

    Open URLs and launch apps on Android. An agent skill from mikeyobrien/rho.

    372 GitHub stars~480 tokensUpdated 8 days ago
    Auto-check passed
  • Release Changelog

    mikeyobrien/rho

    Keep CHANGELOG.md idiomatic (Keep a Changelog) and cut a tag-based GitHub release that triggers npm publish CI.

    372 GitHub stars~1.4k tokensUpdated 8 days ago
    Auto-check passed
  • Rho Cloud Email

    mikeyobrien/rho

    Manage agent email at name@rhobot.dev via the Rhobot Mail API.

    372 GitHub stars~2.6k tokensUpdated 8 days ago
    Auto-check passed
  • Tasker XML

    mikeyobrien/rho

    Create Tasker profiles and tasks via XML for Android automation.

    372 GitHub stars~3.1k tokensUpdated 8 days ago
    Auto-check passed

Questions about Session Search

What does Session Search do?

Search across pi session JSONL logs (user prompts, tool calls, results). Session Search is an agent skill from mikeyobrien/rho. Search across pi session JSONL logs (user prompts, tool calls, results).

How do I install Session Search in Claude Code?

Run `npx skills add mikeyobrien/rho --skill session-search -a claude-code`. Or copy the skill folder (skills/session-search in mikeyobrien/rho) into .claude/skills/session-search in your project. Claude Code loads it when a task matches its description.

How do I install Session Search in Codex?

Run `npx skills add mikeyobrien/rho --skill session-search -a codex`. Or copy the skill folder (skills/session-search in mikeyobrien/rho) into .agents/skills/session-search in your project. Codex loads it when a task matches its description.

Can I use Session Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mikeyobrien/rho --skill session-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-search, .gemini/skills/session-search, .github/skills/session-search and .opencode/skills/session-search in your project.

What does Session Search need to run?

Going by SKILL.md and its folder, Session Search needs the command-line tools its instructions call (rg).

Does Session Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Session Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Session Search use?

Session Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Session Search use?

About 558 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Session Search?

Skills that share tags, products or a category with Session Search: Growth Log (affaan-m/ECC, 276k stars), Clickhouse Logs Queries (supabase/supabase, 111k stars), Investigating Logs (PostHog/posthog, 40k stars) and Logging and Error Reporting for Warp (warpdotdev/warp, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Search?

mikeyobrien (a GitHub user) maintains it in mikeyobrien/rho, which has 372 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 1, 2026.

Source: mikeyobrien/rho on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.