Jason
a058ebeafc
Refresh the user manual to cover the v3.13.0 feature set so users can discover and correctly use new functionality without cross-referencing the release notes. All three language versions are updated line-by-line symmetric. Highlights: - Lightweight Mode: tray-only running state added in 1.5-settings, with a comparison table against "Minimize to tray" and a new OAuth Auth Center (Beta) section - Quota & Balance display restructured in 2.5-usage-query: split into auto-query (Claude/Codex/Gemini official, Copilot, Codex OAuth) vs manual-enable (Token Plan, third-party balances). Explains why manual enabling is required: the same API URL may expose both plan-quota and balance query modes - Codex OAuth reverse proxy: full usage guide in 2.1-add with two entry points (Add Provider panel / OAuth Auth Center), Device Code login flow, token auto-refresh, multi-account management, quota display, common failures, and risk notice - Full URL Endpoint Mode: new advanced option in 2.1-add - Per-app tray submenus: 2.2-switch refactored to reflect the 5-app submenu structure and cross-link to Lightweight Mode - Skills workflow: remove obsolete "automatic update not supported" section in 3.3-skills, add SHA-256 update detection, single/batch update, storage location switch, and skills.sh registry search - Directory picker for Claude terminal resume in 3.4-sessions - Usage stats in 4.4-usage: document the new CLI session log source (no proxy required) and per-app filtering for Claude/Codex/Gemini; note CNY->USD pricing corrections and MiniMax quota fixes - Stream Check coverage extended to OpenCode/OpenClaw in 4.5-model-test - New FAQs in 5.2-questions: quota visibility (auto vs manual), Codex OAuth risks and login flow, deep link wake in Lightweight Mode - v3.13.0 highlights navigation block added to top-level README and each per-language README; version bumped to v3.13.0 / 2026-04-08
5.1 KiB
3.4 Session Manager
The Session Manager lets you browse, search, and manage conversation sessions from all supported CLI tools in one place.
Supported Applications
| Application | Session Storage Location |
|---|---|
| Claude Code | ~/.cache/claude/projects/*.jsonl |
| Codex | Codex config sessions directory |
| OpenCode | ~/.local/share/opencode/ (JSON or SQLite) |
| OpenClaw | ~/.openclaw/agents/<agent>/sessions/*.jsonl |
| Gemini CLI | ~/.cache/gemini/tmp/<project_hash>/chats/ |
Opening the Session Manager
Click the Sessions button in the main navigation bar toolbar.
Note
: The Sessions button is visible for all five supported applications.
Interface Layout
The Session Manager uses a two-column layout:
- Left panel: Session list with search and filter toolbar
- Right panel: Selected session details with conversation history
Session List (Left Panel)
Each session entry displays:
- Provider icon
- Session title
- Last active time (relative format, e.g., "5 min ago")
Session Details (Right Panel)
When a session is selected, the right panel shows:
- Title: Derived from session title, project directory name, or session ID
- Last active date/time: Full timestamp
- Project directory: Clickable to copy full path (shows basename with tooltip for full path)
- Resume command: Displayed in monospace style when available
- Conversation history: Full message transcript
Search & Filtering
Full-Text Search
Use the search box at the top of the left panel to search across:
- Session ID
- Title
- Summary
- Project directory
- Source file path
The search supports prefix matching and filters results in real-time. Press Esc to clear the search.
Provider Filtering
Click the provider filter dropdown (top-right of left panel) to filter by application:
- All — Show sessions from all providers
- Claude Code
- Codex
- OpenCode
- OpenClaw
- Gemini CLI
The filter can be combined with search.
Refresh
Click the refresh button (circular arrow icon) to re-scan all provider directories for new or deleted sessions.
Session Actions
Resume Session
Click the Resume button (play icon) on a selected session to continue the conversation.
On macOS:
- CC Switch launches your preferred terminal with the resume command
- The terminal opens in the session's project directory
- If terminal launch fails, the command is copied to your clipboard instead
Supported terminals (macOS): Terminal.app, iTerm2, Ghostty, Kitty, WezTerm, Alacritty
On other platforms:
- The resume command is copied to your clipboard
- Paste it into your terminal to resume
The Resume button is disabled if the session has no resume command available.
Directory Picker (Claude Terminal Resume)
Starting from v3.13.0, Claude sessions show a directory picker before resume, allowing you to override the default project directory. Useful when:
- Project was moved: The original project directory was moved or renamed
- Broken symlink: The original path is no longer accessible
- Temporary directory change: You want to continue the conversation in a different working directory
How to use:
- Click the Resume button on a Claude session
- In the popup directory picker, confirm the default directory or choose a new one
- CC Switch launches the Claude terminal session in the selected directory
Note
: Codex / Gemini / OpenCode / OpenClaw session resume flows do not yet include the directory picker and still use the session's original project directory.
Delete Session
Click the Delete button (trash icon) to permanently remove a session file. A confirmation dialog is shown before deletion.
Sessions without a local source path (e.g., immutable sessions) cannot be deleted.
Batch Operations
For managing multiple sessions at once:
- Click the Batch Mode button (checkbox icon) in the left panel toolbar
- Select sessions using the checkboxes that appear
- Use Select All to select all filtered results, or Clear to deselect
- Click Batch Delete (red trash icon) to delete all selected sessions
A confirmation dialog shows the count before deletion. Results report the number of successful deletions and any failures.
Conversation History
Message Display
Messages are color-coded by role:
- User messages: Green, left-aligned
- AI (Assistant) messages: Blue, right-aligned
- System messages: Amber
- Tool messages: Purple
Table of Contents
For longer conversations, a Table of Contents is available:
- Desktop (XL+ screens): Sidebar on the right showing user message previews
- Smaller screens: Floating button (list icon) at bottom-right that opens a dialog
Click any entry to scroll to that message, which is briefly highlighted.
Tips
- Sessions are sorted by last activity time (newest first)
- The session count badge updates as you search and filter
- OpenCode sessions may come from both JSON files and SQLite database — duplicates are automatically deduplicated