Skip to content
pauloremoliPublic

Repository files navigation

logana

A fast log viewer for your terminal and desktop. Filter logs of any size and format, mark and annotate what matters, then export your findings.

GUI Desktop application

Logana desktop GUI screenshot

TUI application

logana TUI showing colored, grouped filters alongside marked lines and inline comments

  • Native desktop GUI built with GPUI, plus a keyboard-driven terminal UI
  • Any log format — JSON, syslog, logfmt, OpenTelemetry, DLT, or a custom schema
  • Include/exclude/highlight filters — by text, regex, field, or date range
  • Bookmark and annotate lines, then export to Markdown or Jira
  • Vim-style navigation, fully remappable keybindings
  • MCP server to expose your findings to AI assistants

Installation

Pre-built binaries (recommended)

Download from the Releases page, or use the install script:

Linux / macOS

curl -fsSL https://github.com/pauloremoli/logana/releases/latest/download/logana-installer.sh | sh

Windows (PowerShell)

irm https://github.com/pauloremoli/logana/releases/latest/download/logana-installer.ps1 | iex

These install the TUI (logana). For the GUI only, swap in logana-gui-installer.sh / .ps1; for both frontends, use logana-full-installer.sh / .ps1.

Debian / Ubuntu

Download the .deb for your architecture from the Releases page, then install it with APT:

sudo apt install ./logana_0.7.7-1_amd64.deb

Packages are available for amd64 and arm64: logana (TUI), logana-gui (GUI), or logana-full (both). GUI packages include an application menu launcher. Packages are built and tested on Ubuntu 24.04; other Debian/Ubuntu releases need compatible runtime libraries.

Homebrew (macOS / Linux)

TUI

To install only the terminal UI instead:

brew tap pauloremoli/logana && brew install logana

GUI

Install only the desktop GUI:

brew tap pauloremoli/logana && brew install logana-gui

Cargo

Cargo by default will run/install only the TUI (logana).

# Run the TUI
cargo run
cargo install logana
# or install the latest binary directly
cargo binstall logana

For the desktop GUI, use the pre-built GUI or full installers above, or build from a checkout of this repository:

# Run the desktop GUI
cargo run -p logana-gui
# Install only the desktop GUI from this checkout
cargo install --path crates/logana-gui --locked

Documentation

Full documentation is at pauloremoli.github.io/logana.