Sysmon

sysmon — Claude Code monitoring plugin

Know why your remote box is broken — before you even type a command.

A live system pulse in your status bar, and a one-command health check that tells you what's actually wrong — network, CPU, memory, or disk — right inside Claude Code.

• Statusline — always-on, bottom of the CLI. Turns red the moment something's off:

  load 7% │ mem 62% │ disk 98% │ net✓
  

  (here disk 98% shows red — a full disk is silently breaking this box)

• /sysmon command — full read-only diagnosis on demand: default route, gateway & internet reachability, DNS (the #1 reason commands hang), disk usage, memory/swap, load, top CPU/RAM hogs, open listeners (is sshd even alive?). Claude reads the report and tells you what's wrong and what to do.

All network probes are time-bounded, so nothing ever hangs. Everything is read-only.

Example — it catches real problems

Running /sysmon on a box that "felt slow", trimmed:

== DISK ==
  /dev/nvme0n1p5  271G  250G  6.6G   98% /
  [WARN] / is 98% full

== NETWORK ==
gateway 192.168.0.1  : reachable
internet (1.1.1.1)   : OK  2.3 ms avg
dns resolution       : OK

Verdict: degraded. Network is healthy, but root / is 98% full (6.6 GB left) — that's why writes fail and tools act weird. Free space now: sudo du -xhd1 / | sort -h, clear ~/.cache, journalctl --vacuum-size=200M, and prune Docker: docker system prune -af.

No more guessing whether it's the network or the machine.

Install (for others)

/plugin marketplace add Navifra-Sally/sysmon-plugin
/plugin install sysmon@navifra-tools

Or add a local clone:

/plugin marketplace add /path/to/sysmon-plugin
/plugin install sysmon@navifra-tools

Enable the statusline

The /sysmon command works as soon as the plugin is installed. The statusline is a user setting — add this to ~/.claude/settings.json (point it at the installed script):

{
  "statusLine": {
    "type": "command",
    "command": "bash ~/.claude/plugins/marketplaces/navifra-tools/sysmon/scripts/statusline.sh",
    "padding": 0
  }
}

The exact install path can vary by Claude Code version. Run /plugin → manage to find where sysmon was installed, or just copy scripts/statusline.sh anywhere and point command at it.

Requirements

• Linux or macOS, bash.
• Uses standard tools (ip/ifconfig, ping, df, ss/netstat, getent/host). Missing tools degrade gracefully.

Layout

sysmon-plugin/
├── .claude-plugin/marketplace.json   # makes the repo an installable marketplace
└── sysmon/
    ├── .claude-plugin/plugin.json    # the plugin manifest
    ├── commands/sysmon.md            # the /sysmon slash command
    └── scripts/
        ├── diag.sh                   # full diagnostic (run by /sysmon)
        └── statusline.sh             # fast live statusline

MIT