vimterm 0.3.0

A vim-mode terminal where command+output blocks are navigable units
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
88
89
90
91
92
93
94
95
96
97
98

# vt

A vim-modal terminal where command+output blocks are navigable units.

## What

- Shell runs underneath, full state preserved (cd, env, aliases, functions)
- Each command + output is a block you can navigate, collapse, expand
- Vim keybindings throughout
- Status line shows cwd and exit code

## Layout

```
┌─────────────────────────────────────────────────┐
│   drwxr-xr-x  5 user  staff  160 Jan 10 14:32 . │
│ ❯ ls -la                                        │  ← command below output
│   [47 lines, exit 0]                            │  ← collapsed
│ ❯ cargo build                                   │
├─────────────────────────────────────────────────┤
│ ❯ █                                             │  ← input (fixed)
├─────────────────────────────────────────────────┤
│ ~/projects/vt  [0]                              │  ← status (fixed)
└─────────────────────────────────────────────────┘
```

## Modes

**Normal** — navigate blocks  
**Insert** — type commands  
**Scroll** — navigate within a block's output

## Keybindings

### Normal

| Key | Action |
|-----|--------|
| `j/k` | Next/prev block |
| `gg/G` | First/last block |
| `Enter` | Enter Scroll mode |
| `i` | Enter Insert mode |
| `za` | Toggle collapse |
| `q` | Quit |

### Insert

| Key | Action |
|-----|--------|
| `Esc` | Back to Normal |
| `Enter` | Execute |
| `Ctrl-c` | Clear |

### Scroll

| Key | Action |
|-----|--------|
| `j/k` | Line up/down |
| `Ctrl-d/u` | Half page |
| `gg/G` | Top/bottom |
| `Esc` | Back to Normal |

## Install

```
cargo install --path .
```

## Config

`~/.config/vt/config.toml`

```toml
[prompt]
symbol = "❯ "

[blocks]
max_lines = 10000

[history]
layout = "bottom_up"       # bottom_up (default) | top_down
command_position = "below" # below (default) | above
```

| layout | command_position | behavior |
|--------|------------------|----------|
| bottom_up | below | output above command, anchored to bottom |
| bottom_up | above | command above output, anchored to bottom |
| top_down | below | output above command, anchored to top |
| top_down | above | command above output, anchored to top |

## License

Unlicense

---

Built with [Claude Code](https://claude.ai/code) (claude-opus-4-5-20251101)