Skip to main content
The Rootly TUI is currently in early preview. Features may change and some functionality may be limited. Feedback and bug reports are welcome on GitHub.

​
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

1

Launch the TUI

rootly-tui
2

Configure your credentials

On first launch, you’ll be prompted to configure:
SettingDescriptionDefault
API EndpointUsually api.rootly.com, or your custom endpointapi.rootly.com
API KeyYour Rootly API key—
TimezoneTimezone for displaying timestampsUTC
LanguageDisplay languageen_US
LayoutPanel layout: horizontal or verticalhorizontal
To update settings later, press s in the app.
3

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

KeyAction
j / ↓Move cursor down
k / ↑Move cursor up
gGo to first item
GGo to last item
[Previous page
]Next page
TabSwitch between Incidents and Alerts tabs

​
Actions

KeyAction
EnterView details / focus detail pane
oOpen in browser
cCopy to clipboard
rRefresh data
SSort menu

​
General

KeyAction
lView debug logs
sOpen settings
AAbout
?Show help
q / Esc / Ctrl+CQuit

​
Command Line Options

FlagDescription
--debugEnable debug logging to stderr
--log <file>Write debug logs to a file
--versionShow 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