Terminal UI (TUI)

Overview

The Rootly TUI is a terminal-based interface for monitoring and triaging incidents and alerts without leaving your command line. Built for engineers who prefer keyboard-driven workflows, it connects directly to the Rootly API using your API key.

Incidents & Alerts

Browse incidents and alerts with full detail views — severity, status, timeline, roles, labels, and more.

Keyboard-Driven

Vim-style navigation (j/k) and intuitive shortcuts for fast, mouse-free operation.

Multi-language

Available in 12 languages including Spanish, French, Japanese, Arabic, and more.

Open Source

Fully open source at rootlyhq/rootly-tui. Contributions welcome.

Requirements

Terminal with 256-color support
Minimum terminal size: 80×24
A Rootly API key (generate one from Settings → API Keys)

Installation

brew install rootlyhq/tap/rootly-tui

Or download a pre-built binary from GitHub Releases.

Quick Start

Launch the TUI

rootly-tui

Configure your credentials

On first launch, you’ll be prompted to configure:

Setting	Description	Default
API Endpoint	Usually `api.rootly.com`, or your custom endpoint	`api.rootly.com`
API Key	Your Rootly API key	—
Timezone	Timezone for displaying timestamps	`UTC`
Language	Display language	`en_US`
Layout	Panel layout: `horizontal` or `vertical`	`horizontal`

To update settings later, press s in the app.

Navigate incidents and alerts

Use Tab to switch between the Incidents and Alerts tabs. Press Enter on any item to load its full details.

Keyboard Shortcuts

Key	Action
`j` / `↓`	Move cursor down
`k` / `↑`	Move cursor up
`g`	Go to first item
`G`	Go to last item
`[`	Previous page
`]`	Next page
`Tab`	Switch between Incidents and Alerts tabs

Actions

Key	Action
`Enter`	View details / focus detail pane
`o`	Open in browser
`c`	Copy to clipboard
`r`	Refresh data
`S`	Sort menu

General

Key	Action
`l`	View debug logs
`s`	Open settings
`A`	About
`?`	Show help
`q` / `Esc` / `Ctrl+C`	Quit

Command Line Options

Flag	Description
`--debug`	Enable debug logging to stderr
`--log <file>`	Write debug logs to a file
`--version`	Show version information

Debug Mode

# Log to stderr
rootly-tui --debug

# Log to file
rootly-tui --log debug.log

# Log to stderr, redirect to file
rootly-tui --debug 2> debug.log

Press l in the app to open the built-in log viewer.

Configuration File

Settings are stored at ~/.rootly-tui/config.yaml:

api_key: "your-api-key"
endpoint: "api.rootly.com"
timezone: "UTC"
language: "en_US"
layout: "horizontal"

Supported Languages

English (US/GB) · Spanish · French · German · Chinese (Simplified) · Japanese · Russian · Portuguese (Brazilian) · Hindi · Arabic · Bengali

Feedback & Support

Bug reports & feature requests: GitHub Issues
Source code: github.com/rootlyhq/rootly-tui

​Overview

Incidents & Alerts

Keyboard-Driven

Multi-language

Open Source

​Requirements

​Installation

​Quick Start

​Keyboard Shortcuts

​Navigation

​Actions

​General

​Command Line Options

​Debug Mode

​Configuration File

​Supported Languages

​Feedback & Support