checkX

Checkmk monitoring, right in your terminal.

checkx — ops@jump01
● checkX 0.1.0   site prod @ cmk01.example.local   ● connected   refresh 30s

┌ Hosts 148 ─────────────────────────────┐ ┌ Services 3,214 ───────────────────────────────┐
│ ■ 142 UP  ■ 3 DOWN  ■ 1 UNREACH        │ │ ■ 3,180 OK   17 WARN  ■ 9 CRIT  ■ 8 UNKN     │
└────────────────────────────────────────┘ └───────────────────────────────────────────────┘
┌ Hosts · problems first ──┐ ┌ Services · nas-01 ──────────────────────────────────────────┐
│▶ ● nas-01        2C 1W   │ │ CRIT Filesystem /volume1   98.7% used (14.8 of 15.0 TB)     │
│  ● esx-03         DOWN   │ │ CRIT SMART disk sdd        Reallocated sectors: 184         │
│  ● db-pg-01     1C ack   │ │  Memory                Usage 87.2% (13.9 of 16 GB)      │
│  ● k8s-node-1    UNRCH   │ │ OK   CPU load              15 min load 1.42 at 4 cores      │
│  ● esx-01              │ │ OK   Interface eth0        Up, 10 Gbit/s                    │
└──────────────────────────┘ └─────────────────────────────────────────────────────────────┘
? help  / filter  a ack  d downtime  r recheck  q quit

$ features

A fast, keyboard-driven view of your Checkmk site for when a browser tab is one context switch too many.

Native terminal UI

Runs in any terminal, over SSH, inside tmux. No browser, no GUI.

Checkmk REST API

Talks to your Checkmk site through its REST API — no agents or plugins on the server side.

Problems first

Hosts and services sorted by severity, with live summary bars for the whole site.

Act without leaving

Acknowledge, set downtime and reschedule checks straight from the list.

Filter everything

Press / and type — hosts and services narrow as you go.

Event feed

Recent state changes stream into a log pane so nothing flips unnoticed.

OK WARN CRIT UNKN PEND

$ get started

Point CheckX at your Checkmk site with an automation user and go.

Values in yellow are placeholders — replace them with your own.

# install
$ [INSTALL COMMAND]
# ~/.config/checkx/config.toml
[site.prod]
url    = "https://cmk.example.com/mysite"
user   = "automation"
secret = "$CHECKX_SECRET"
$ checkx --site prod

$ keys

Everything is one keystroke away.

KEYACTION
1–5Switch view: overview, hosts, services, problems, events
↑ ↓Move selection
⏎Open details
/Filter
aAcknowledge problem
dSchedule downtime
rReschedule check
?Help
qQuit