trellis-session-insight

Search and extract past AI conversation history via the trellis mem CLI.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/jiozhaoyue/ST-BgLoader --skill trellis-session-insight-jiozhaoyue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-session-insight
Source: https://github.com/jiozhaoyue/ST-BgLoader/tree/main/.cursor/skills/trellis-session-insight
Command: npx skills add https://github.com/jiozhaoyue/ST-BgLoader --skill trellis-session-insight-jiozhaoyue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Decisions and solutions from past AI coding sessions often live only in old conversation logs, forcing you to re-ask questions, re-debug familiar bugs, or lose the rationale behind earlier choices. This Skill teaches the AI how and when to query the trellis mem CLI to recover that cross-session context. ## Core Features & Use Cases - Session Search & Extraction: Search indexed Claude Code, Codex, Pi Agent, and ZCode conversation logs by keyword, then extract cleaned dialogue filtered by phase or grep terms. - Phase-Aware Slicing: Cut sessions at Trellis task boundaries (--phase brainstorm / --phase implement) to recover planning discussions or execution loops separately. - Judgment-Driven Recall: Guidance on when reaching for memory is right (familiar bugs, decision retrieval, cross-session continuation) and when it is noise, plus how to act on findings (quote inline, update PRD, append notes, or just absorb). - Use Case: You hit a timeout bug that feels familiar. The AI runs trellis mem search "timeout" --global, finds the session where it was solved, and quotes the exact fix with a session-id citation. ## Quick Start Ask the AI to check whether you have discussed or solved a similar problem in past sessions before answering your current question.

Frequently Asked Questions about trellis-session-insight

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

FAQPage Schema
How do I search past AI coding sessions for a previous solution?▼

Run trellis mem search with a keyword, adding --global to search every project on the machine. Then use trellis mem context or extract on the matching session id to read the relevant dialogue turns.

How to recover the planning discussion from an earlier task session?▼

Use trellis mem extract with the session id and --phase brainstorm. This slices the session at task.py create and task.py start boundaries, returning only the planning conversation before implementation began.

Which AI coding platforms does trellis mem support?▼

It indexes Claude Code, Codex, Pi Agent, and ZCode session logs from their local storage locations. OpenCode logs are not yet indexable because the provider adapter is still a stub in the current beta.

Does trellis mem upload my conversation history anywhere?▼

No. All reads are local against the platform JSONL files on disk, and the tool is read-only. It performs no remote sync, no edits to session stores, and no network uploads.

Why does phase slicing return nothing for some sessions?▼

Phase slicing depends on task.py create and task.py start calls appearing in the recorded bash history of the session. If those commands ran in a different terminal outside the recorded AI loop, no phase boundaries exist; use --phase all instead.

When should I not search past conversation history?▼

Skip it when the answer is already in the current context, PRD, design docs, git log, or source files, since reading those directly is faster and more authoritative. Also avoid it when the user explicitly asks not to dig through history.