Skip to content
peek
Esc
navigateopen⌘Jpreview
On this page

Adapters

The session sources peek reads from, and how to add your own.

Adapters are how peek discovers and reads sessions from different agent tools. Each one knows where a given tool stores its transcripts.

Built-in

Adapter Reads from
claude-code ~/.claude/projects/*/<uuid>.jsonl
codex ~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-*.jsonl
copilot-cli ~/.copilot/session-state/*
gemini ~/.gemini/tmp/<project>/chats/session-*.json
goose ~/.local/share/goose/sessions/sessions.db
opencode ~/.local/share/opencode/storage/{session,message,part}
screen GNU screen scrollback via hardcopy -h
tmux tmux pane output

External adapters

Set AGENT_PEEK_ADAPTER_PATH to a colon-separated list of adapter modules. Each module’s default export must implement the Adapter interface from agent-peek/adapter.

export AGENT_PEEK_ADAPTER_PATH="/path/to/my-adapter.js:/path/to/another.js"

Was this page helpful?