mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-08-02 02:05:57 +08:00
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
148 lines
5.1 KiB
Markdown
148 lines
5.1 KiB
Markdown
# 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**:
|
|
|
|
1. Click the **Resume** button on a Claude session
|
|
2. In the popup directory picker, confirm the default directory or choose a new one
|
|
3. 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:
|
|
|
|
1. Click the **Batch Mode** button (checkbox icon) in the left panel toolbar
|
|
2. Select sessions using the checkboxes that appear
|
|
3. Use **Select All** to select all filtered results, or **Clear** to deselect
|
|
4. 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
|