First Session

Launch cc-deck and explore the sidebar with your first Claude Code sessions.

Start Zellij with cc-deck

zellij --layout cc-deck

You should see a terminal pane on the right and the cc-deck sidebar on the left. The sidebar starts empty since no Claude Code sessions are running yet.

Start a Claude Code Session

In the terminal pane, start Claude Code:

claude

The sidebar picks up the new session within a few seconds. It shows the session name, working directory, and activity status.

Open More Sessions

Press n in navigation mode (or use your Zellij tab shortcut) to create a new tab. Start another Claude Code session there.

The sidebar now shows both sessions across tabs, each with its own status indicator.

Navigate Between Sessions

Press Alt+s to enter navigation mode. The sidebar highlights the current session with an amber cursor.

Use these keys to navigate:

Key Action

j / k

Move cursor down / up.

Enter

Switch to the selected session’s tab.

Esc

Cancel and return to the original tab.

g / G

Jump to first / last session.

/

Search sessions by name.

Press Alt+s again to cycle the cursor down without entering navigation mode first.

Smart Attend

Press Alt+a to jump to the session that most needs your attention.

The attend algorithm prioritizes:

  1. Sessions waiting for permission approval

  2. Sessions that just finished

  3. Idle sessions

Pressing Alt+a repeatedly cycles through all sessions that need attention, skipping sessions that are actively working.

Session Actions

While in navigation mode, you can act on the selected session:

Key Action

r

Rename the session.

p

Pause the session (excluded from attend cycling).

d

Delete the session.

?

Show all keyboard shortcuts.

What the Status Icons Mean

The sidebar shows icons next to each session:

Icon Meaning

●

Claude Code is actively working.

⚠

Session needs your input (permission request or notification).

○

Session is idle or just started.

✓

Session finished its task.

⏸

Session is paused (you toggled it with p).

Next Steps