Add Cursor session support and trim transcript noise

Author: nikivdev

docs/commands/ai.md

@@ -1,23 +1,27 @@
 # f ai
 
-Manage Claude Code and Codex sessions for the current project.
+Manage Claude Code, Codex, and Cursor sessions for the current project.
 
 Flow reads local session stores, filters by current project path, and gives you one interface for list/search/resume/copy/save.
 When you need to reopen a repo's session from another working directory, use `--path <project-root>` on `resume` or provider-specific `continue`.
+Cursor transcripts are supported for reading only.
 
 ## Quick Start
 
 ```bash
-# Fuzzy-pick a recent session (Claude + Codex) and resume
+# Fuzzy-pick a recent session (Claude + Codex + Cursor)
 f ai
 
-# Provider-specific list/resume
+# Provider-specific list/read
 f ai claude list
 f ai codex list
+f ai cursor list
 f ai claude resume <session-id-or-name>
 f ai codex resume <session-id-or-name>
 f ai codex resume --path ~/work/example-project
 f ai codex continue --path ~/work/example-project
+f ai cursor context - /path/to/repo 3
+f cursor copy
 
 # Save a memorable alias for a session
 f ai save reclaim-fix --id a38cf8bf-f4e2-4308-8b27-0254f89c4385
@@ -27,6 +31,7 @@ f ai save reclaim-fix --id a38cf8bf-f4e2-4308-8b27-0254f89c4385
 
 - Claude: `~/.claude/projects/<project-path>/*.jsonl`
 - Codex: `~/.codex/sessions/**/*.jsonl` (Flow matches by `session_meta.cwd`)
+- Cursor: `~/.cursor/projects/<project-key>/agent-transcripts/<session-id>/<session-id>.jsonl`
 - Saved aliases: `.ai/sessions/claude/index.json` in your repo
 
 ## Resume Behavior (Important)
@@ -38,6 +43,7 @@ Resume is interactive by design.
 - `f ai claude resume ...` requires a terminal TTY.
 - `f ai codex resume ...` requires a terminal TTY.
 - In non-interactive shells, Flow exits with a clear error and non-zero status.
+- Cursor does not currently expose a Flow resume/continue path; use `list`, `copy`, or `context`.
 
 ### Claude exact-ID behavior
 
@@ -64,6 +70,15 @@ codex resume <id> --dangerously-bypass-approvals-and-sandbox
 
 No fallback is applied on resume failure; Flow returns non-zero.
 
+### Cursor behavior
+
+Cursor transcripts are read-only in Flow:
+
+- `f ai cursor list` opens a picker and copies the selected transcript
+- `f ai cursor copy` copies the latest Cursor transcript for this repo
+- `f ai cursor context ...` copies the last N exchanges
+- `f cursor ...` is a shortcut for the same provider-specific read commands
+
 ### Cross-directory resume
 
 You can target another repo without changing directory:
@@ -94,6 +109,7 @@ f ai resume my-feature
 f ai resume a38cf8bf
 f ai claude resume 2
 f ai codex resume 019c61c5-0aef-71a1-b058-5c9ab43013d4
+f ai cursor context 382ef1a3 /path/to/repo 2
 ```
 
 ## Content Copy Commands
@@ -112,6 +128,7 @@ Use `-` as session placeholder to trigger fuzzy selection:
 
 ```bash
 f ai claude context - /path/to/repo 3
+f ai cursor context - /path/to/repo 3
 ```
 
 ## Project Workflow (Recommended)

docs/session-history-mining.md

@@ -1,6 +1,6 @@
-# Session History Mining for Claude/Codex
+# Session History Mining for Claude/Codex/Cursor
 
-Use this when you want an AI agent to study recent Claude/Codex work before proposing a plan.
+Use this when you want an AI agent to study recent Claude/Codex/Cursor work before proposing a plan.
 
 This is optimized for:
 - cross-project history review
@@ -15,7 +15,7 @@ Use Flow's cross-project session browser:
 f sessions
 ```
 
-`f sessions` scans Claude + Codex sessions across projects, lets you pick one, and copies context to clipboard.
+`f sessions` scans Claude + Codex + Cursor sessions across projects, lets you pick one, and copies context to clipboard.
 
 ## Core Commands
 
@@ -29,6 +29,9 @@ f sessions --provider claude --list
 # Only Codex sessions
 f sessions --provider codex --list
 
+# Only Cursor sessions
+f sessions --provider cursor --list
+
 # Copy selected session context (interactive picker via fzf)
 f sessions --provider all
 
@@ -63,9 +66,11 @@ If you need more detail from a known session in the current repo:
 ```bash
 f ai claude list
 f ai codex list
+f ai cursor list
 
 # Copy the last 6 exchanges from a selected Claude session for this repo
 f ai claude context - /absolute/path/to/repo 6
+f ai cursor context - /absolute/path/to/repo 6
 ```
 
 Use this after `f sessions` when you want to zoom in on one thread.
@@ -77,6 +82,7 @@ Use this after `f sessions` when you want to zoom in on one thread.
 2. Pull 2 to 4 high-signal contexts:
    `f sessions --provider claude --count 6`
    `f sessions --provider codex --count 6`
+   `f sessions --provider cursor --count 6`
 3. For stale/long sessions, prefer condensed transfer:
    `f sessions --provider all --handoff`
 4. Paste each copied output into labeled blocks in your prompt.
@@ -91,7 +97,7 @@ I have ~$500 of Claude tokens expiring in <N> day(s) and want to use them effici
 
 Goal:
 - study goose and propose a concrete execution plan for token usage
-- use ideas from recent Claude/Codex histories
+- use ideas from recent Claude/Codex/Cursor histories
 - rank ideas by expected impact and execution cost
 
 Constraints:
@@ -108,6 +114,9 @@ Session context 2:
 Session context 3 (optional handoff):
 <paste from f sessions --provider all --handoff>
 
+Session context 4 (optional Cursor):
+<paste from f sessions --provider cursor --count 6>
+
 Deliver:
 1. top opportunities (ranked)
 2. 48-hour execution plan
@@ -119,6 +128,7 @@ Deliver:
 
 - Prefer `--count` over `--full` unless you are reconstructing full intent.
 - Prefer `--handoff` for large stale sessions before pasting into expensive models.
+- Cursor transcripts use file-modified time rather than per-message timestamps, so repeated copies may include the whole latest transcript after a new edit.
 - Merge duplicate context manually before sending to avoid repeated tokens.
 - Request ranked outputs with hard deliverables (plan, commands, owners, fallback).