past-sessionslisted

# Past sessions `agentcarto` reads the on-disk sessions of Claude Code, Codex, Grok and Copilot Chat, and prints them as lines you can read, as JSON when you ask (`--format json`), and as Markdown. Reach for it before grepping the logs yourself: a raw `.jsonl` hands you one line of a large JSON object, with no turn boundaries, no decoded tool calls, and none of the other agents' formats. If `agentcarto` is not installed, say so and stop. Do not fall back to grepping the raw logs and do not guess at what a past session said. ## Three steps Each step narrows what you read. Do not skip to the last one — a session runs to hundreds of kilobytes, and reading a whole one is rarely what the question needs. ```sh # 1. What was worked on here, most recent first agentcarto list --cwd . --limit 3 # 2. Which session, and which turn in it agentcarto search --cwd . --since 7d "handoff" # 3. That session's outline, then only the turns you want agentcarto show 8f3a2b1c agentcarto show 8f3a2b1c --turns 12-14 ``` A hit reports the turn number the outline lists and the TUI shows, so step 2 hands step 3 its argument. The outline gives each turn a size, so you can tell a two-kilobyte turn from a seventy-kilobyte one before you ask for it. ## Flags worth knowing `search` and `list` share `--cwd` (this directory or below it), `--agent` (`claude`, `codex`, `grok`, `copilot` — or one of its editors, `copilot-vc` / `copilot-jb`), `--since` (`7d`, `2w`, `12h`, `2026-08-01`) and `--limit`. `--