You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Bump v0.5.0 — update README, description, and keywords
Rewrite README to cover AI agent integration (MCP, Chat tab, built-in agent),
live connections (serial, logcat, SSH), Context Search pattern correlation,
baseline comparison, image viewer, and other features added since v0.4.0.
Add comprehensive keywords to package.json.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: README.md
+57-40Lines changed: 57 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,59 +1,79 @@
1
1
# LOGAN - Log Analyzer
2
2
3
-
A blazing-fastlog file viewer built with Electron, designed for **massive log files**. Tested and working with files up to **14 million+ lines** — virtual scrolling keeps it smooth no matter how big the file gets.
3
+
A fast, AI-ready log file viewer built with Electron. Handles **14 million+ lines** with virtual scrolling, integrates with AI agents via MCP, connects to live serial/logcat/SSH streams, and provides deep analysis tools — all in one desktop app.
4
4
5
5
## Features
6
6
7
7
### Core Viewer
8
-
-**Virtual scrolling** — Handles multi-million line files with constant memory usage and smooth 60fps scrolling
8
+
-**Virtual scrolling** — Constant memory usage and smooth 60fps, even with multi-million line files
9
9
-**Fast search** — Powered by ripgrep (10-100x faster), with regex, wildcard, whole word, and case-sensitive modes
10
-
-**Multiple tabs** — Open and switch between log files without losing state
10
+
-**Multiple tabs** — Open and switch between files without losing state
11
11
-**Minimap** — Bird's-eye overview with color-coded error/warning indicators, click to jump
12
12
-**Word wrap & zoom** — Toggle wrapping, adjust font size with Ctrl+/- or mouse wheel
13
13
-**Column visibility** — Auto-detect delimited columns and show/hide them
14
+
-**JSON auto-format** — Pretty-print JSON files on open
15
+
16
+
### AI Agent Integration
17
+
-**MCP support** — 30+ tools auto-discovered by Claude Code, Cursor, and other MCP clients via `.mcp.json`
18
+
-**Agent Chat tab** — Bidirectional messaging between LOGAN and AI agents with SSE real-time bridge
19
+
-**Built-in agent** — One-click launch from the Chat tab, handles triage/search/crash analysis/bookmarking
20
+
-**HTTP API** — Full REST API for custom agents (bash, Node.js, Python) — see [LOGAN-AGENT.md](LOGAN-AGENT.md)
21
+
-**Connection indicator** — Shows agent name and status, enforces single-agent connection
22
+
-**Custom agent scripts** — Point to your own agent via `~/.logan/agent-config.json`
23
+
24
+
### Live Connections
25
+
-**Serial monitor** — Connect to serial ports with auto-device discovery
26
+
-**Android logcat** — Stream logcat output with device listing
27
+
-**SSH shell** — Remote log tailing via SSH with key/password auth
28
+
-**Datadog** — Fetch logs directly from Datadog APIs
29
+
-**Multi-connection** — Up to 4 parallel connections, each with its own live card and density minimap
30
+
-**Session recording** — Save live sessions to file for later analysis
31
+
-**SSH profiles** — Save, load, and manage connection profiles; auto-import from `~/.ssh/config`
32
+
-**SFTP browser** — Browse and download remote files
14
33
15
34
### Analysis & Filtering
16
35
-**Log analysis** — Pattern detection, duplicate grouping, level distribution, and time range stats
36
+
-**Context Search** — Define multi-pattern contexts (must + clue patterns) with proximity-based correlation for root cause analysis; tree view and timeline density bar
-**Time gap detection** — Find gaps between timestamps with configurable thresholds and line/pattern ranges
38
+
-**Time gap detection** — Find gaps between timestamps with configurable thresholds
39
+
-**Crash investigation** — Deep-dive into crash sites with surrounding context and auto-bookmarking
40
+
-**Component analysis** — Investigate a specific component's health across the log
41
+
-**Time-range analysis** — Focus on a specific time window
42
+
-**Baseline comparison** — Save log fingerprints and compare future logs against them to detect regressions
19
43
-**Search configs** — Persistent multi-pattern search with color-coded highlighting (Ctrl+8)
20
44
21
45
### Annotations
22
46
-**Bookmarks** — Mark lines with comments and colors, save/load bookmark sets, export
23
47
-**Highlights** — Color-code patterns with regex support, per-file or global, organized in groups
24
-
-**Notes drawer** — Freeform notes per file with auto-save (Ctrl+Shift+N)
25
-
-**Save snippets** — Extract selected line ranges to `.notes.txt` files for later reference
48
+
-**Notes drawer** — Freeform notes per file with auto-save and Save-As (Ctrl+Shift+N)
49
+
-**Save snippets** — Extract selected line ranges to `.notes.txt` files
26
50
27
51
### Split & Diff
28
52
-**File splitting** — Break huge files into manageable parts
29
53
-**Split view** — View two files side by side
30
54
-**Diff view** — Compare files with aligned hunk display, additions/deletions/modifications
31
55
32
-
### Video Player
33
-
-**Log-to-video sync** — Open a screen recording alongside logs, set a sync point from any log line, then click lines to seek the video to the corresponding moment (Ctrl+9)
34
-
-**Drag & drop** — Drop MP4/WebM/OGG files directly onto the panel
35
-
-**Per-file persistence** — Video path and sync offset remembered per log file
56
+
### Media
57
+
-**Video sync** — Open a screen recording alongside logs, set a sync point, click lines to seek video (Ctrl+9)
58
+
-**Image viewer** — View PNG, JPG, SVG images with zoom in the bottom panel
0 commit comments