Skip to content

session-semantic-recovery-with-seq.md

Latest commit

 

History

History
103 lines (74 loc) · 2.69 KB

session-semantic-recovery-with-seq.md

File metadata and controls

103 lines (74 loc) · 2.69 KB

Semantic Session Recovery with Seq (Claude/Codex)

Use this when local Claude/Codex session state got wiped (for example after a machine reset), and you want to recover work by searching prior sessions semantically.

This workflow uses:

  • Flow session commands (f ai ...) for exact resume behavior
  • Seq's zvec-backed session index for semantic retrieval + fuzzy picker

What You Get

  • Fast semantic search over historical Claude/Codex Q/A pairs
  • Scope to the current repo path
  • Picker flow similar to Flow fuzzy task flows (fzf)
  • Direct resume command output:
    • f ai claude resume <session-id>
    • f ai codex resume <session-id>

Prerequisites

  1. seq repo exists at ~/code/seq.
  2. Agent Q/A capture has data in ~/repos/alibaba/zvec/data/agent_qa.jsonl.
  3. fzf installed for interactive picker.

One-Time Setup

From ~/code/seq:

f rl-capture-on
f agent-qa-capture-on

If you need historical backfill:

f agent-qa-capture-on-backfill

Quick status check:

f agent-qa-capture-status

Primary Commands

From ~/code/seq:

# Semantic search + interactive picker + auto-resume
f agent-session-search "router regression around branch sync"

# Open picker with no query (recent-first)
f agent-session-search

# Non-interactive listing
f agent-session-search-list "skill sync force reload"

Provider filter:

f agent-session-search --provider claude "deploy rollback"
f agent-session-search --provider codex "trace parser failure"

Use from Any Repo

If you are in another repo and want path-attached session search without changing directory:

f run --config ~/code/seq/flow.toml agent-session-search --path "$(pwd)" "your query"

List-only variant:

f run --config ~/code/seq/flow.toml agent-session-search-list --path "$(pwd)" "your query"

Recovery Playbook After Reset

  1. Go to target repo:
    • cd /path/to/repo
  2. Run semantic search via Seq task:
    • f run --config ~/code/seq/flow.toml agent-session-search --path "$(pwd)" "<query>"
  3. Pick best session in fzf.
  4. Flow resumes exact session ID with strict provider behavior.
  5. If needed, inspect normal repo-local session list:
    • f ai claude list
    • f ai codex list

Troubleshooting

  • Repo path changed (rename/move):
    • Run f code move-sessions --from /old/path --to /new/path.
    • This migrates Claude/Codex session paths and Seq zvec agent_qa.jsonl metadata so folder-scoped semantic search still matches the new path.
  • No results:
    • Run f agent-qa-capture-once --backfill --reset-state in ~/code/seq.
  • No picker:
    • Install fzf, or use agent-session-search-list.
  • Wrong scope:
    • Pass explicit --path /absolute/repo/path.