Skip to content

Agent Sessions

sivtr treats agent transcripts as local workspace memory sources. You can copy the latest useful turn, browse older sessions in a picker, search across providers, and show exact refs without opening raw transcript files. Prior agent work becomes memory for both humans and later agents.

Skills are how later agents learn to use this memory. A sivtr memory skill can instruct an agent to search local terminal and agent history, expand only the smallest relevant result, and verify current code before trusting prior discussion. See Skills and Reusable Procedures.

ProviderCopy commandDefault discovery
Codexsivtr copy codex ...Codex rollout JSONL files under ~/.codex/sessions
Claude Codesivtr copy claude ...Claude transcript/session environment and local transcripts
Hermessivtr copy hermes ...Hermes session JSONL files under HERMES_HOME or the platform Hermes data directory
OpenCodesivtr copy opencode ...OpenCode local database
Pisivtr copy pi ...Pi session JSONL files under the Pi agent directory

Use agent in search commands when you want all supported providers:

Terminal window
sivtr search agent --match "panic" --format timeline
Terminal window
sivtr copy codex out
sivtr copy claude out
sivtr copy hermes out
sivtr copy opencode out
sivtr copy pi out

out copies the latest assistant reply for the selected provider.

Copy input, output, tool output, or whole session

Section titled “Copy input, output, tool output, or whole session”

Each provider supports the same mode shape:

Terminal window
sivtr copy claude
sivtr copy claude in
sivtr copy claude out
sivtr copy claude tool
sivtr copy claude all
ModeCopies
omittedLast completed user plus assistant turn
inLast user message
outLast assistant reply
toolLast tool output
allWhole parsed session

Replace claude with codex, hermes, opencode, or pi.

Selectors are newest-first and work like command-block selectors:

Terminal window
sivtr copy claude 2
sivtr copy claude 2..4
sivtr copy codex out 3

Use --session to choose a session by picker index, session id, or id prefix:

Terminal window
sivtr copy codex --session 2
sivtr copy codex --session 019df7fb
sivtr copy claude out --session 3 --print
Terminal window
sivtr copy claude tool --regex error
sivtr copy codex all --lines 1:40
sivtr copy hermes out --print
sivtr copy pi out --print

Filters run after selected text is assembled. See Selectors and Filters.

Open a provider-specific picker:

Terminal window
sivtr copy codex --pick
sivtr copy claude --pick
sivtr copy hermes --pick
sivtr copy opencode --pick
sivtr copy pi --pick

Inside the workspace picker:

KeyAction
0 / 1 / 2 / 3Focus source, sessions, dialogues, or content
h / lMove between panes
j / kMove within the current pane
SpaceToggle the current source, session, or dialogue
/Search all loaded sessions
n / NNext or previous search match
iCopy current input/question
oCopy current output/answer
yCopy current input plus output
cCopy bare command when available
:Start a temporary line filter for the next copy
v in ContentStart visual text selection
tOpen current content in Vim-style full view
?Open help

Context-aware launchers such as the Windows hotkey and VS Code extension can open a current-workspace picker directly.

Search current-workspace agent sessions and terminal context with target-first search:

Terminal window
sivtr search agent --match "panic" --format timeline
sivtr search agent --match "workspace picker" --in title --format compact
sivtr search codex --match "sivtr" --in session --format md
sivtr search terminal --match "build error" --format json --limit 20

Use JSON refs with sivtr show. These exact refs are the unit you can hand back to yourself, another terminal workflow, or an agent prompt:

Terminal window
sivtr show claude/<session>/<dialogue>
sivtr show pi/<session>/<dialogue>/<line>

Codex supports exporting local rollout JSONL files into a shared read-only tree:

Terminal window
sivtr codex export --dest /srv/sivtr/root-codex --watch

Then add the exported sessions directory to another account’s config:

[codex]
session_dirs = ["/srv/sivtr/root-codex/sessions"]

Shared/mirrored session trees only participate in explicit picker browsing. Implicit current-session lookup stays local so another account’s exported history does not override your active workflow.

On macOS, /Users/Shared/sivtr/root-codex is a good shared location between local accounts:

Terminal window
sivtr codex export --dest /Users/Shared/sivtr/root-codex --watch
[codex]
session_dirs = ["/Users/Shared/sivtr/root-codex/sessions"]