claude-code-ultimate-guide/examples/skills/ccboard/commands/sessions.md
Florian BRUNIAUX 52d76411e3 feat(skills): publish 5 new skills to SkillHub
Add skill-creator, landing-page-generator, ccboard, guide-recap,
and release-notes-generator with genericized content (no personal
refs, FR→EN translation, placeholder URLs/paths).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 21:10:09 +01:00

90 lines
2 KiB
Markdown

---
name: sessions
description: Browse Claude Code sessions history
category: exploration
---
# Sessions Browser Command
Launch ccboard and jump directly to the sessions exploration tab.
## Features
- **Project Tree**: Navigate 33+ projects with nested structure
- **Session List**: 1.2K+ sessions with metadata
- **Search**: Filter sessions by project, message, or model (press `/`)
- **Session Details**:
- Timestamps (start, end, duration)
- Token usage breakdown
- Models used
- First message preview
- **File Operations**:
- `e` : Open session JSONL in editor
- `o` : Reveal session file in finder
## Usage
```bash
# Open sessions tab directly
/sessions
# Alternative: run with tab argument
ccboard --tab sessions
```
## Sessions Tab Navigation
- `←/→` : Switch between project tree and session list
- `↑/↓` : Navigate items
- `Enter` : View session details
- `/` : Open search input
- `e` : Edit selected session JSONL file
- `o` : Reveal session file
## Session Metadata
Each session shows:
- **ID**: Unique session identifier
- **Started**: First message timestamp
- **Duration**: Total conversation time
- **Messages**: Message count
- **Tokens**: Total tokens used
- **Models**: AI models used (e.g., opus-4.5, sonnet-4.5)
- **Preview**: First user message (200 chars)
## Search Examples
```
# Search by project name
/my-project
# Search by model
/opus
# Search by message content
/implement feature
```
## Requirements
ccboard must be installed. Run `/ccboard-install` if needed.
## Implementation
```bash
#!/bin/bash
# Check if ccboard is installed
if ! command -v ccboard &> /dev/null; then
echo "❌ ccboard is not installed"
echo "Run: /ccboard-install"
exit 1
fi
# Launch ccboard with Sessions tab (tab index 1, accessible with '2' key)
# For now, launch and user presses '2'
exec ccboard
```
**Note**: Currently launches ccboard in dashboard view. Press `2` to access Sessions tab.
Future version will support `ccboard --tab sessions` for direct access.