session-search

Search past session data via SQLite queries, REST API, and file system tools.

6|4|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/kortix-ai/kortix-registry --skill session-search-kortix-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-search
Source: https://github.com/kortix-ai/kortix-registry/tree/main/files/plugin/kortix-sys/skills/session-search
Command: npx skills add https://github.com/kortix-ai/kortix-registry --skill session-search-kortix-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive tools to search, retrieve, and analyze past session data, ensuring you can easily access historical information, conversation logs, and tool usage.

Core Features & Use Cases

  • Session Discovery: Quickly find sessions by title or metadata using session_list.
  • Content Retrieval: Access full conversation history, compressed for efficiency, with session_get.
  • Deep Search: Utilize raw SQLite queries, grep on legacy JSON, or semantic search (lss) for specific data points or conceptual matches.
  • Use Case: You need to recall a specific decision made in a past project. Use session_list to find relevant sessions, then session_get to retrieve the conversation, or lss to semantically search for the decision context.

Quick Start

Find all sessions related to 'authentication' by searching their titles.

Frequently Asked Questions about session-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search past session history in SQLite for a specific conversation?

Search past session history by running direct SQLite queries on the opencode.db database to locate historical conversation content, tool usage, and session metadata within the environment.

What is the best way to retrieve conversation logs and tool usage data from previous sessions?

The best way to retrieve conversation logs is using the session_get tool to access full compressed conversation history, or session_list to quickly find sessions by title and metadata.

Can I use grep to search legacy JSON session files in the storage directory?

Yes, you can use grep to search legacy JSON session files directly within the .local/share/opencode/storage directory for specific data points or text matches.

How do I find past sessions by title or metadata without writing raw SQL queries?

Find past sessions by title or metadata using the session_list tool, which enables quick session discovery without requiring you to write raw SQL queries against the database.

Does semantic search work for retrieving historical conversation content?

Yes, semantic search works for retrieving historical conversation content by using the lss tool to find conceptual matches and decision context within past session data.

What database and file paths do I need to access full session search functionality?

You need access to the opencode.db SQLite database and the .local/share/opencode/storage directory to utilize full session search and retrieval functionality.