Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sfind

Local fuzzy finder for Codex, OpenCode, and Claude Code sessions.

Run

cargo run

Sessions are ordered by latest activity. Type to fuzzy-filter directories, provider titles, summaries, and user-authored messages. Directory matches rank ahead of message-only matches. Select with the arrow keys or mouse, inspect the first and latest sent messages, latest received message, and available input, output, and cache token counters, then press Enter to resume the session in its owning CLI. The Stats section shows the latest model and reasoning-effort setting recorded by the provider on one line; unavailable values are shown as -. Click the underlined directory in the details pane to open it in VS Code. If the code command is not available, the click has no effect. Session rows show their total token count at the right edge when space permits. On narrow terminals, the session list is placed above the details instead of beside it.

Use the range button in the top-right to cycle through all sessions, today, or the last 3, 7, or 30 local calendar days. All is selected by default. The CLI button beside it cycles through all providers, Codex, OpenCode (open), and Claude. Click the session-list top border above the provider, date, location, or total-token column to order by it; a downward triangle marks the active column. Provider and location sort alphabetically, total tokens sort largest-first, and non-date orders use newest date as their tie-breaker. The matching-session count is on the bottom-right border.

Press Ctrl-P to close the finder and print a safely quoted command that changes to the project directory and resumes the selected session. The command is printed but not executed. Press Ctrl-Delete, Ctrl-Backspace, or Ctrl-W to remove the last word from the search query. Use Ctrl-Up and Ctrl-Down or the mouse wheel over the details pane to scroll long details.

Press Tab to toggle Fork mode. The selected row turns red and the details header shows FORK. Enter then starts a new provider session forked from the selected history; Ctrl-P prints the equivalent fork command instead. Continue mode remains the default.

Assistant messages, tool inputs and outputs, synthetic prompts, subagent sessions, and injected environment metadata are excluded from search. Unreadable or malformed provider records are skipped with warnings so other sessions can still be used.

Use plain newest-first output without the TUI:

cargo run -- --list

Install

cargo install --path .
sfind

Provider locations default to $CODEX_HOME or ~/.codex, $OPENCODE_DATA_DIR or the operating system data directory, and $CLAUDE_CONFIG_DIR or ~/.claude. Use --codex-home, --opencode-data, and --claude-home to override them.

About

Session management for claude, codex, opencode cli

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages