checkX
Checkmk monitoring, right in your terminal.
● 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 │ │ WARN 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 1W │ │ 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.
| KEY | ACTION |
|---|---|
| 1–5 | Switch view: overview, hosts, services, problems, events |
| ↑ ↓ | Move selection |
| ⏎ | Open details |
| / | Filter |
| a | Acknowledge problem |
| d | Schedule downtime |
| r | Reschedule check |
| ? | Help |
| q | Quit |