Sessions

Availability

The Sessions tab and Session Dock are available on Pro and Trial tiers.

What You Can Do

• View sessions by workspace using Active and All views.
• Focus a running session instantly.
• Resume/open eligible inactive sessions.
• Delete an individual session entry.
• Clear all active sessions when you need a reset.
• Sync worktree sessions back to your local repo.

Session Actions

Focus (active sessions)

Use Focus to jump straight back to an active session.

Resume / Open App (inactive sessions)

For supported agents, Resume copies a safe resume command and opens the related app. For manual-only flows, you will see Open App.

Delete (single session)

Use Delete to remove one session entry from the list.

Clear Sessions vs Cleanup Settings

Clear sessions

• The Clear sessions action clears all currently active sessions after confirmation.
• This is the fastest way to reset active tracking when your list is noisy.

Cleanup settings

Open the cleanup settings panel in Sessions to configure:

• Max age (hours)
• Min to keep
• Auto-cleanup on app startup

Cleanup is conservative by design and avoids removing your most recent context.

Sessions Tab vs Session Dock

Sessions Tab (App)

• Best for structured browsing, session history, and sync actions.
• Sessions are grouped by repository/monorepo, worktree, and branches.
• Use this view when you want to review broader session state before taking action.

Session Dock

• Best for fast context switching while you are actively working.
• Use this when you want to jump quickly between active sessions.

Tray Shortcuts for Sessions

The menu bar tray also exposes session controls:

• Recent Sessions submenu (up to five active sessions)
• Manage Sessions… (opens the Sessions tab)
• Clear All Sessions

See Menu Bar & Tray for the full tray map.

Session Dock Modes

The Session Dock is designed for fast context switching while you are deep in work.

Active Hover Mode

• Hover a session to preview and queue focus.
• Click a session to jump directly into that agent context.
• Dot states help you spot queued/unviewed work at a glance.

Expanded Mode

• Expand the dock when you need richer session context and actions.
• Great for scanning many concurrent agents before choosing where to jump.

Keyboard Mode

Use your configured dock shortcut to enter keyboard mode, then:

• Tab / Shift+Tab: switch groups
• HJKL or arrow keys: move selection
• 1-6: quick select visible sessions
• Enter: focus selected session
• Esc: close keyboard mode

claude-code — ~/projects/b2v

➜ ~/projects/b2v claude code

Reading context from local files...

╭─ claude
╰─> I've analyzed the session dock requirements. Should I proceed?

gemini-2.0 — ~/docs/arch

➜ ~/docs/arch gemini plan

Gemini is thinking...

Generating architectural diagrams...

Cursor — lib/auth.ts

1export async function validateSession(token: string) {

2 const session = await db.query.sessions.findFirst({

3 where: eq(sessions.token, token)

4 });

5

6 // Session validation logic...

Try me!

Everyday Workflow

1. Open the app Sessions tab.
2. Use Active to jump to currently running agents.
3. Use All to find previous sessions, resume, or clean up old entries.
4. Use Sync to Local Repo when worktree changes are ready.

Next Step

When agent work is ready, continue with Worktrees Sync.