@aymanbagabas/drift 0.0.3 → 0.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -78,7 +78,7 @@ sudo yum install drift
|
|
|
78
78
|
### Arch Linux (AUR)
|
|
79
79
|
|
|
80
80
|
```sh
|
|
81
|
-
yay -S drift-bin
|
|
81
|
+
yay -S drift-diff-bin
|
|
82
82
|
```
|
|
83
83
|
|
|
84
84
|
### Prebuilt binaries
|
|
@@ -101,11 +101,20 @@ drift -w # watch the repo and refresh on every change
|
|
|
101
101
|
git diff | drift # pager mode: read a diff from stdin
|
|
102
102
|
```
|
|
103
103
|
|
|
104
|
-
|
|
104
|
+
> [!TIP]
|
|
105
|
+
> Pair it with an AI agent. Leave `drift -w` open in a split while an agent (Copilot, Claude, etc.) works, every edit lands on screen instantly. Press <kbd>w</kbd> to freeze the view when you want to read, and again to resume.
|
|
106
|
+
|
|
107
|
+
Make it your default git diff pager:
|
|
105
108
|
|
|
106
109
|
```sh
|
|
107
110
|
git config --global pager.diff drift
|
|
108
|
-
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
drift defaults to the `ansi` theme — your terminal's own colors, with syntax
|
|
114
|
+
highlighting off. Pick a theme to turn it on, globally via git config:
|
|
115
|
+
|
|
116
|
+
```sh
|
|
117
|
+
git config --global drift.theme onedark # onelight, dracula, nord, gruvbox-dark, ...
|
|
109
118
|
```
|
|
110
119
|
|
|
111
120
|
Some flags worth knowing:
|
|
@@ -169,9 +178,11 @@ drift is fully mouse-driven too:
|
|
|
169
178
|
|
|
170
179
|
## Themes
|
|
171
180
|
|
|
172
|
-
Set `theme = "..."` in your config.
|
|
181
|
+
Set `theme = "..."` in your config, or `git config drift.theme ...`. The default
|
|
182
|
+
is **`ansi`** — your terminal's own 16 colors, with syntax highlighting and
|
|
183
|
+
word-diff emphasis left off. Any other built-in theme turns highlighting on:
|
|
173
184
|
|
|
174
|
-
- `onedark`, `onelight`
|
|
185
|
+
- `onedark`, `onelight`
|
|
175
186
|
- `dracula`
|
|
176
187
|
- `gruvbox-dark`, `gruvbox-light`
|
|
177
188
|
- `nord`
|
|
@@ -179,13 +190,18 @@ Set `theme = "..."` in your config. Built in and ready:
|
|
|
179
190
|
- `catppuccin-mocha`, `catppuccin-latte`
|
|
180
191
|
- `tokyonight`
|
|
181
192
|
- `monokai`
|
|
182
|
-
- `ansi
|
|
183
|
-
whatever palette you already run. It leaves code text and word-diff
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
193
|
+
- `ansi` — the default: borrows your terminal's own 16 colors so drift matches
|
|
194
|
+
whatever palette you already run. It leaves code text and word-diff emphasis
|
|
195
|
+
alone, since 16 colors are too few to layer cleanly over diff colors.
|
|
196
|
+
|
|
197
|
+
A handful of [syntect](https://github.com/trishume/syntect) theme names also
|
|
198
|
+
work, but only the seven that ship in syntect's default set — `InspiredGitHub`,
|
|
199
|
+
`Solarized (dark)`, `Solarized (light)`, `base16-eighties.dark`,
|
|
200
|
+
`base16-mocha.dark`, `base16-ocean.dark`, and `base16-ocean.light`. They color
|
|
201
|
+
the code but won't repaint the UI chrome to match, and (Solarized aside) the
|
|
202
|
+
built-ins above already cover them with matching chrome. Any other theme name —
|
|
203
|
+
a custom `.tmTheme`, or a syntect theme not in that set — silently falls back to
|
|
204
|
+
`onedark`.
|
|
189
205
|
|
|
190
206
|
The `themes/` directory has a full, commented config for every built-in theme.
|
|
191
207
|
Copy one and go:
|
|
@@ -254,6 +270,10 @@ Or in `~/.gitconfig` directly:
|
|
|
254
270
|
For the full list of every setting, color, component style, and flag, see
|
|
255
271
|
[CONFIG.md](CONFIG.md).
|
|
256
272
|
|
|
273
|
+
## Built with
|
|
274
|
+
|
|
275
|
+
drift's terminal UI is powered by [uncurses](https://github.com/aymanbagabas/uncurses), and its multi-channel releases are cut with [GoReleaser](https://goreleaser.com).
|
|
276
|
+
|
|
257
277
|
## License
|
|
258
278
|
|
|
259
279
|
MIT
|