@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.
Files changed (2) hide show
  1. package/README.md +32 -12
  2. 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
- Make it your default git pager for diffs:
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
- git config --global pager.show drift
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. Built in and ready:
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` (the defaults, picked by your terminal background)
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`, which borrows your terminal's own 16 colors so drift matches
183
- whatever palette you already run. It leaves code text and word-diff
184
- emphasis alone, since 16 colors are too few to layer cleanly over diff
185
- colors.
186
-
187
- Any [syntect](https://github.com/trishume/syntect) theme name works too (for
188
- example `base16-ocean.dark`), it just won't repaint the UI chrome to match.
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
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aymanbagabas/drift",
3
- "version": "0.0.3",
3
+ "version": "0.0.5",
4
4
  "description": "A standalone git diff pager for the terminal.",
5
5
  "bin": {
6
6
  "drift": "bin/drift.js"