mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-08-02 18:41:35 +08:00
Jason
d9c0e4c452
Add documentation for features introduced since v3.12.0: New docs: - 3.4 Session Manager: browse, search, resume, delete sessions - 3.5 Workspace & Daily Memory: OpenClaw workspace file editing Updated docs: - Add Lightweight Mode to interface overview and FAQ - Add tray submenu structure (providers grouped by app) - Add API Format selection (Anthropic/OpenAI Chat/OpenAI Responses) - Add Auto-Fetch Models button documentation - Add Claude Common Config quick toggles - Add Codex 1M Context Window toggle - Add Skill backup/restore lifecycle - Expand Backup Management panel documentation - Update WebDAV sync to v2 protocol with dual-layer versioning - Add OpenCode/OpenClaw to quickstart activation table - Update README version to v3.12.3 All changes synced across en, zh, and ja locales.
132 lines
4.2 KiB
Markdown
132 lines
4.2 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.
|
|
|
|
### 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
|