logpulse 0.1.3

Install

One-liner (Linux / macOS):

curl -fsSL https://raw.githubusercontent.com/vltamanec/logpulse/main/install.sh | sh

Update to the latest version — the same command:

curl -fsSL https://raw.githubusercontent.com/vltamanec/logpulse/main/install.sh | sh

Cargo (from source):

cargo install logpulse

# Update
cargo install logpulse --force

Manual download: grab a binary from Releases.

Shell completions:

# Bash
logpulse --completions bash > ~/.local/share/bash-completion/completions/logpulse

# Zsh
logpulse --completions zsh > ~/.zfunc/_logpulse

# Fish
logpulse --completions fish > ~/.config/fish/completions/logpulse.fish

Quick Start

# Local log file
logpulse /var/log/syslog

# Multiple files at once
logpulse app.log nginx.log error.log

# Force a specific parser
logpulse --format laravel storage/logs/laravel.log

# Pipe from Docker (auto-detects stdin)
docker logs -f my-app 2>&1 | logpulse

Remote Sources

Docker (smart prefix match + auto-reconnect)

# Container stdout — matches myapi.1.abc123 in Swarm
logpulse docker myapi

# Log file inside container
logpulse docker myapi /var/log/app.log

Finds containers by name prefix (docker ps --filter name=<prefix>). Works with Docker Swarm and Compose — no manager access needed. Auto-reconnects when a container restarts or redeploys (tries for 5 minutes).

SSH (remote files & remote Docker)

# Remote log file
logpulse ssh user@host /var/log/app.log

# Remote Docker container (same smart matching)
logpulse ssh user@host docker myapi

# Log file inside remote container
logpulse ssh user@host docker myapi /var/log/app.log

Proxy / bastion / jump host — pass directly, no config needed:

# Via jump host (corporate proxy, bastion)
logpulse ssh user@host -J bastion.corp.com docker myapi

# Custom port + key
logpulse ssh user@host -p 2222 -i ~/.ssh/id_ed25519 /var/log/app.log

# All together
logpulse ssh deploy@10.0.1.50 -J bastion.corp.com -p 2222 docker myapi

Also respects ~/.ssh/config for keys, ports, ProxyJump, ProxyCommand — use whichever is more convenient.

Kubernetes

# Pod stdout
logpulse k8s my-pod

# Specific namespace
logpulse k8s my-pod -n staging

# Specific container in multi-container pod
logpulse k8s my-pod -c sidecar

# Find pod by label
logpulse k8s -l app=api -n prod

# Log file inside pod
logpulse k8s my-pod /var/log/app.log

Docker Compose

# Service logs
logpulse compose api

# Custom compose file
logpulse compose api -f docker-compose.prod.yml

Features

• Smart format detection — auto-detects JSON, Laravel, Django, Go, Nginx from first lines
• Multiline grouping — stack traces (PHP, Java, Python) auto-grouped with parent error, shown as [+N lines]
• Regex search (?) — highlights matches inline, navigate with n / N (wraps around)
• Pattern highlighting (*) — up to 4 colors (Magenta, Cyan, Yellow, Red), stack multiple patterns
• Copy to clipboard (y) — copies selected entry + stack trace to system clipboard
• Export to file (s) — save all visible (filtered) entries to a file
• Time jump (g) — type 14:30 to jump to that timestamp, auto-pauses
• Pause mode — freezes display without losing incoming data (buffered in channel)
• Lazy history — for local files, scrolling up loads older lines on demand

Hotkeys

Supported Formats

LogPulse auto-detects the log format from the first lines. No configuration needed. Use --format to override: logpulse --format nginx access.log

How It Works

┌─ LogPulse ──────────────────────────┬─ Activity ─────────────────┐
│ app.log | EPS: 42 | Errors: 3      │ ▁▂▃▅▇▅▃▂▁▂▃▅▇█▇▅▃▂▁      │
├─ Log Feed ──────────────────────────┴────────────────────────────┤
│ [ERROR] Connection refused to database                           │
│ [INFO]  Request processed successfully                           │
│ [WARN]  Slow query detected (2.5s)                              │
│ [DEBUG] Cache hit for key=user:123                               │
│ [ERROR] Undefined variable: $user                    [+12 lines]│
├─ Help ──────────────────────────────────────────────────────────┤
│ q:quit Space:pause /:filter ?:search e:errors y:copy *:mark s:save│
└─────────────────────────────────────────────────────────────────┘

Requirements

• Local / stdin mode: just the binary
• Docker mode: docker CLI available and running
• SSH mode: ssh CLI with key-based auth configured
• Kubernetes mode: kubectl with cluster access configured
• Compose mode: docker compose (v2) available

Binary is ~2.7 MB, statically optimized. No runtime dependencies.

Building from Source

git clone https://github.com/vltamanec/logpulse.git
cd logpulse
cargo build --release
cargo test
# Binary at ./target/release/logpulse

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT