Metadata-Version: 2.4
Name: agent-tool-grafana-cli
Version: 0.1.0
Summary: Agent-ready command-line interface for Grafana — find what you can get logs from, then get them (Loki/Elasticsearch), plus dashboards, datasources and alerts.
Author: Zierhut IT, Alexander Zierhut
License: MIT
Project-URL: Homepage, https://github.com/alexander-zierhut/agent-tool-grafana-cli
Project-URL: Repository, https://github.com/alexander-zierhut/agent-tool-grafana-cli
Project-URL: Issues, https://github.com/alexander-zierhut/agent-tool-grafana-cli/issues
Project-URL: Changelog, https://github.com/alexander-zierhut/agent-tool-grafana-cli/releases
Keywords: grafana,loki,logs,logql,observability,cli,command-line,grafana-api,datasources,dashboards,alerting,ai-agent,llm,automation,devops,sre
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: agent-tool-shared-cli<0.2,>=0.1
Requires-Dist: typer>=0.12
Requires-Dist: httpx>=0.27
Requires-Dist: keyring>=25
Requires-Dist: rich>=13
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Requires-Dist: pytest-timeout>=2.3; extra == "test"
Provides-Extra: build
Requires-Dist: pyinstaller>=6; extra == "build"

# agent-tool-grafana-cli

Agent-ready CLI for **Grafana**, from a developer's perspective: *find out what you
can even get logs from, then get them.*

> 🚧 **Scaffold.** Published early so the release pipeline is proven; the command
> surface lands next.

```bash
pipx install agent-tool-grafana-cli
```

Part of the `agent-tool-<x>-cli` family, built on
[agent-tool-shared-cli](https://github.com/alexander-zierhut/agent-tool-shared-cli):
JSON on stdout, JSON errors on stderr, stable exit codes, `--dry-run`, and a
built-in `guide` so an agent can learn the tool from the tool.

Siblings: [openproject](https://github.com/alexander-zierhut/agent-tool-openproject-cli) ·
[drone](https://github.com/alexander-zierhut/agent-tool-drone-cli)

## The name

The command is **`graf`**, not `grafana-cli`.

`grafana-cli` is the **official binary that ships with every Grafana server
install** (plugin management), and `grafanactl` is Grafana's own newer
dashboards-as-code tool. Shadowing either is the mistake we deliberately refused
with `op` (OpenProject) and `drone` — a package manager should never win a PATH
fight it didn't announce. The distribution keeps the family name
(`agent-tool-grafana-cli`); only the command is short.

## License

MIT
