Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/fulsomenko/kanban/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Kanban provides three different view modes to match your workflow. Switch between them at any time by pressing V. Each view mode offers a different way to visualize and organize your cards:
  • Flat List: Simple linear list with all card details
  • Grouped by Column: Cards organized under column headers
  • Kanban Board: Classic columnar layout for visual workflow
Press V to cycle through view modes. Your selection persists per board.

Flat List View

Overview

The flat list view displays all cards in a single vertical list with complete details visible at a glance.

Layout

┌─ Tasks ──────────────────────────────────────┐
│ [TODO] Card Title                            │
│   ✓ high priority • 3 pts • Due: 2024-12-31 │
│   Column: Todo                               │
│                                              │
│ [TODO] Another Card                          │
│   ✓ medium • 5 pts                           │
│   Column: In Progress                        │
│                                              │
│ [DONE] Completed Task                        │
│   ✓ 2 pts                                    │
│   Column: Done                               │
└──────────────────────────────────────────────┘

Features

  • All details visible: Title, status, priority, points, due date, column
  • Simple navigation: Use j/k to move up and down
  • Search-friendly: Easy to scan all cards at once
  • Sorting: Cards respect global sort order (by priority, points, date, etc.)

Best Use Cases

Search and Filter

Quickly scan all cards when searching or filtering by sprint.

Review and Planning

See complete card information for sprint planning or retrospectives.

Priority Management

View all cards sorted by priority or points to identify what needs attention.

Bulk Selection

Easily select multiple cards for bulk operations.
KeyAction
j / kMove up/down in list
ggJump to top
GJump to bottom
{ / }Jump half viewport up/down
EnterOpen card details

Grouped by Column View

Overview

The grouped view organizes cards under their respective column headers, providing structure while maintaining detailed information.

Layout

┌─ Tasks ──────────────────────────────────────┐
│                                              │
│ ▼ Todo (3 cards)                             │
│   [TODO] First card                          │
│     ✓ high • 3 pts                           │
│   [TODO] Second card                         │
│     ✓ medium • 5 pts                         │
│   [TODO] Third card                          │
│     ✓ 2 pts                                  │
│                                              │
│ ▼ In Progress (1 card)                       │
│   [TODO] Active task                         │
│     ✓ high • 8 pts                           │
│                                              │
│ ▼ Done (2 cards)                             │
│   [DONE] Completed task                      │
│     ✓ 2 pts                                  │
│   [DONE] Another done                        │
│     ✓ 1 pt                                   │
└──────────────────────────────────────────────┘

Features

  • Structured organization: Cards grouped under column headers
  • Column counts: See how many cards in each column
  • Column navigation: Use h/l to jump between column groups
  • Collapsible groups: Focus on specific columns
  • Detailed metadata: Full card information visible

Best Use Cases

Status Tracking

Monitor how many cards are in each workflow stage.

WIP Limits

See if columns are over their work-in-progress limits.

Flow Analysis

Identify bottlenecks by seeing card distribution across columns.

Hybrid View

Balance between list detail and kanban structure.
KeyAction
j / kMove up/down within column
h / lJump to previous/next column
ggJump to top of first column
GJump to bottom of last column
EnterOpen card details

Kanban Board View

Overview

The classic kanban board layout displays columns side-by-side with cards shown as compact items within each column.

Layout

┌─ Todo (3) ──┬─ In Progress (1) ─┬─ Done (2) ──┐
│             │                    │             │
│ First card  │ Active task        │ Completed   │
│ high • 3pts │ high • 8pts        │ 2pts        │
│             │                    │             │
│ Second card │                    │ Another     │
│ med • 5pts  │                    │ 1pt         │
│             │                    │             │
│ Third card  │                    │             │
│ 2pts        │                    │             │
└─────────────┴────────────────────┴─────────────┘

Features

  • Visual workflow: See your entire workflow at a glance
  • Side-by-side columns: Multiple columns visible simultaneously
  • Compact cards: More cards visible per screen
  • Quick card movement: Easily see where cards can move
  • Board overview: Immediate understanding of workflow state

Best Use Cases

Daily Standup

Perfect for team meetings to visualize work distribution.

Visual Workflow

See the entire workflow state at a glance.

Quick Triage

Rapidly move cards between columns during planning.

Classic Kanban

Traditional kanban board experience for agile teams.
KeyAction
j / kMove up/down within column
h / lMove to adjacent column
H / LMove card to left/right column
1-9Jump directly to column N
EnterOpen card details

Column Indicators

Columns may show additional indicators:
  • Card count: Number of cards in column (shown in header)
  • WIP limit: Visual indicator when limit is exceeded
  • Empty state: Placeholder when column has no cards

Switching Views

Keyboard Shortcut

V  # Cycle through views: Flat → Grouped → Kanban → Flat

View Selection Dialog

In some contexts, pressing V opens a dialog where you can select the view:
  1. Press V to open view selection
  2. Use j/k to navigate options
  3. Press Enter to select
Available options:
  • Flat List
  • Grouped by Column
  • Kanban Board

Persistence

Your view preference is remembered per board and persists across sessions.

View Comparison

FeatureFlat ListGroupedKanban
Detail LevelHighHighMedium
Cards per ScreenMediumMediumHigh
Column VisibilityText onlyHeadersFull columns
Best for Search
Best for Workflow
Best for Detail
Best for Overview

Tips for Each View

Flat List Tips

1

Use with Search

Activate search with / to quickly filter cards, then scan the flat list for matches.
2

Sort Strategically

Press o to sort by priority, points, or due date. The flat list makes sorted order obvious.
3

Bulk Operations

Use v to select multiple cards across different columns easily.

Grouped View Tips

1

Monitor Column Balance

Check card counts in each column header to identify bottlenecks.
2

Navigate Efficiently

Use h/l to jump between column groups instead of scrolling.
3

Focus on Stage

Concentrate on one column group at a time during focused work.

Kanban View Tips

1

Quick Card Movement

Use H/L to rapidly move cards between columns during triage.
2

Jump to Columns

Press 1-9 to jump directly to specific columns without navigation.
3

Overview Mode

Use this view for standups and high-level workflow visualization.

Combining with Other Features

Search + Views

Search works across all view modes:
/  # Activate search
Then switch views to see filtered results in different layouts.

Sprint Filter + Views

Combine sprint filtering with views:
t  # Toggle sprint filter
V  # Switch to kanban view to see sprint cards

Sorting + Views

Apply sorting in any view:
o  # Sort by field (priority, points, date)
V  # Switch views to see sorted results differently

Archived Cards View

All three view modes are available when viewing archived cards (press D):
  • Flat List: See all archived cards with archive timestamps
  • Grouped: View archived cards organized by their original column
  • Kanban: Visual layout showing where archived cards came from
Press V to cycle through views even in archived mode.

Next Steps

TUI Guide

Learn the terminal interface

Keyboard Shortcuts

Master all keyboard bindings

CLI Mode

Automate with CLI commands

Build docs developers (and LLMs) love