Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt

Use this file to discover all available pages before exploring further.

First 0.6 beta. Adds trellis mem: search past Claude Code, Codex, and OpenCode sessions by keyword, read the turns around each match, and dump full conversations.

​
New feature: trellis mem

Reads each platform’s session files on disk (Claude Code, Codex, OpenCode), strips hook injections, AGENTS.md preambles, and tool-call noise, then lets you search by keyword and read the actual dialogue around each match. 
trellis mem list                          # list sessions across platforms
trellis mem search "user login"           # find sessions whose contents match
trellis mem context <session-id>          # top-N hit turns + surrounding context
trellis mem extract <session-id>          # dump cleaned dialogue (--grep KW to filter)
trellis mem projects                      # list active project cwds (AI-routing entry)
Subcommands accept filters: --since 2026-04-01, --cwd /abs/path, --platform claude|codex|opencode, --json. Run trellis mem help for the full reference. Mechanics:
  • Reads ~/.claude/projects/<encoded-cwd>/<uuid>.jsonl (Claude Code), Codex session JSON, and OpenCode <storage>/messages/<session-id>/*.json. No live process attach; works on closed sessions.
  • Strips workflow-state breadcrumbs, session-context blocks, and hook output so search hits surface real user / assistant turns. Handles compaction (Claude isCompactSummary + Codex compacted events).
  • 84 unit tests (Tier 1 pure helpers + Tier 2 fixture-driven platform parsers + Tier 3 subcommand integration). mem.ts coverage: 81.89% statement / 89.04% function / 87.93% line.

​
Install

npm install -g @mindfoldhq/trellis@beta
trellis update
This is a beta. The 0.5 stable line continues to receive patches if needed; install latest stable with @latest instead. Switch back from beta to stable with npm install -g @mindfoldhq/trellis@latest.