sysprobe-llm

2026-03-27

Code and docs

A Go CLI that runs concurrent Linux diagnostics and emits token-aware Markdown reports for LLM context. Useful when debugging your machine.

go · linux · cli · llm · diagnostics

Repository

sysprobe-llm is a Go CLI built to collect Linux system state and format it as Markdown. The goal is pasteable system context for troubleshooting or LLM prompts, without dumping raw terminal output.

Architecture and execution

Collection and presentation are separate. Probe manifests are embedded in the binary and grouped by domain (system, graphics, network, window manager, storage, and so on).

A worker pool runs probes concurrently. Worker count is configurable. Timeouts are explicit. Skip logic is context-aware. If a probe needs a missing binary or elevated privileges, the tool skips it instead of hanging or failing silently.

Token-aware output

System dumps fill LLM context windows fast. The tool treats token budget as a first-class constraint:

  • Intro mode is a short system preamble to start a conversation.
  • Minified output cuts formatting overhead when the context limit is tight.
  • Full report mode keeps broader diagnostic depth when needed.

Reports include token estimates and say what was skipped, so the LLM or operator knows what is missing. For example, a missing dependency.

Platform target

The tool currently targets Arch Linux with Hyprland. Probes fall back on other setups, but the supported baseline is narrow on purpose. The stance is to ship what is measured and document what is assumed, rather than claim untested universal support.