Skip to content

Lumbergh Documentation

Welcome to the Lumbergh docs — a self-hosted web dashboard for supervising multiple AI coding agent sessions (Claude Code, Cursor, Aider, and more) running in tmux on Linux/macOS or psmux on Windows.

Watch diffs roll in, fire off prompts, check todos, and keep your AI workers on task — all from your browser or phone.

  • Getting Started

    Install Lumbergh in 30 seconds and start supervising your first session.

    Installation

  • Guides

    Learn how to use the dashboard, terminals, git viewer, prompts, and more.

    Feature Guides

  • Reference

    Configuration options, environment variables, data storage paths.

    Configuration

  • Troubleshooting

    Common issues and how to fix them.

    Troubleshooting

What You Get

  • Multi-session dashboard — all your AI sessions at a glance with live idle detection (working / idle / error / stalled)
  • Multi-agent support — run Claude Code, Cursor, Aider, Gemini CLI, OpenCode, or Codex per session
  • Live terminals — interact with real terminal sessions via xterm.js + WebSockets
  • Git diff viewer — watch diffs, commits, and branch changes as the AI writes code
  • Git operations — commit, merge, rebase, cherry-pick, stash, reword, reset, force-push, and more
  • AI commit messages — generate conventional commit messages from the current diff
  • Git graph — interactive metro-style commit history visualization
  • File browser — browse project files with syntax highlighting and markdown preview
  • Prompt templates — reusable prompts at project and global scope, fire them with one click
  • Todos & scratchpad — per-project notes and task tracking with cross-session todo moves
  • Shared files — share context (including images) across sessions
  • AI status summaries — AI-generated labels for what each session is doing
  • Cloud sync — optional cloud backup, prompt sharing, and community prompt discovery via Lumbergh Cloud
  • Optional authentication — password protection with signed cookie sessions
  • Mobile-first + PWA — responsive design, installable on your phone or tablet
  • Tailscale integration — auto-detects Tailscale for secure remote access with HTTPS/TLS support
  • Dark and light themes — toggle with one click

"Being able to code anywhere is a real game changer. Before, I had to lug around my laptop — now I just pull out my phone."

— @jcamierpy24

Quick Install

uv tool install pylumbergh
lumbergh
# open http://localhost:8420

Requires tmux (or psmux on Windows) and git. See Prerequisites for details.

Need uv?

uv is a fast Python package manager that installs tools in isolated environments. Get it with:

curl -LsSf https://astral.sh/uv/install.sh | sh

Prefer pip? pip install pylumbergh works too.