Files
feynman/website/src/content/docs/tools/session-search.md
Advait Paliwal 8f8cf2a4a9 Rebuild website from scratch on Tailwind v4 + shadcn/ui
- Fresh Astro 5 project with Tailwind v4 and shadcn/ui olive preset
- All shadcn components installed (Card, Button, Badge, Separator, etc.)
- Homepage with hero, terminal demo, workflows, agents, sources, compute
- Full docs system with 24 markdown pages across 5 sections
- Sidebar navigation with active state highlighting
- Prose styles for markdown content using shadcn color tokens
- Dark/light theme toggle with localStorage persistence
- Shiki everforest syntax themes for code blocks
- 404 page with VT323 font
- /docs redirect to installation page
- GitHub star count fetch
- Earthy green/cream oklch color palette matching TUI theme

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-24 15:57:03 -07:00

2.2 KiB

title, description, section, order
title description section order
Session Search Search prior Feynman session transcripts to recall past research. Tools 3

The session search tool recovers prior Feynman work from stored session transcripts. Every Feynman session is persisted to disk, and session search lets you find and reference past research, findings, and generated artifacts without starting over.

Installation

Session search is an optional package. Install it with:

feynman packages install session-search

Once installed, the /search slash command and automatic session recall become available in all future sessions.

Usage

Inside the REPL, invoke session search directly:

/search transformer scaling laws

You can also reference prior work naturally in conversation. Feynman invokes session search automatically when you mention previous research or ask to continue earlier work. For example, saying "pick up where I left off on protein folding" triggers a session search behind the scenes.

What it searches

Session search indexes the full contents of your session history:

  • Full session transcripts including your prompts and Feynman's responses
  • Tool outputs and agent results from workflows like deep research and literature review
  • Generated artifacts such as drafts, reports, and comparison matrices
  • Metadata like timestamps, topics, and workflow types

The search uses both keyword matching and semantic similarity to find relevant past work. Results include the session ID, timestamp, and relevant excerpts so you can quickly identify which session contains the information you need.

When to use it

Session search is valuable when you want to pick up a previous research thread without rerunning an expensive workflow, find specific findings or citations from a past deep research session, reference prior analysis in a new research context, or check what you have already investigated on a topic before launching a new round.

How it works

The @kaiserlich-dev/pi-session-search package provides the underlying search and indexing. Sessions are stored in ~/.feynman/sessions/ by default (configurable with --session-dir). The index is built incrementally as new sessions complete, so search stays fast even with hundreds of past sessions.