Codex Chat Session Manager

A standalone VS Code extension project that helps you manage local chat sessions by:

• Scanning local chat session JSONL files under VS Code user storage
• Showing sessions in a dedicated Activity Bar panel
• Saving safe aliases in extension state (globalState)
• Optionally writing aliases back into session files as customTitle events (off by default)

Sidebar Workflow

1. Open Session Manager in the Activity Bar.
2. Use Local Chat Sessions tree to browse recent sessions.
3. Click a session to open quick actions, or right-click for context actions.

Available item actions:

• Rename alias
• Clear alias
• Apply alias to local file
• Open session file
• Reveal in OS
• Copy file path

The view title has:

• Refresh Sessions
• Open Session Storage Folder

Command Palette Commands

• Codex Session Manager: Browse Sessions
• Codex Session Manager: Session Actions
• Codex Session Manager: Rename Session Alias
• Codex Session Manager: Clear Session Alias
• Codex Session Manager: Apply Alias to Local Session File
• Codex Session Manager: Open Session File
• Codex Session Manager: Reveal Session File
• Codex Session Manager: Copy Session File Path
• Codex Session Manager: Refresh Sessions
• Codex Session Manager: Open Session Storage Folder

Safety Model

• Default behavior is alias overlay only (no file mutation)
• File write-back is controlled by setting: codexSessionManager.enableFileWriteback
• Write-back creates a timestamped .bak-* backup before appending an event line

Run Locally

npm install
npm run compile

Press F5 in VS Code to launch an Extension Development Host.

Storage Paths

This project reads local session files from:

• %APPDATA%\\Code\\User\\workspaceStorage\\*\\chatSessions\\*.jsonl
• %APPDATA%\\Code\\User\\globalStorage\\emptyWindowChatSessions\\*.jsonl

On non-Windows platforms, equivalent Code user directories are used.