Skip to content

marhaupe/uitail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

uitail

Project Status: Active PRs Welcome GitHub release

A modern, interactive tail -f alternative with a beautiful UI

uitail is a tool for developers who need to monitor and analyze log output in real-time. It provides a beautiful interface that makes it easy to navigate, search, and filter log entries, improving your debugging and monitoring workflow.

uitail demo

Demo

You can check out a live demo here.

Features

  • Real-time log monitoring: Watch your logs update live, just like tail -f
  • Interactive UI: Navigate and explore logs with ease using keyboard shortcuts
  • Powerful filtering: Quickly find the information you need with regex-based filtering
  • Manage your process: Restart your process with the click of a button

Installation

Homebrew

brew tap marhaupe/uitail https://github.com/marhaupe/uitail
brew install uitail

Manual Installation

Download the latest binary for your platform from the releases page.

Quick Start

uitail "your_command_here"

For example:

uitail "npm run dev"

This will start the uitail agent. The UI will be available at http://localhost:8765.

Usage

uitail [options] "command"

Options

  • -p, --port <number>: Specify the port for the uitail agent (default: 8765)
  • -h, --help: Display help information
  • -v, --version: Display version information

Keyboard Shortcuts

  • j / k or / : Navigate between log entries
  • l or : Interact with the log entry (e.g. open, copy, etc.)
  • /: Focus the filter input
  • Esc: Blur the filter input
  • ctrl+- / ctrl+shift+-: Navigate between browser history

For a full list of shortcuts, refer to the in-app tooltips. Most shortcuts are borrowed from VSCode or Vim. Please feel free to submit a PR if you have any suggestions!.