Guide
Overview
Overview of LazyDatabricks features and capabilities
LazyDatabricks provides a terminal-based interface for managing Databricks workspaces. This guide covers the main features and how to use them effectively.
Design Principles
- Read-first, act-second. Default is safe visibility; destructive actions require explicit arming.
- Spark-true, not API-true. "Is my cluster usable?" matters more than "does the API say RUNNING?"
- Logs are the primary artifact. One keystroke, not seven clicks.
Main Screens
LazyDatabricks organizes resources into focused screens:
| Key | Screen | Description |
|---|---|---|
h | Home | Health dashboard with workspace identity and resource summaries |
c | Clusters | All-purpose and job compute clusters |
j | Jobs | Three-pane hierarchy: Jobs → Runs → Detail |
p | Pipelines | Delta Live Tables pipeline management |
w | Warehouses | SQL warehouse monitoring |
P | Config | Profile switching and connection testing |
Navigation Model
Each screen uses a consistent pattern:
- Master List - Browse resources with arrow keys or
Tabbetween panes - Detail Panel - Shows details of selected item
- Actions - Destructive actions require Armed Mode
Keyboard-First Design
Every action is accessible via keyboard shortcuts:
| Pattern | Keys | Description |
|---|---|---|
| Screen switch | h, c, j, p, w | Jump to any screen |
| List navigation | ↑, ↓, Tab | Navigate within screens |
| Actions | s, t, R | Start, terminate, restart |
| Armed mode | A | Enable destructive actions |
| Help | ? | Show keybindings overlay |
Next Steps
Explore each feature in detail: