databricks-tui

Your Databricks workspace, in the terminal.

Monitor compute, Lakeflow jobs and pipelines, SQL warehouses and Unity Catalog — debug failed runs, watch what's running, and query the lakehouse — without opening a browser.

$ brew install pjhamera/tap/databricks-tui
databricks-tui in action: dashboard, run debugging, SQL console and cost view
A live tour — dashboard, run debugging, history grid, SQL console, lineage and spend.

Nothing leaves your machine. It drives the official Databricks CLI with your own credentials and talks only to your workspace. Community project — not affiliated with or endorsed by Databricks, Inc.

What it does

Everything you keep flipping browser tabs for, on one screen.

🧭

One dashboard for everything

Compute, Lakeflow jobs & pipelines, SQL warehouses, AI/BI dashboards and Unity Catalog — each pane populates independently, active work floated to the top.

🐞

Debug runs in the terminal

Drill into any run for per-task states and the actual error output. Full log tail (o), Gantt timeline (t), task DAG (d), and r repairs just the failed tasks.

🚨

Problems, everywhere at once

! lists everything currently failing — across every configured workspace — and rings the bell the moment a new failure appears between refreshes.

⚠️

Catch hung runs that look green

A live run past 1.5× its usual median gets an amber ⚠ 2.5× usual tag and a one-time bell. W watches any run and pings you when it finishes.

⌨️

SQL console for the whole lakehouse

Syntax-highlighted as you type, Tab-completes catalog/schema/table/column names from Unity Catalog, history search, $EDITOR for multi-line, CSV export.

🗂️

Unity Catalog & lineage

Drill catalogs → schemas → tables → volumes → files, preview sample rows, read the full schema, and follow a table's lineage 3 hops up and downstream as a tree.

💸

See where the money goes

14 days of DBU usage as stacked daily bars by SKU family, with list-price dollar estimates and a top-spenders table naming the jobs, clusters and warehouses behind it.

🎨

Yours to arrange

Hide and reorder panes, zoom any pane full-screen, eight color themes — all persisted per profile. Non-blocking refresh, so the UI never freezes.

Get started

You need the authenticated Databricks CLI v0.200+. That's it.

# Install (macOS & Linux)
brew install pjhamera/tap/databricks-tui

# ...or with cargo
cargo install databricks-tui

# Launch — default profile, 30s refresh
databricks-tui

# A named profile, faster refresh, a theme
databricks-tui --profile prod --refresh 10 --theme catppuccin-mocha

# Press ? at any time for every keybinding, grouped by context