Codex Session History

Overview

Use this skill to enumerate local Codex sessions and map each session to its id, title, project, and workspace path.
Prefer the bundled script so the output stays consistent and works even when session_index.jsonl is incomplete.

Workflow

1. 1. Run the script to collect unarchived sessions by default.
2. Use session_meta.payload.id as the canonical session id.
3. Use session_meta.payload.cwd as the workspace anchor.
4. Derive the project from the Git root when possible; otherwise fall back to cwd.
5. Use session_index.jsonl only as enrichment for thread_name and updated_at.
6. Convert stored UTC timestamps into local time before display and time-window filtering.
7. If no thread_name is available, fall back to the first user message summary.

Commands

List recent sessions:

CODEBLOCK0

List active and archived sessions together:

CODEBLOCK1

List more rows:

CODEBLOCK2

Filter by project:

CODEBLOCK3

Filter by a local time window on today's date:

CODEBLOCK4

Filter by a local time window on a specific date:

CODEBLOCK5

Inspect one session id:

CODEBLOCK6

Only show archived sessions:

CODEBLOCK7

Return JSON:

CODEBLOCK8

Output

Default table columns:

• - INLINECODE8
• INLINECODE9
• INLINECODE10
• INLINECODE11
• INLINECODE12
• INLINECODE13

With --details, also show:

• - INLINECODE15
• INLINECODE16
• INLINECODE17
• INLINECODE18
• INLINECODE19
• INLINECODE20
• INLINECODE21

Notes

• - Prefer the script over ad hoc rg because session_index.jsonl may be incomplete.
• Treat the session file itself as the source of truth for id and cwd.
• INLINECODE26 and updated_at are displayed in local time, not raw Z time.
• Time-window filters match actual session events inside the requested interval, not only broad session span coverage.
• If a workspace no longer exists on disk, still report the recorded cwd.
• When the user only asks for "有哪些会话、id 是什么、属于哪个项目", the default table is enough.

Script

Use:

CODEBLOCK9