logr

logr

Terminal-native log intelligence for developers. Tail, filter, and visualize logs from Docker, Kubernetes, local files, and stdin — without any infrastructure.

The observability tool for teams too small for Datadog and too serious for grep.

Install

# Homebrew
brew install Mihir99-mk/tap/logr

# Go install
go install github.com/OpenCortex-Labs/logr/cmd/logr@latest

# curl (Linux / macOS)
curl -sf https://raw.githubusercontent.com/OpenCortex-Labs/logr/main/install.sh | sh

Or grab a binary from the Releases page.

Usage

# Interactive TUI — watch all docker-compose services
logr watch --docker

# Watch specific services
logr watch --docker --service api,worker

# Watch Kubernetes pods
logr watch --kube --namespace production --label app=api

# Watch local log files (glob supported)
logr watch --file ./logs/*.log

# Pipe from any tool
kubectl logs -f pod/api-xyz | logr watch
stern api | logr watch

# Plain text tail (pipe-friendly)
logr tail --docker --level error
logr tail --file app.log --grep "panic" --output json

# Search historical logs
logr query --file app.log --last 1h --level error --output table

# Error rate summary
logr stats --docker --last 1h

TUI Keybindings

Output Formats

logr tail --docker --output pretty   # default, colored
logr tail --docker --output json     # newline-delimited JSON
logr tail --docker --output logfmt   # key=value pairs
logr tail --docker --output table    # aligned table

Global Flags

--level     error|warn|info|debug
--grep      string match (regex supported)
--last      duration (1h, 30m, 7d)
--since     RFC3339 timestamp
--no-color  disable color output
--output    pretty|json|logfmt|table

Sources

Embeddable Logger

logr ships a structured logger you can embed in your Go app. Logs are written in logfmt so the logr CLI can parse and filter them.

import "github.com/OpenCortex-Labs/logr"

logr.Info("server started")
logr.Errorf("failed to connect: %v", err)

// Scoped logger with fields
log := logr.Default.With("request_id", id)
log.Info("request received")

For watch-mode integration (auto-start TUI + app together):

import "github.com/OpenCortex-Labs/logr/run"

func main() {
    run.New(api.Run).Start()
}

# TUI watches your app's log file live
./myapp watch

Contributing

Contributions are welcome! See CONTRIBUTING.md for how to get started, the project structure, and how to add new log sources.

Community

License

MIT