Frontmatter:
title: Workflow Views
description: Understand Kepler's three workflow views — List, Kanban, and Console — and when to use each one.
taxonomy:
category: kepler
Purpose: Explain the three views (List, Kanban, Console), their layouts, controls, and when to reach for each one.
Sections to include:
Choosing a view
Three views accessible from the top navigation: List, Kanban, Console.
Quick guide: List for deep focus on one worktree; Kanban for tracking flow across all Tasks; Console for supervising many agents at once.
List view
Layout: Task/worktree sidebar (left), diff or session panel (center), git history panel (right).
Left sidebar:
"Tasks N" header with total count. "By task" grouping: Tasks at top level, worktrees nested below showing branch and repo. Filter/search bar.
Dot indicators on worktrees = Needs Attention.
Click a worktree to open its diff and history.
Breadcrumb: Task name → worktree name.
Center panel (diff view):
File path with +/- stats. Stacked/Split toggle. Collapsed unmodified sections (click to expand). Red/green lines.
"Back to session" (×) to return to the agent session.
Right panel: "Working changes" header; recent commit list; click any commit for full detail (title, description, author, email, timestamp, hash, branch tags, files changed with +/- and M/A/D).
Push / Pull / Fetch buttons top right.
"Create command..." dropdown (top nav): flag for engineering — likely a command palette or saved command template.
Kanban view
Shows all worktrees on a board across columns: Exploration, In Development, In Review, Done. Column counts show worktrees per stage.
When to use: tracking flow, spotting where work is stuck, overview of all Tasks.
Card anatomy: branch name | external link (↗) | Task name | repo name | session status badge | "Open chat" button | archive icon | agent indicator (agent initial, last context snippet, time since activity) | "+ New session" button.
"No sessions yet" state: worktree exists but no session has been started. "+ New session" is the primary action.
Search: by branch or task name.
Filters:
Status: Needs Attention, Active, Idle, Errored, Inactive. Checkboxes; all on by default.
Repos: filter to specific repos.
Tasks: filter to specific Tasks by name. "No task" option shows worktrees not associated with any Task.
Agent: filter by agent runtime (Claude Code, Codex, etc.).
Sort: e.g., Newest first.
Console view
Shows all active agent sessions side by side in columns, with a session count in the Task header.
When to use: supervising many agents at once, sending follow-up instructions across sessions.
Session column header: session name (truncated), repo name, controls (↗ external link, expand, +, ×), status bar with keyboard shortcut (⌨1, ⌨2, ⌨3), status badge, repo, Task name, time ago.
Keyboard shortcuts: ⌨1/2/3 for quick navigation between sessions. Confirm exact shortcut format with engineering.
CHANGES section (collapsible):
"CHANGES N" header where N is total file count.
Expanded: STAGED and UNSTAGED sub-sections, each listing files with path and M/A/D badge.
Provides a staging overview without leaving Console view. Full diff and staging controls are in List view.
Conversation format:
User messages as chat bubbles.
Agent responses as formatted markdown.
Tool calls as collapsible rows with Completed badge or error state.
Input bar: mic (🎤), attachment, Mode, Model (Default recommended), Effort, "20%" indicator (confirm with engineering), send (↑). Mode/Model/Effort changeable per message.
Disconnected sessions: session lost connection to runtime. Document cause and how to reconnect.
Notifications: toast appears when a Task completes or needs attention with a View button.
Frontmatter:
title: Workflow Views
description: Understand Kepler's three workflow views — List, Kanban, and Console — and when to use each one.
taxonomy:
category: kepler
Purpose: Explain the three views (List, Kanban, Console), their layouts, controls, and when to reach for each one.
Sections to include:
Choosing a view
Three views accessible from the top navigation: List, Kanban, Console.
Quick guide: List for deep focus on one worktree; Kanban for tracking flow across all Tasks; Console for supervising many agents at once.
List view
Layout: Task/worktree sidebar (left), diff or session panel (center), git history panel (right).
Left sidebar:
"Tasks N" header with total count. "By task" grouping: Tasks at top level, worktrees nested below showing branch and repo. Filter/search bar.
Dot indicators on worktrees = Needs Attention.
Click a worktree to open its diff and history.
Breadcrumb: Task name → worktree name.
Center panel (diff view):
File path with +/- stats. Stacked/Split toggle. Collapsed unmodified sections (click to expand). Red/green lines.
"Back to session" (×) to return to the agent session.
Right panel: "Working changes" header; recent commit list; click any commit for full detail (title, description, author, email, timestamp, hash, branch tags, files changed with +/- and M/A/D).
Push / Pull / Fetch buttons top right.
"Create command..." dropdown (top nav): flag for engineering — likely a command palette or saved command template.
Kanban view
Shows all worktrees on a board across columns: Exploration, In Development, In Review, Done. Column counts show worktrees per stage.
When to use: tracking flow, spotting where work is stuck, overview of all Tasks.
Card anatomy: branch name | external link (↗) | Task name | repo name | session status badge | "Open chat" button | archive icon | agent indicator (agent initial, last context snippet, time since activity) | "+ New session" button.
"No sessions yet" state: worktree exists but no session has been started. "+ New session" is the primary action.
Search: by branch or task name.
Filters:
Status: Needs Attention, Active, Idle, Errored, Inactive. Checkboxes; all on by default.
Repos: filter to specific repos.
Tasks: filter to specific Tasks by name. "No task" option shows worktrees not associated with any Task.
Agent: filter by agent runtime (Claude Code, Codex, etc.).
Sort: e.g., Newest first.
Console view
Shows all active agent sessions side by side in columns, with a session count in the Task header.
When to use: supervising many agents at once, sending follow-up instructions across sessions.
Session column header: session name (truncated), repo name, controls (↗ external link, expand, +, ×), status bar with keyboard shortcut (⌨1, ⌨2, ⌨3), status badge, repo, Task name, time ago.
Keyboard shortcuts: ⌨1/2/3 for quick navigation between sessions. Confirm exact shortcut format with engineering.
CHANGES section (collapsible):
"CHANGES N" header where N is total file count.
Expanded: STAGED and UNSTAGED sub-sections, each listing files with path and M/A/D badge.
Provides a staging overview without leaving Console view. Full diff and staging controls are in List view.
Conversation format:
User messages as chat bubbles.
Agent responses as formatted markdown.
Tool calls as collapsible rows with Completed badge or error state.
Input bar: mic (🎤), attachment, Mode, Model (Default recommended), Effort, "20%" indicator (confirm with engineering), send (↑). Mode/Model/Effort changeable per message.
Disconnected sessions: session lost connection to runtime. Document cause and how to reconnect.
Notifications: toast appears when a Task completes or needs attention with a View button.