logpulse 0.1.2

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

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                                │
├─ Help ──────────────────────────────────────────────────────────┤
│ q:quit Space:pause /:filter e:errors Enter:detail c:clear ↑↓:nav│
└─────────────────────────────────────────────────────────────────┘

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