Sessions
The Sessions view provides access to your conversation history and image generation sessions.
Overview
The Sessions view enables:
- Browse all sessions with summary information
- View session details including all images
- Continue conversations from any session
- Track session activity over time
Sessions List
List View
┌─────────────────────────────────────────────────────────────┐
│ Sessions [🔍 Search] [Filter] │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 📁 sess_abc123xyz Active │ │
│ │ Started: Jan 15, 2024 14:30 │ │
│ │ Images: 12 • Edits: 8 • Last: 5 minutes ago │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 📁 product-marketing-campaign Idle │ │
│ │ Started: Jan 14, 2024 10:15 │ │
│ │ Images: 24 • Edits: 6 • Last: 1 day ago │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 📁 character-scenes-luna Idle │ │
│ │ Started: Jan 12, 2024 09:00 │ │
│ │ Images: 18 • Edits: 12 • Last: 3 days ago │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ [Load More Sessions...] │
│ │
└─────────────────────────────────────────────────────────────┘Session Status
| Status | Description |
|---|---|
| Active | Recent activity (< 1 hour) |
| Idle | No recent activity |
| Expired | Inactive > 24 hours |
Filtering Sessions
┌─────────────────────────────────────────────────────┐
│ Filters [×] │
├─────────────────────────────────────────────────────┤
│ Status │
│ ○ All ● Active ○ Idle ○ Expired │
├─────────────────────────────────────────────────────┤
│ Date Range │
│ From: [Jan 1, 2024 ] │
│ To: [Jan 31, 2024] │
├─────────────────────────────────────────────────────┤
│ Minimum Images │
│ [5 ] or more images │
├─────────────────────────────────────────────────────┤
│ [Apply] [Clear All] │
└─────────────────────────────────────────────────────┘Sorting
| Sort Option | Description |
|---|---|
| Most Recent | Last activity (default) |
| Oldest First | Chronological |
| Most Images | By image count |
| Most Edits | By edit count |
Session Detail View
Click a session to see full details:
┌─────────────────────────────────────────────────────────────┐
│ Session: sess_abc123xyz [Continue] │
├──────────────────────────┬──────────────────────────────────┤
│ Session Info │ Images │
│ │ │
│ ID: sess_abc123xyz │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │
│ Status: Active │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │
│ Created: Jan 15, 14:30 │ │ #342 │ │ #343 │ │ #344 │ │ #345 │ │
│ Last Activity: 5m ago │ └─────┘ └─────┘ └─────┘ └─────┘ │
│ │ │
│ Statistics │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │
│ ───────────── │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │
│ Total Images: 12 │ │ #346 │ │ #347 │ │ #348 │ │ #349 │ │
│ Generations: 4 │ └─────┘ └─────┘ └─────┘ └─────┘ │
│ Edits: 8 │ │
│ Characters Used: 2 │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │
│ Products Used: 0 │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │
│ Storage: 28.4 MB │ │ #350 │ │ #351 │ │ #352 │ │ #353 │ │
│ │ └─────┘ └─────┘ └─────┘ └─────┘ │
│ Last Image │ │
│ ───────────── │ Showing 12 of 12 images │
│ ID: #353 │ │
│ "add more clouds" │ │
│ │ │
└──────────────────────────┴──────────────────────────────────┘Split Pane View
The session detail uses a split pane:
- Left pane: Session metadata and stats
- Right pane: Image grid with chronological order
Session Statistics
| Metric | Description |
|---|---|
| Total Images | All images in session |
| Generations | New images created |
| Edits | Images edited |
| Characters Used | Unique characters |
| Products Used | Unique products |
| Storage | Total storage used |
Image Timeline
View images in chronological order:
┌─────────────────────────────────────────────────────────────┐
│ Session Timeline │
├─────────────────────────────────────────────────────────────┤
│ │
│ 14:30 ─┬─ 🖼️ #342 Generated │
│ │ "sunset over mountains" │
│ │ │
│ 14:32 ─┼─ 🖼️ #343 Edited from #342 │
│ │ "add dramatic clouds" │
│ │ │
│ 14:35 ─┼─ 🖼️ #344 Edited from #343 │
│ │ "make colors more vibrant" │
│ │ │
│ 14:40 ─┼─ 🖼️ #345 Generated │
│ │ "Luna in a forest" (Character) │
│ │ │
│ 14:42 ─┴─ 🖼️ #346 Edited from #345 │
│ "add magical sparkles" │
│ │
└─────────────────────────────────────────────────────────────┘Edit Chains
See how images evolved through edits:
┌─────────────────────────────────────────────────────────────┐
│ Edit Chain │
├─────────────────────────────────────────────────────────────┤
│ │
│ 🖼️ #342 (Original) │
│ │ │
│ └──► 🖼️ #343 │
│ │ │
│ └──► 🖼️ #344 (Current) │
│ │
│ 🖼️ #345 (Original with Character) │
│ │ │
│ └──► 🖼️ #346 (Current) │
│ │
└─────────────────────────────────────────────────────────────┘Session Actions
Continue Session
Resume working in a session:
┌─────────────────────────────────────────────────────┐
│ Continue Session? │
├─────────────────────────────────────────────────────┤
│ This will set your working context to: │
│ │
│ Session: sess_abc123xyz │
│ Last Image: #353 │
│ │
│ Using "continue editing" will edit image #353 │
│ │
│ [Cancel] [Continue Session] │
└─────────────────────────────────────────────────────┘Export Session
Download all session images:
┌─────────────────────────────────────────────────────┐
│ Export Session │
├─────────────────────────────────────────────────────┤
│ Session: sess_abc123xyz (12 images) │
│ │
│ Include: │
│ ☑ All images (original quality) │
│ ☑ Image metadata (JSON) │
│ ☐ Thumbnails │
│ ☑ Session summary │
│ │
│ Format: [ZIP Archive ▼] │
│ │
│ [Export Session] │
└─────────────────────────────────────────────────────┘Delete Session Images
Remove all images from a session:
WARNING
This action is permanent and cannot be undone.
┌─────────────────────────────────────────────────────┐
│ Delete Session Images? │
├─────────────────────────────────────────────────────┤
│ Are you sure you want to delete all images in │
│ session "sess_abc123xyz"? │
│ │
│ This will permanently delete: │
│ • 12 images │
│ • 28.4 MB of storage │
│ │
│ The session record will be kept for reference. │
│ │
│ [Cancel] [Delete Images] │
└─────────────────────────────────────────────────────┘Custom Session IDs
Using Custom IDs
Organize work with meaningful session IDs:
┌─────────────────────────────────────────────────────┐
│ Sessions with Custom IDs │
├─────────────────────────────────────────────────────┤
│ │
│ 📁 book-cover-fantasy-2024 12 images │
│ 📁 product-campaign-summer 24 images │
│ 📁 character-luna-scenes 18 images │
│ 📁 client-acme-marketing 36 images │
│ │
└─────────────────────────────────────────────────────┘Setting Custom Session ID
When using MCP or API:
json
{
"tool": "generate_image",
"params": {
"prompt": "a sunset",
"session_id": "project-name-2024"
}
}Session Search
Search across all sessions:
┌─────────────────────────────────────────────────────┐
│ 🔍 Search sessions │
│ ┌─────────────────────────────────────────────────┐ │
│ │ luna │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Results: │
│ • character-luna-scenes (18 images with "luna") │
│ • sess_def456 (3 images with "luna") │
│ │
└─────────────────────────────────────────────────────┘Session Lifecycle
Automatic Sessions
Sessions are created automatically:
- First image generation creates session
- Subsequent operations use same session
last_image_idtracks current imagecontinue_editinguses this context
Session Expiration
┌─────────────────────────────────────────────────────┐
│ Session Expiration │
├─────────────────────────────────────────────────────┤
│ │
│ Active ──► Idle ──► Expired │
│ (< 1hr) (1-24hr) (> 24hr) │
│ │
│ After expiration: │
│ • Session context (last_image_id) is lost │
│ • Images remain accessible │
│ • Session can be "continued" to restore context │
│ │
└─────────────────────────────────────────────────────┘Keyboard Shortcuts
| Shortcut | Action |
|---|---|
↑ / ↓ | Navigate sessions |
Enter | Open selected session |
C | Continue selected session |
E | Export selected session |
Esc | Close detail view |
API Access
Sessions are also accessible via:
- MCP Tools:
get_session_history - REST API:
GET /api/sessions,GET /api/sessions/:id
See Sessions API → for details.
Best Practices
Organizing Work
- Use custom session IDs for projects
- One session per project for organization
- Regular exports for backup
- Clean up old sessions periodically
Session Naming
Use descriptive, searchable names:
✅ Good:
• client-acme-product-launch-2024
• book-cover-fantasy-draft-v2
• character-luna-forest-scenes
❌ Bad:
• test1
• abc123
• sessionStorage Management
Monitor session storage:
┌─────────────────────────────────────────────────────┐
│ Sessions by Storage │
├─────────────────────────────────────────────────────┤
│ 1. product-campaign-summer ████████████ 156 MB │
│ 2. character-luna-scenes ██████████ 128 MB │
│ 3. book-cover-fantasy ████████ 96 MB │
│ 4. client-acme-marketing ██████ 72 MB │
│ │
│ Total: 452 MB of 1 GB quota (45.2%) │
└─────────────────────────────────────────────────────┘