Compact directory tree (names + sizes), depth/entry-bounded.

Understand a config dir's structure without reading any file contents. Args: path, max_depth (1–6), max_entries cap, show_hidden.

Read a slice of a text/config file — never the whole thing blindly.

If grep_pattern is set, returns only matching blocks (+context lines); otherwise returns lines [start_line, end_line]. Hard cap max_lines.

Regex-search a single file, returning matching lines with numbers.

Is a CLI tool installed? Returns presence + absolute path.

Top resource-consuming processes (sort_by 'cpu' or 'memory').

Detailed info for one PID: cmdline, cpu/mem, threads, open files.

Open files & network connections held by a process (debug hangs).

Find processes whose name/cmdline matches a substring.

Live sensors: temps, fans, battery (category 'temps'/'fans'/'battery'/'all').

Battery health via upower: capacity, cycles, energy, state.

OS, kernel, uptime, CPU/mem summary, load average. One cheap call.

CPU model, core counts, per-core frequency and current governor.

Mounted filesystems with usage % (real disks only).

Block devices / partitions via lsblk -J (native JSON).

Connected USB devices (lsusb).

PCI devices (lspci), optionally filtered (e.g. 'VGA', 'Network').

GPU summary: vendor (lspci VGA) + NVIDIA stats if nvidia-smi present.

Status of a systemd unit + last few journal lines.

Args: service: unit name (e.g. 'bluetooth.service'). scope: 'system' or 'user'. log_lines: recent journal lines to include (0–40).

List systemd units. state: 'running','failed','enabled','all'.

All failed units — fastest 'what's broken?' check.

Filtered journal query — never dump the whole journal.

Args: service: unit to filter (empty = all). since: e.g. '10 min ago', 'today', '2026-06-10'. priority: e.g. 'err' to show err..emerg only. lines: max lines (1–300). grep_pattern: extra regex filter applied to the result. scope: 'system' or 'user'. kernel: kernel ring messages (journalctl -k).

Recent application crashes (coredumpctl list).

Inspect a coredump (coredumpctl info): signal, exe, stacktrace head.

Args: match: PID, executable name or COMM; empty = most recent crash. limit_lines: cap on returned lines.

Kernel messages by level (dmesg, falls back to journalctl -k).

Surfaces driver/hardware issues (USB resets, audio, bluetooth drops) without reading the whole boot log. level e.g. 'err,warn' or 'err'.

Slowest units at boot (systemd-analyze blame) + total boot time.

List D-Bus names on the session or system bus (filterable).

Read a D-Bus property (or all of an interface) via busctl.

Example: service 'org.kde.KWin', path '/KWin', interface 'org.kde.KWin'. Leave name empty to dump the whole interface.

[ACTION] start/stop/restart/reload/enable/disable a systemd unit.

Gated by SYSCONTROL_ALLOW_ACTIONS. System scope may prompt for auth (polkit). Returns rc + new ActiveState.

[ACTION] Send a signal to a PID (default SIGTERM). Gated.

Bluetooth adapter status (powered, discoverable, pairable).

List known/paired Bluetooth devices (name + MAC).

Scan for nearby Bluetooth devices for a few seconds.

[ACTION] Turn the Bluetooth adapter on or off.

[ACTION] Connect to a paired Bluetooth device by MAC.

[ACTION] Disconnect a Bluetooth device (empty MAC = all).

[ACTION] Pair (and optionally trust) a Bluetooth device.

Current display brightness (percent) for internal backlight(s).

[ACTION] Set display brightness to a percentage (1–100).

Active power profile + available ones (power-profiles-daemon).

[ACTION] Set power profile: performance / balanced / power-saver.

Current CPU frequency governor + the ones available.

[ACTION] Set the CPU governor on all cores (e.g. performance, powersave).

Uses cpupower; needs root. Reports the permission requirement honestly.

Default audio sink volume & mute state (PipeWire/wpctl or pactl).

[ACTION] Set default sink volume to a percentage (0–150).

[ACTION] Mute or unmute the default audio sink.

Current media: player, status, artist/title (MPRIS via playerctl).

[ACTION] Control playback: play/pause/play-pause/next/previous/stop.

List installed .desktop application IDs (for launch_app).

[ACTION] Launch an app: a .desktop id, or a binary on PATH.

Examples: 'firefox', 'org.kde.dolphin', 'code'. Extra args optional. Detaches the process so it outlives the request.

[ACTION] Open a file/folder/URL with the default handler (xdg-open).

Current KDE color scheme, icon theme, look-and-feel & plasma version.

Available KDE color schemes (for set_color_scheme).

[ACTION] Apply a KDE color scheme by name (see list_color_schemes).

[ACTION] Apply a KDE global theme / look-and-feel package.

Send a desktop notification (notify-send). Harmless, ungated.

[ACTION] Tell KWin to reload its configuration.

[ACTION] Lock the screen.

[ACTION] Suspend (sleep) the system.

[POWER] reboot / poweroff — needs SYSCONTROL_ALLOW_POWER too.

Double-gated to avoid accidental data loss.