Niklas Ye b5ee62f145 feat: Stage 3 — alert detail, acknowledge, comments, stats charts
Press enter on any alert to open a full-screen detail pane (viewport).
Keybindings in detail mode:
  a/A   acknowledge / unacknowledge (updates immediately)
  c     compose a comment (text input at bottom)
  [/]   cycle comment cursor up/down
  d     delete selected comment (y/N confirmation)
  s     assign placeholder — shows "not yet supported by server"
  S     open stats view: top alerts + by-hour/by-day ASCII bar charts
  esc   back to dashboard

API additions: GetAlert, AcknowledgeAlert, UnacknowledgeAlert,
GetComments, AddComment, DeleteComment, GetTopAlerts,
GetStatsByHour, GetStatsByDay.
2026-05-21 13:48:01 +02:00

terdut-tui

A terminal user interface for terdut-server. Communicates with the server over its REST API.

Written in Go using Bubbletea.

Features

  • Alert dashboard — live view of firing and resolved alerts with auto-refresh
  • Alert actions — acknowledge, comment, and view per-alert statistics
  • On-call schedule — visual calendar of who is on duty, assign and remove entries
  • User management — add and remove users, manage API keys

Installation

Download the latest release binary for your platform from the releases page, or build from source:

go install github.com/yeniklas/terdut-tui@latest

Configuration

Create ~/.config/terdut-tui/config.yaml:

server_url: https://terdut.example.com
api_key: <your-api-key>
refresh_interval: 30  # seconds, optional

The API key is generated in terdut-server. See the server documentation for how to bootstrap a user and issue an API key.

Usage

terdut-tui                 start the TUI
terdut-tui --version       print version
terdut-tui --self-update   update to the latest release

Keybindings

Key Action
j / ↓ Move down
k / ↑ Move up
tab Switch section (Alerts / Schedule / Users)
enter Select / open detail
esc Go back
r Refresh
f Filter / cycle filter
q Quit
S
Description
Terminal user interface for terdut-server
Readme 653 KiB
v0.13.0 Latest
2026-09-27 16:32:44 +00:00
Languages
Go 99.1%
Makefile 0.9%