feat: add show_terminal_on_at_mention configuration option

- Add new config option to control terminal visibility for @ mentions
- Remove show_terminal parameter from send_at_mention function
- Update config validation to include new boolean option
- Simplify visual selection @ mention calls

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: John-Lin

README.md

@@ -151,6 +151,7 @@ For deep technical details, see [ARCHITECTURE.md](./ARCHITECTURE.md).
 
     -- Selection Tracking
     track_selection = true,
+    show_terminal_on_at_mention = true, -- Whether to show terminal when sending @ mentions
     visual_demotion_delay_ms = 50,
 
     -- Terminal Configuration

lua/claudecode/config.lua

@@ -8,6 +8,7 @@ M.defaults = {
   terminal_cmd = nil,
   log_level = "info",
   track_selection = true,
+  show_terminal_on_at_mention = true, -- Whether to show terminal when sending @ mentions
   visual_demotion_delay_ms = 50, -- Milliseconds to wait before demoting a visual selection
   connection_wait_delay = 200, -- Milliseconds to wait after connection before sending queued @ mentions
   connection_timeout = 10000, -- Maximum time to wait for Claude Code to connect (milliseconds)
@@ -55,6 +56,8 @@ function M.validate(config)
 
   assert(type(config.track_selection) == "boolean", "track_selection must be a boolean")
 
+  assert(type(config.show_terminal_on_at_mention) == "boolean", "show_terminal_on_at_mention must be a boolean")
+
   assert(
     type(config.visual_demotion_delay_ms) == "number" and config.visual_demotion_delay_ms >= 0,
     "visual_demotion_delay_ms must be a non-negative number"

lua/claudecode/init.lua

@@ -38,6 +38,7 @@ M.version = {
 --- @field terminal_cmd string|nil Custom terminal command to use when launching Claude.
 --- @field log_level "trace"|"debug"|"info"|"warn"|"error" Log level.
 --- @field track_selection boolean Enable sending selection updates to Claude.
+--- @field show_terminal_on_at_mention boolean Whether to show terminal when sending @ mentions.
 --- @field visual_demotion_delay_ms number Milliseconds to wait before demoting a visual selection.
 --- @field connection_wait_delay number Milliseconds to wait after connection before sending queued @ mentions.
 --- @field connection_timeout number Maximum time to wait for Claude Code to connect (milliseconds).
@@ -251,6 +252,7 @@ end
 ---@return string|nil error Error message if failed
 function M.send_at_mention(file_path, start_line, end_line, context)
   context = context or "command"
+  local show_terminal = M.state.config.show_terminal_on_at_mention
 
   if not M.state.server then
     logger.error(context, "Claude Code integration is not running")
@@ -259,15 +261,15 @@ function M.send_at_mention(file_path, start_line, end_line, context)
 
   -- Check if Claude Code is connected
   if M.is_claude_connected() then
-    -- Claude is connected, send immediately and ensure terminal is visible
+    -- Claude is connected, send immediately and optionally ensure terminal is visible
     local success, error_msg = M._broadcast_at_mention(file_path, start_line, end_line)
-    if success then
+    if success and show_terminal then
       local terminal = require("claudecode.terminal")
       terminal.ensure_visible()
     end
     return success, error_msg
   else
-    -- Claude not connected, queue the mention and launch terminal
+    -- Claude not connected, queue the mention and optionally launch terminal
     local mention_data = {
       file_path = file_path,
       start_line = start_line,
@@ -277,9 +279,11 @@ function M.send_at_mention(file_path, start_line, end_line, context)
 
     queue_at_mention(mention_data)
 
-    -- Launch terminal with Claude Code
-    local terminal = require("claudecode.terminal")
-    terminal.open()
+    if show_terminal then
+      -- Launch terminal with Claude Code
+      local terminal = require("claudecode.terminal")
+      terminal.open()
+    end
 
     logger.debug(context, "Queued @ mention and launched Claude Code: " .. file_path)