Skip to content

LogScope v0.1.0 — First Public Release

Choose a tag to compare

View all tags
@vinnytherobot vinnytherobot released this 14 Mar 23:38
· 62 commits to main since this release
v0.1.0
d1d0603

LogScope v0.1.0

First public release of LogScope, a modern CLI tool for transforming raw logs into structured and beautiful terminal outputs.

LogScope focuses on developer experience by making log analysis faster, clearer, and visually structured directly in the terminal.

Key Features

Beautiful Terminal Output

Automatically detects log levels like INFO, WARNING, ERROR, CRITICAL, and DEBUG and applies rich terminal styling using Rich.

Universal Log Parsing

Supports both traditional logs:

[INFO] Server started
[ERROR] Database connection failed

and modern NDJSON / JSON logs used by tools like Docker and Kubernetes.

Smart Highlighting

Automatically detects and highlights:

  • IP addresses
  • URLs
  • timestamps
  • UUIDs
  • email addresses

making important information instantly visible.

Live Dashboard

Monitor logs in real time with a live statistics dashboard.

Example:

logscope app.log --dashboard --follow

Displays live counters for log levels such as:

  • Errors
  • Warnings
  • Info messages

Filtering & Search

Focus on what matters by filtering logs.

Examples:

logscope production.log --level ERROR
logscope server.log --search "timeout"

Stream & Pipe Support

LogScope works seamlessly with Unix pipes:

kubectl logs my-pod -f | logscope
docker logs api-gateway | logscope
cat server.log | logscope

HTML Export

Export styled logs into a shareable HTML report.

logscope failed_job.log --export-html report.html

Perfect for attaching logs to bug reports or sharing with teams.

Installation

Clone the repository and install locally:

git clone https://github.com/vinnytherobot/logscope.git

cd logscope
pip install -e .

Or install dependencies with Poetry:

poetry install

Tech Stack

  • Rich → terminal rendering and layout
  • Typer → CLI framework
  • Python 3.9+

What's Next

Future improvements planned:

  • Log grouping
  • Custom themes
  • Log pattern detection
  • Performance improvements for very large streams

Feedback

Found a bug or have a feature suggestion?

Open an issue on the repository and help improve LogScope.

Assets 2
Loading