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.
4.2 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.
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