Home

reportmate-cli

reportmateutil is the admin command-line interface for ReportMate: one cross-platform Rust binary that talks to the ReportMate API over HTTPS and prints a table or JSON. It is named reportmateutil so that reportmate stays the name of the ReportMate app, which bundles it.

It is an admin tool, not an agent. It collects nothing from the machine it runs on; the device agents are reportmate-client-mac and reportmate-client-win.

What it does

• Covers the /api/v1 surface: fleet and device reads, module reports, applications usage and distribution, certificates, fleet-wide log sweeps, events and ingest failures, dashboard, health and metrics, API keys, usage-history and installs maintenance, and org settings. module reaches any GET route under /api/v1/, and raw reaches any path with any method, which is how the API's inventory-state and orphan-cleanup operations are called (they have no dedicated command yet).
• Configures itself. The endpoint and credential come from the environment, the ReportMate app's saved connection, an Entra sign-in through az, the device runner's preferences, or an AWS deployment's Secrets Manager, in that order. reportmateutil config shows what it found.
• Prints JSON for scripts and agents with --output json; errors go to stderr with a non-zero exit code.
• Tracks the API: a contract test fails when the copy of the API's OpenAPI document in tests/openapi.json has an operation the CLI has no command for, and a weekly workflow refreshes that copy.

Latest release: v2026.09.11.1807, built from the head of main.

Pages

Page	What is on it
Getting Started	Zero to a first query
Installation	Release assets, the macOS package, building from source
Commands	Every command, subcommand and flag, with the request each sends
Configuration	How the endpoint and credential are resolved, and every environment variable
Authentication	Credential types, headers, and the scope each command needs
Output Formats	Table, JSON and text output, streams, exit codes
Development	Build, test, the contract tests, releases
Troubleshooting	Failure modes with their actual error text

Where it sits

Repo	Wiki	What it is
reportmate-api	wiki	FastAPI ingest and query backend; every command here calls it
reportmate-app-web	wiki	Next.js dashboard
reportmate-app-swift	wiki	ReportMate for Mac, which bundles reportmateutil
reportmate-app-csharp	wiki	ReportMate for Windows, which bundles reportmateutil
reportmate-client-win	wiki	Windows agent, managedreportsrunner
reportmate-client-mac	wiki	macOS agent, managedreportsrunner
reportmate-cli	wiki	This admin CLI, reportmateutil
reportmate-mcp	wiki	MCP server exposing the fleet to AI agents
terraform-azurerm-reportmate	wiki	Azure deployment module
terraform-aws-reportmate	wiki	AWS deployment module
selfhosted-docker-reportmate	wiki	Docker Compose stack
reportmate-website	wiki	Marketing site, reportmate.app

License

AGPL-3.0-or-later. A commercial license is available; see COMMERCIAL-LICENSE.md in the repo.