@@ -257,9 +257,14 @@ For deep technical details, see [ARCHITECTURE.md](./ARCHITECTURE.md).
257
257
terminal = {
258
258
split_side = " right" , -- "left" or "right"
259
259
split_width_percentage = 0.30 ,
260
- provider = " auto" , -- "auto", "snacks", "native", or custom provider table
260
+ provider = " auto" , -- "auto", "snacks", "native", "external", or custom provider table
261
261
auto_close = true ,
262
262
snacks_win_opts = {}, -- Opts to pass to `Snacks.terminal.open()` - see Floating Window section below
263
+
264
+ -- Provider-specific options
265
+ provider_opts = {
266
+ external_terminal_cmd = nil , -- Command template for external terminal provider (e.g., "alacritty -e %s")
267
+ },
263
268
},
264
269
265
270
-- Diff Integration
@@ -440,7 +445,27 @@ For complete configuration options, see:
440
445
- [ Snacks.nvim Terminal Documentation] ( https://github.com/folke/snacks.nvim/blob/main/docs/terminal.md )
441
446
- [ Snacks.nvim Window Documentation] ( https://github.com/folke/snacks.nvim/blob/main/docs/win.md )
442
447
443
- ## Custom Terminal Providers
448
+ ## Terminal Providers
449
+
450
+ ### External Terminal Provider
451
+
452
+ Run Claude Code in a separate terminal application outside of Neovim:
453
+
454
+ ``` lua
455
+ {
456
+ " coder/claudecode.nvim" ,
457
+ opts = {
458
+ terminal = {
459
+ provider = " external" ,
460
+ provider_opts = {
461
+ external_terminal_cmd = " alacritty -e %s" , -- Replace with your preferred terminal program. %s is replaced with claude command
462
+ },
463
+ },
464
+ },
465
+ }
466
+ ```
467
+
468
+ ### Custom Terminal Providers
444
469
445
470
You can create custom terminal providers by passing a table with the required functions instead of a string provider name:
446
471
0 commit comments