What problem does it solve? Codex stores session metadata across state_*.sqlite databases and a session_index.jsonl file, making it hard to locate a past conversation by provider, time, or content. This Skill queries those local stores so you can find, filter, and resume any saved Codex session without manually digging through database files. ## Core Features & Use Cases - Flexible Search and Filtering: Query sessions by id, provider, source, cwd, thread name, title, or preview text, with time-range filters supporting ISO dates, epochs, and relative values like 7d or 12h. - Multiple Output Views: Render results as detailed cards, a compact table, or JSON for piping into other tools, with optional provider/source statistics. - Ready-to-Resume Output: Each result includes a copyable codex resume <session_id> command so you can immediately continue a located session. - Use Case: You remember discussing a provider configuration last week but not the session id. Run a query for "provider" filtered to the last 7 days, scan the previews, and resume the matching session directly. ## Quick Start Ask the assistant to list your recent Codex sessions or search session history for a keyword, provider, or date range using the codex-session-history skill.
