A VS Code extension to browse, search, pin, promote (copy to today), and delete local Codex CLI session history stored under ~/.codex/sessions (or a custom root).
Latest release: 0.1.3 (2026-02-09).
Features
Three views: Pinned, History, and Search
History tree view (year/month/day) with optional filters (date scope and project/CWD)
One-click "Filter by Current Project" action in the History view header (toggle on/off)
Chat-like viewer (Webview) with Markdown rendering, copy actions, and "Open as Markdown"
Time zone-aware timestamps (chat view and transcripts)
Language-aware command labels (Japanese/English) based on codexHistoryViewer.ui.language
Open any session as a Markdown transcript (easy to search, share, and export)
Copy Prompt Excerpt: copy a compact excerpt to the clipboard for handoff to OpenAI Codex
Full-text search across sessions (cancellable, configurable max results, optional case sensitivity)
Search scope follows the active History filters (date scope and project/CWD)
Promote: copy a past session into "today" without modifying the original file
Safe deletion: moves files to the OS trash/recycle bin by default (falls back to an internal quarantine folder if trash fails)
Multi-select support for open/pin/promote/delete
Drag & drop pinning: drag sessions into Pinned to pin
Quick start
Open the Activity Bar and select Codex History.
Browse sessions under History (optionally use Filter History... or Filter by Current Project).
Select a session to open a preview, or run Open Session (Chat) to open it normally.
Use the view toolbar or context menu to pin/unpin, promote, delete, open as Markdown, or copy a prompt excerpt.
Run Search... to search across sessions; results appear under Search.
Commands
Codex History Viewer: Refresh
Codex History Viewer: Search...
Codex History Viewer: Filter History...
Codex History Viewer: Filter by Current Project
Codex History Viewer: Clear History Filters
Codex History Viewer: Open Session (Chat)
Codex History Viewer: Open Session (Markdown)
Codex History Viewer: Copy Prompt Excerpt
Codex History Viewer: Open Settings
Codex History Viewer: Promote to Today (Copy)
Codex History Viewer: Pin / Unpin
Codex History Viewer: Delete
Codex History Viewer: Rebuild Cache
Codex History Viewer: Debug Info (Copy)
Configuration
codexHistoryViewer.sessionsRoot: Root folder of Codex sessions. Leave empty to use the default (~/.codex/sessions).
codexHistoryViewer.preview.openOnSelection: Open a preview when selecting an item
codexHistoryViewer.preview.maxMessages: Max number of user/assistant messages to include in tooltips and quick previews
codexHistoryViewer.search.maxResults: Max number of search hits to collect
codexHistoryViewer.search.caseSensitive: Whether search is case-sensitive
codexHistoryViewer.delete.useTrash: When deleting, move files to the OS trash/recycle bin (recommended)
codexHistoryViewer.ui.language: UI language for this extension (auto / en / ja). This setting also affects timestamps: ja uses Asia/Tokyo (JST), while auto/en use your system time zone (falls back to UTC if unavailable).
codexHistoryViewer.ui.alwaysShowHeaderActions: Always show view header action icons (enables VS Code setting workbench.view.alwaysShowHeaderActions)
What's New in 0.1.3
Added Filter by Current Project to quickly narrow History to the active workspace.
Improved current-project matching to prefer workspace descendants and the nearest ancestor when needed.
Added a user-facing message when this filter is invoked without an open folder/workspace.
This extension reads local session files and renders them inside VS Code. It does not implement any network communication and does not send session content anywhere.
If you use Copy Prompt Excerpt, this extension copies a compact session excerpt to your clipboard. Data is only sent externally if you paste it into another tool or extension.
When you open a session as a Markdown transcript, the generated transcript includes local paths (e.g., the session file path and CWD). Review before sharing.
