logana 0.1.0

A TUI log analyzer/viewer built for speed - handles files with millions of lines with instant filtering and VIM like navigation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# Navigation

logana uses Vim-style keybindings for all navigation. All bindings are configurable — see [Keybindings](configuration/keybindings.md).

## Scrolling

| Key | Action |
|---|---|
| `j` / `Down` | Scroll down one line |
| `k` / `Up` | Scroll up one line |
| `Ctrl+d` | Half page down |
| `Ctrl+u` | Half page up |
| `PageDown` | Full page down |
| `PageUp` | Full page up |
| `gg` | Jump to first line |
| `G` | Jump to last line |

## Horizontal Scroll

When line wrap is off, long lines can be scrolled horizontally:

| Key | Action |
|---|---|
| `h` | Scroll left |
| `l` | Scroll right |

## Count Prefix

Prepend a number to most motion keys to repeat them:

```
5j      — scroll down 5 lines
10k     — scroll up 10 lines
3Ctrl+d — scroll down 3 half-pages
50G     — jump to line 50
3gg     — jump to line 3
```

The active count is shown in the status bar (e.g. `[NORMAL] 5`). Counts are capped at 999,999.

## Go to Line

From command mode, type a bare line number to jump there:

```
:500    — jump to line 500
:1      — jump to the first line
```

If the target line is hidden by an active filter, logana jumps to the nearest visible line instead.

## Marks

Mark important lines to jump back to them or include them in an export.

| Key | Action |
|---|---|
| `m` | Mark / unmark the current line |
| `M` | Toggle marks-only view (show only marked lines) |

Marked lines show a highlighted indicator in the gutter. Marks are per-session and not persisted across runs.

## Visual Selection

| Key | Action |
|---|---|
| `V` | Enter visual **line** mode — select whole lines for bulk mark / comment / yank / filter |
| `v` | Enter visual **char** mode — move a cursor within the current line and select a text range |

See [Visual Line Mode](visual-line-mode.md) and [Visual Character Mode](visual-char-mode.md) for the full key reference.

## Log Level Navigation

Jump directly between error and warning lines without scrolling:

| Key | Action |
|---|---|
| `e` | Jump to next ERROR / FATAL line |
| `E` | Jump to previous ERROR / FATAL line |
| `w` | Jump to next WARN line |
| `W` | Jump to previous WARN line |

Navigation wraps to the nearest visible line that matches the level. Positions are pre-indexed whenever the visible set changes, so each jump is O(log n) regardless of file size.

## Line Wrap

Toggle line wrapping with `:wrap` or via the UI menu (`u` → `w`). When wrap is enabled, long lines flow onto multiple terminal rows and all viewport math accounts for the extra rows automatically.