jujumate 0.2.3

Terminal UI for Juju infrastructure orchestration

⬢ JujuMate

A terminal UI for Juju — monitor all your infrastructure resources in a single interactive screen with real-time updates. Inspired by K9s and KDash.

---

Features

• 🔄 Auto-refresh — status updates automatically every few seconds; logs stream live via WebSocket
• ☁️ Full resource tree — clouds, controllers, models, applications, units, machines
• 📊 Status view — apps, units, offers, integrations, SAAS and machines in one screen
• 🏥 Health view — shows only unhealthy models by default; toggle to see all with f
• 🔍 Drill-down navigation — select a controller → filter models; select a model → see its full status
• 🔎 Inline filtering — press / in Status or Logs to search with live highlight
• 🔗 Peer relation toggle — press p to show/hide peer relations in the Integrations panel
• 🖥️ Units-per-machine toggle — press u to show units (and their subordinates) nested under each machine
• 📋 Copy to clipboard — press y in Status or Relation Data to copy the full content
• 🔐 Secrets browser — list and inspect Juju secrets per model (Shift+S)
• 📦 Offers browser — browse all cross-model offers in a controller, with endpoint details and live consumer tracking across controllers (Shift+O)
• 📋 Relation databag inspector — examine raw relation data for any relation (Enter on a relation)
• ⚙️ App config viewer — inspect application configuration (Enter on an app)
• 🎨 Themeable — built-in ubuntu and dark themes; fully customisable via YAML
• 🪟 Terminal transparency — respects your terminal background (no forced black background)
• ⌨️ K9s-style help overlay — press ? to see all keybindings at any time (full-screen)

---

Installation

Recommended — install as a tool with uv:

uv tool install jujumate

Or with pipx:

pipx install jujumate

JujuMate reads your existing Juju configuration from ~/.local/share/juju/ automatically — no extra setup needed if juju is already working.

---

Quick Start

jujumate

On first launch JujuMate connects to your current Juju controller and auto-selects your current model. Use the keyboard shortcuts below to navigate.

---

Keyboard Shortcuts

Global

Key	Action
c	Go to Clouds tab
C	Go to Controllers tab
m	Go to Models tab
s	Go to Status tab
h	Go to Health tab
r	Force refresh
Esc	Clear cloud/controller drill-down filter
?	Toggle help overlay
q	Quit

Navigation

Key	Action
↑ / ↓	Move cursor up/down
Enter	Drill-down / open detail

Status tab

Key	Action
/	Filter by app name, charm, channel or message (with live highlight)
Esc	Clear filter
p	Toggle peer relations in the Integrations panel
u	Toggle units (and subordinates) nested under each machine
y	Copy full status to clipboard (includes cloud, controller, model and Juju version)
Enter on app	Open App Config viewer
Enter on offer	Open Offer detail
Enter on relation	Open Relation Data inspector

Health tab

Key	Action
f	Toggle between unhealthy-only (default) and all models

Modals

Key	Action
Shift+S	Open Secrets browser for the current model
Shift+O	Open Offers browser for the current controller
Shift+L	Open live Log viewer for the current model
T	Open theme switcher
Enter	Open detail view
y	Copy value to clipboard (Relation Data / Secrets)
Esc	Close modal

---

Views

Status

The main view. Displays a full juju status-style breakdown of the selected model:

• Applications — name, charm, channel, revision, units, status and workload message
• Units — workload/agent status, machine or pod, address, ports; subordinates shown nested under their principal
• Machines — id, state, address, instance, base, AZ (IaaS models only); press u to expand units and their subordinates inline
• SAAS — consumed remote offers and their status
• Offers — cross-model offers with active/total connection counts
• Integrations — regular and cross-model relations (peer relations hidden by default; press p to toggle)

Health

Shows a summary of all models across all controllers, highlighting those with errors or blocked units. Unhealthy models are shown by default; press f to toggle between unhealthy-only and all models.

Offers browser (Shift+O)

Lists all offers across every model in the current controller. Select an offer to see:

• Model, URL, application, charm, description and access level
• Endpoint details (name, interface, role)
• Live consumer list — scans all known controllers to find which models and applications are consuming the offer

Secrets browser (Shift+S)

Lists all secrets visible in the current model. Select a secret to see its metadata (owner, revision, rotation policy, timestamps).

Log viewer (Shift+L)

Streams live log entries from the current model. Use / to filter by text.

Relation Data inspector

Press Enter on any relation in the Status tab to open a databag viewer showing the application-level and unit-level relation data for both sides of the relation. Press y to copy the full content to clipboard.

App Config viewer

Press Enter on any application in the Status tab to inspect its current configuration values.

---

Configuration

JujuMate is configured via ~/.config/jujumate/config.yaml. All fields are optional.

# ~/.config/jujumate/config.yaml

theme: ubuntu               # Theme name (default: ubuntu)
refresh_interval: 5         # Seconds between auto-refresh (default: 5)
default_controller: prod    # Controller to use (default: current Juju controller)
log_file: ~/.local/state/jujumate/jujumate.log
log_level: INFO             # DEBUG | INFO | WARNING | ERROR | CRITICAL

---

Themes

JujuMate ships with five built-in themes: ubuntu (default), dark, monokai, solarized-dark and spacemacs.

Press T at any time to open the live theme switcher and preview themes before applying them.

To create a custom theme, add a YAML file to ~/.config/jujumate/themes/:

# ~/.config/jujumate/themes/mytheme.yaml
name: mytheme
primary: "#FF6600"
secondary: "#003366"
background: "#1a1a2e"
surface: "#16213e"
dark: true

Then set it in your config:

theme: mytheme

Available fields: primary, secondary, accent, background, surface, panel, warning, error, success, foreground, dark.

User themes override built-in themes with the same name.

---

Development

Requirements: Python 3.10+, uv

git clone https://github.com/Abuelodelanada/jujumate.git
cd jujumate
uv sync

Run from source:

uv run jujumate

Run checks (lint + typecheck + tests):

uv run nox

Individual sessions:

uv run nox -s tests       # Run tests with coverage
uv run nox -s lint        # Ruff lint + format check
uv run nox -s typecheck   # Pyright static analysis
uv run ruff format src tests  # Auto-format code

---

License

GNU General Public License v3.0