# Install logcli with Homebrew, pacman, scoop, zypper

Run LogQL queries against a Loki server. Version 3.7.3 via Homebrew; verified 2026-06-26.

## Install

```sh
sudo av install brew:logcli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install logcli
```

  Evidence: local Homebrew formula metadata

### Linux

- pacman (92%):

```sh
sudo pacman -S logcli
```

  Evidence: Arch Linux sync databases: logcli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install logcli
```

  Evidence: openSUSE Tumbleweed package metadata: logcli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/logcli
```

  Evidence: Scoop official bucket manifest trees: bucket/logcli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:logcli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/logcli>
- **Version:** 3.7.3
- **Source summary:** Run LogQL queries against a Loki server
- **Homepage:** <https://grafana.com/oss/loki>
- **Repository:** <https://github.com/grafana/loki>
- **Upstream docs:** <https://grafana.com/docs/loki/latest/query/logcli>
- **License:** AGPL-3.0-only
- **Source archive:** <https://github.com/grafana/loki/archive/refs/tags/v3.7.3.tar.gz>
- **Last updated:** 2026-06-26T00:47:42Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- logcli (cli)
- logcli (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.7.3
- Package-manager updated: 2026-06-26
- Local data: ok
- Upstream repository: https://github.com/grafana/loki
- Upstream latest detected: v3.7.3 (current)
## Project history and usage

logcli is Grafana Loki's command-line client for running LogQL queries, inspecting labels and series, and using Loki from scripts or terminal workflows.

### Project history

logcli is developed inside the Grafana Loki repository. Loki itself is described by Grafana as a horizontally scalable, highly available, multi-tenant log aggregation system inspired by Prometheus, designed to index labels rather than full log contents.

Grafana introduced Loki publicly in 2018 as Prometheus-inspired logging for cloud-native systems, and GitHub release metadata records the v0.1.0 beta in June 2019. logcli became the terminal-facing companion to that stack, giving users a way to query Loki without Grafana's web UI.

### Adoption history

logcli's adoption follows Loki adoption. The Loki README points to an ADOPTERS.md file listing organizations using Loki, including Grafana Labs, Red Hat, Dropbox, ASML, and others. Package metadata in this batch shows logcli distributed through Homebrew, Arch, Scoop, and openSUSE.

In operational teams, logcli fills the same niche that `curl`, `kubectl logs`, and Prometheus query CLIs fill elsewhere: repeatable shell access to observability data, useful for incident response, automation, and checking label cardinality or query volume.

### How it is used

Grafana's documentation describes logcli as a query tool, not an ingestion tool. Users set `LOKI_ADDR` or `--addr`, optionally provide username/password, bearer token, tenant id, certificate paths, or proxy settings, and run commands such as `query`, `labels`, `series`, `stats`, and `volume`.

The docs recommend matching the logcli version to the Loki server version and downloading binaries from Loki releases or building `cmd/logcli/logcli` from the Loki source tree.

### Why package nerds care

logcli is package-nerd significant because it packages a small, scriptable interface to a much larger observability system. Homebrew and other package managers let operators install only the query client without deploying Loki locally, which is exactly the sort of CLI split that package ecosystems are good at.

### Timeline

- 2018: Grafana announces Loki as Prometheus-inspired logging for cloud-native use.
- 2019: Loki v0.1.0 beta release is published on GitHub.
- Current: Grafana documentation lists logcli as the Loki command-line tool for querying and exploring logs.

### Related projects

- Grafana Loki: the log aggregation system queried by logcli.
- LogQL: Loki's query language used by logcli.
- Grafana: the visualization and exploration UI commonly used with Loki.
- Prometheus: the monitoring system whose label model inspired Loki.

### Sources

- <https://github.com/grafana/loki>
- <https://github.com/grafana/loki/blob/main/ADOPTERS.md>
- <https://github.com/grafana/loki/releases/tag/v0.1.0>
- <https://grafana.com/docs/loki/latest/query/logcli/>
- <https://grafana.com/docs/loki/latest/query/logcli/getting-started/>


## Security Notes

No matching local secret-handling manifest was found for logcli. Nucleus package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** logcli
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- pacman - logcli - 3.6.6-1: normalized package name match | Arch Linux sync databases: logcli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A command-line for loki | https://github.com/grafana/loki
- zypper - logcli - 3.7.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: logcli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | LogCLI tool | https://grafana.com/loki
- Scoop - main/logcli: normalized package name match | Scoop official bucket manifest trees: bucket/logcli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [loki](https://www.automicvault.com/pkg/brew/loki/) - Shares the same upstream source repository.
- [grizzly](https://www.automicvault.com/pkg/brew/grizzly/) - Shares av.db curated category or tags: cli, cloud-infrastructure, grafana, observability.
- [mcp-grafana](https://www.automicvault.com/pkg/brew/mcp-grafana/) - Shares av.db curated category or tags: cli, cloud-infrastructure, grafana, observability.
- [mimirtool](https://www.automicvault.com/pkg/brew/mimirtool/) - Shares av.db curated category or tags: cli, cloud-infrastructure, grafana, observability.
- [newrelic-infra-agent](https://www.automicvault.com/pkg/brew/newrelic-infra-agent/) - Shares av.db curated category or tags: cli, cloud-infrastructure, observability.
- [sloth-cli](https://www.automicvault.com/pkg/brew/sloth-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, observability.
- [swctl](https://www.automicvault.com/pkg/brew/swctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, observability.
- [kubetail](https://www.automicvault.com/pkg/brew/kubetail/) - Shares av.db curated category or tags: cli, cloud-infrastructure, logging.
- [kubespy](https://www.automicvault.com/pkg/brew/kubespy/) - Shares av.db curated category or tags: cli, cloud-infrastructure, observability.

## Combined YAML source

View the package source record on GitHub. [combined/logcli.yml](https://github.com/automic-vault/db/blob/main/combined/logcli.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
