Codex Session Finder

Find the relevant local Codex session and return the session coordinates. This skill locates the thread; it does not summarize, judge, or extract the important parts of the conversation unless the user explicitly asks for inspection.

How Codex Sessions Work

Codex keeps local session state under the user's Codex home directory.

• state_5.sqlite stores thread metadata, including id, title, workspace path, timestamps, archive state, branch, commit, tokens_used, and rollout path.
• session_index.jsonl is a lightweight session index. It is useful for lookup, but SQLite is the stronger source of truth when both exist.
• sessions/ contains current rollout files.
• archived_sessions/ contains archived rollout files.
• Rollout files are JSONL event streams. Use them only when metadata is not enough.

Inputs

Accept any of these: