install

Additional install commands

macOS

Homebrewverified · 100%

brew install logcli

local Homebrew formula metadata

Linux

Arch Linux pacmanverified · 92%

sudo pacman -S logcli

Arch Linux sync databases · logcli · source: geo.mirror.pkgbuild.com

openSUSE zypperverified · 92%

sudo zypper install logcli

openSUSE Tumbleweed package metadata · logcli · source: download.opensuse.org

Windows

Scoopverified · 92%

scoop install main/logcli

Scoop official bucket manifest trees · bucket/logcli.json · source: api.github.com

overview

Package summary

Run LogQL queries against a Loki server

Project links

Commands and aliases

logcli

history

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

security posture

No protected-tool coverage found yet

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.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 6 platform targets.
Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

Command	Kind	Exposure	Note
`logcli`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version3.7.3

manager updated2026-06-26

local dataok

upstreamcurrent

latest detectedv3.7.3

https://github.com/grafana/loki

okNo freshness warnings were generated.

install metadata

Package metadata

Package key	brew:logcli
Version	3.7.3
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/logcli
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
Pulse	updated
Build dependencies	go
Bottle	available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	not defined
Service	none declared

registry facts

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

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

pacman95%

logcli 3.6.6-1

A command-line for loki

https://github.com/grafana/loki

sudo pacman -S logcli

License: AGPL-3.0-only AND Apache-2.0
Architecture: x86_64
1 dependencies
normalized package name match
Matched by: Logcli

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

zypper95%

logcli 3.7.2-1.1

LogCLI tool

https://grafana.com/loki

sudo zypper install logcli

License: Apache-2.0
Category: System/Monitoring
Architecture: x86_64
Source Package: loki
1 provides
normalized package name match
Matched by: Logcli

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

Scoop95%

main/logcli

scoop install main/logcli

normalized package name match
Matched by: Logcli

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

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/logcli.yml

Used sources

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

Install logcli with Homebrew, pacman, scoop, zypper