---
name: rmm-search
description: Cleanly find machines in the GuruRMM fleet with a flexible, client-aware search (no more grepping /api/agents and hitting the wrong client's box). Front door for locating an agent before acting on it via /rmm.
---

# /rmm-search — find GuruRMM machines on the first try

Thin entry point to the `rmm-search` skill. Engine: `.claude/scripts/rmm-search.sh`.

## Usage

```
/rmm-search <words...> [-c <client>] [--online] [--json] [-n N]
/rmm-search -c <client>            List ALL machines for a client
/rmm-search --list-clients         Show distinct client names
```

Every query word must match some field (hostname/client/site/OS/id), so words
**narrow** — `hyperv valleywide` returns only Valley Wide's hyperv host, never
Dataforth's. Matching is normalized (case/space/hyphen-insensitive) with
prefix/substring/subsequence ranking; `-c` is an explicit hard client scope and
refuses to guess when the client name is ambiguous.

Use this to *find* an agent; pass the resulting hostname/id to `/rmm` to *act*.
Full matching rules + examples: `.claude/skills/rmm-search/SKILL.md`.