sessions

Index and retrieve agent conversation transcripts with filtering by project, agent type, and time ranges.

15|6|Updated Apr 20, 2026

Search Tags:#debugging #cli #agents #history #sessions #transcripts

Ready to run

npx skills add https://github.com/phnx-labs/agents-cli --skill sessions-phnx-labs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sessions
Source: https://github.com/phnx-labs/agents-cli/tree/main/.agents/skills/sessions
Command: npx skills add https://github.com/phnx-labs/agents-cli --skill sessions-phnx-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the challenge of fragmented agent interactions by providing a centralized way to search, browse, and audit conversation transcripts across multiple agent types and projects.

Core Features & Use Cases

Cross-Agent Search: Query conversation history across Codex, Gemini, and OpenCode agents using text-based search.
Context Recovery: Quickly retrieve previous session details, including artifacts and specific turns, to resume stalled work or debug past agent behavior.
Use Case: If you need to recall the specific logic an agent used to implement an authentication middleware three days ago, you can search your session history to find the exact transcript and recover the context.

Quick Start

Use the sessions skill to search for all recent conversations related to the authentication middleware implementation.

Frequently Asked Questions about sessions

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

FAQPage Schema

How do I search and recover agent conversation history across multiple CLI tools?▼

To search agent conversation history, you can index and retrieve conversation transcripts across diverse CLI-based agent environments, filtering by project, agent type, and temporal ranges to recover stalled work context.

Can I retrieve previous session details and artifacts to debug past agent behavior?▼

Yes, you can retrieve previous session details and artifacts to debug past agent behavior by querying conversation history to find the exact transcript and recover the context of specific logic implemented.

Does session history search work with Codex, Gemini, and OpenCode agents?▼

Session history search supports cross-agent querying across Codex, Gemini, and OpenCode agents, allowing you to perform text-based search and browse conversation transcripts from these diverse CLI environments.

What is the best way to live-tail active agent processes and audit session metadata?▼

The best way to audit session metadata and live-tail active agent processes is by using programmatic access to index conversation transcripts, facilitating context recovery and real-time session auditing.

How do I filter conversation transcripts by project, agent type, and temporal ranges?▼

You filter conversation transcripts by project, agent type, and temporal ranges using the indexing and retrieval features, which support querying across multiple agent types to locate specific session metadata and artifacts.