Jun 24, 2025
diff --git a/README.md b/README.md
      split_width_percentage = 0.30,
      provider = "auto", -- "auto", "snacks", or "native"
      auto_close = true,
      snacks_win_opts = {}, -- Opts to pass to `Snacks.terminal.open()`
    },

    -- Diff Integration
diff --git a/dev-config.lua b/dev-config.lua
    --   provider = "auto",                        -- "auto", "snacks", or "native"
    --   show_native_term_exit_tip = true,         -- Show exit tip for native terminal
    --   auto_close = true,                        -- Auto-close terminal after command completion
    --   snacks_win_opts = {},                     -- Opts to pass to `Snacks.terminal.open()`
    -- },

    -- Development overrides (uncomment as needed)
diff --git a/lua/claudecode/init.lua b/lua/claudecode/init.lua
 ---  split_side?: "left"|"right", \
 ---  split_width_percentage?: number, \
 ---  provider?: "auto"|"snacks"|"native", \
 ---  show_native_term_exit_tip?: boolean }
 ---  show_native_term_exit_tip?: boolean, \
 ---  snacks_win_opts?: table }
 ---
 ---@alias ClaudeCode.SetupOpts { \
 ---  terminal?: ClaudeCode.TerminalOpts }
diff --git a/lua/claudecode/terminal.lua b/lua/claudecode/terminal.lua
  show_native_term_exit_tip = true,
  terminal_cmd = nil,
  auto_close = true,
  snacks_win_opts = {},
 }

 -- Lazy load providers
      split_width_percentage = function(val)
        return type(val) == "number" and val > 0 and val < 1
      end,
      snacks_win_opts = function(val)
        return type(val) == "table"
      end,
    }
    for key, val in pairs(opts_override) do
      if effective_config[key] ~= nil and validators[key] and validators[key](val) then
    split_side = effective_config.split_side,
    split_width_percentage = effective_config.split_width_percentage,
    auto_close = effective_config.auto_close,
    snacks_win_opts = effective_config.snacks_win_opts,
  }
 end

 -- @field user_term_config.split_width_percentage number Percentage of screen width (0.0 to 1.0, default: 0.30).
 -- @field user_term_config.provider string 'snacks' or 'native' (default: 'snacks').
 -- @field user_term_config.show_native_term_exit_tip boolean Show tip for exiting native terminal (default: true).
 -- @field user_term_config.snacks_win_opts table Opts to pass to `Snacks.terminal.open()` (default: {}).
 -- @param p_terminal_cmd string|nil The command to run in the terminal (from main config).
 function M.setup(user_term_config, p_terminal_cmd)
  if user_term_config == nil then -- Allow nil, default to empty table silently
        config[k] = v
      elseif k == "auto_close" and type(v) == "boolean" then
        config[k] = v
      elseif k == "snacks_win_opts" and type(v) == "table" then
        config[k] = v
      else
        vim.notify("claudecode.terminal.setup: Invalid value for " .. k .. ": " .. tostring(v), vim.log.levels.WARN)
      end
diff --git a/lua/claudecode/terminal/snacks.lua b/lua/claudecode/terminal/snacks.lua
    start_insert = focus,
    auto_insert = focus,
    auto_close = false,
    win = {
    win =vim.tbl_deep_extend("force",{
      position = config.split_side,
      width = config.split_width_percentage,
      height = 0,
      relative = "editor",
    },
    }, config.snacks_win_opts or {}),
  }
 end
Original file line number	Diff line number	Diff line change
Expand Up		@@ -157,6 +157,7 @@ For deep technical details, see [ARCHITECTURE.md](./ARCHITECTURE.md).
		split_width_percentage = 0.30,
		provider = "auto", -- "auto", "snacks", or "native"
		auto_close = true,
		snacks_win_opts = {}, -- Opts to pass to `Snacks.terminal.open()`
		},

		-- Diff Integration
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -70,6 +70,7 @@ return {
		-- provider = "auto", -- "auto", "snacks", or "native"
		-- show_native_term_exit_tip = true, -- Show exit tip for native terminal
		-- auto_close = true, -- Auto-close terminal after command completion
		-- snacks_win_opts = {}, -- Opts to pass to `Snacks.terminal.open()`
		-- },

		-- Development overrides (uncomment as needed)
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -87,7 +87,8 @@ M.state = {
		--- split_side?: "left"\|"right", \
		--- split_width_percentage?: number, \
		--- provider?: "auto"\|"snacks"\|"native", \
		--- show_native_term_exit_tip?: boolean }
		--- show_native_term_exit_tip?: boolean, \
		--- snacks_win_opts?: table }
		---
		---@alias ClaudeCode.SetupOpts { \
		--- terminal?: ClaudeCode.TerminalOpts }
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -24,6 +24,7 @@ local config = {
		show_native_term_exit_tip = true,
		terminal_cmd = nil,
		auto_close = true,
		snacks_win_opts = {},
		}

		-- Lazy load providers
Expand DownExpand Up		@@ -91,6 +92,9 @@ local function build_config(opts_override)
		split_width_percentage = function(val)
		return type(val) == "number" and val > 0 and val < 1
		end,
		snacks_win_opts = function(val)
		return type(val) == "table"
		end,
		}
		for key, val in pairs(opts_override) do
		if effective_config[key] ~= nil and validators[key] and validators[key](val) then
Expand All		@@ -102,6 +106,7 @@ local function build_config(opts_override)
		split_side = effective_config.split_side,
		split_width_percentage = effective_config.split_width_percentage,
		auto_close = effective_config.auto_close,
		snacks_win_opts = effective_config.snacks_win_opts,
		}
		end

Expand DownExpand Up		@@ -179,6 +184,7 @@ end
		-- @field user_term_config.split_width_percentage number Percentage of screen width (0.0 to 1.0, default: 0.30).
		-- @field user_term_config.provider string 'snacks' or 'native' (default: 'snacks').
		-- @field user_term_config.show_native_term_exit_tip boolean Show tip for exiting native terminal (default: true).
		-- @field user_term_config.snacks_win_opts table Opts to pass to `Snacks.terminal.open()` (default: {}).
		-- @param p_terminal_cmd string\|nil The command to run in the terminal (from main config).
		function M.setup(user_term_config, p_terminal_cmd)
		if user_term_config == nil then -- Allow nil, default to empty table silently
Expand DownExpand Up		@@ -210,6 +216,8 @@ function M.setup(user_term_config, p_terminal_cmd)
		config[k] = v
		elseif k == "auto_close" and type(v) == "boolean" then
		config[k] = v
		elseif k == "snacks_win_opts" and type(v) == "table" then
		config[k] = v
		else
		vim.notify("claudecode.terminal.setup: Invalid value for " .. k .. ": " .. tostring(v), vim.log.levels.WARN)
		end
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -54,12 +54,12 @@ local function build_opts(config, env_table, focus)
		start_insert = focus,
		auto_insert = focus,
		auto_close = false,
		win = {
		win =vim.tbl_deep_extend("force",{
		position = config.split_side,
		width = config.split_width_percentage,
		height = 0,
		relative = "editor",
		},
		}, config.snacks_win_opts or {}),
		}
		end

Expand Down