# Session Search

Search prior Feynman session transcripts on disk.

- Repository: https://github.com/Companion-Inc/feynman (10055 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Companion-Inc/feynman --skill session-search -g -a claude-code -y`
Codex: `npx skills add Companion-Inc/feynman --skill session-search -g -a codex -y`
Cursor: `npx skills add Companion-Inc/feynman --skill session-search -g -a cursor -y`
Gemini CLI: `npx skills add Companion-Inc/feynman --skill session-search -g -a gemini-cli -y`

## Description

Search prior Feynman session transcripts on disk. Use when the user asks about earlier research sessions, past findings, or wants to resume a prior session.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Session Search

Feynman stores session transcripts as JSONL files under `~/.feynman/sessions/` (or `$FEYNMAN_HOME/.feynman/sessions/`). Each line is a JSON record with a `type` (session, message, model_change) and, for messages, `message.content`.

```bash
grep -ril "scaling laws" ~/.feynman/sessions/                  # sessions that mention a topic
grep -il "scaling laws" -r ~/.feynman/sessions/ | xargs ls -t   # newest first
```

To continue a session you found, run `feynman --session <path>` or pick it with `feynman --resume`.