> ## 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.

# v0.6.0-beta.0

> 2026-05-08

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.

```bash theme={null}
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

```bash theme={null}
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`.