feat: Add configurable buffer names for Agentic panels

Signed-off-by: Chance Zibolski <chance.zibolski@gmail.com>

Author: chancez

README.md

@@ -202,8 +202,8 @@ https://github.com/user-attachments/assets/c6653a8b-20ef-49c8-b644-db0df1b342f0
   - For security reasons, this plugin doesn't install or manage binaries for
     you. You must install them manually.
 
-**We recommend using `pnpm`**  
-`pnpm` uses a constant, static global path, that's resilient to updates.  
+**We recommend using `pnpm`**
+`pnpm` uses a constant, static global path, that's resilient to updates.
 While `npm` loses global packages every time you change Node versions using
 tools like `nvm`, `fnm`, etc...
 
@@ -222,14 +222,14 @@ tools like `nvm`, `fnm`, etc...
 | [cline][cline]                       | `pnpm add -g cline`<br/> **OR** `npm i -g cline`<br/> **OR** See [Cline docs][cline-docs]                                                                                                      |
 | [goose][goose]                       | `brew install block-goose-cli`<br/> **OR** See [Goose docs][goose-docs]                                                                                                                        |
 
-> [!WARNING]  
+> [!WARNING]
 > These install commands are here for convenience, please always refer to the
 > official installation instructions from the respective ACP provider.
 
-> [!NOTE]  
+> [!NOTE]
 > Why install ACP provider CLIs globally?
 > [shai-hulud](https://www.wiz.io/blog/shai-hulud-2-0-ongoing-supply-chain-attack)
-> should be reason enough. 📌 Pin your versions!  
+> should be reason enough. 📌 Pin your versions!
 > But frontend projects with strict package management policies will fail to
 > start when using `npx ...`
 
@@ -307,8 +307,8 @@ here for ease access and reference:
 You can customize the built-in providers or add any new ACP-compatible provider
 by configuring the `acp_providers` property:
 
-> [!NOTE]  
-> You don't have to override anything or include these in your setup!  
+> [!NOTE]
+> You don't have to override anything or include these in your setup!
 > These are just examples of how you can customize the commands, env, etc.
 
 ```lua
@@ -358,7 +358,7 @@ by configuring the `acp_providers` property:
 - `default_thought_level` (string, optional) - Default thought effort level to
   apply on session creation (e.g., `"high"`, `"max"` for Claude)
 
-> [!NOTE]  
+> [!NOTE]
 > Customizing a provider only requires specifying the fields you want to
 > override, not the entire configuration.
 
@@ -458,6 +458,47 @@ header parts:
 }
 ```
 
+### Customizing Buffer Names
+
+By default, buffer names mirror the window header titles. You can override them
+independently via the `buffer_name` field in each window's config, for example
+to show cleaner names in your statusline or buffer switcher:
+
+```lua
+{
+  "carlos-algms/agentic.nvim",
+  opts = {
+    windows = {
+      chat = { buffer_name = "Agentic Chat" },
+      input = { buffer_name = "Agentic Prompt" },
+      code = { buffer_name = "Code Snippets" },
+      files = { buffer_name = "Files" },
+      diagnostics = { buffer_name = "Diagnostics" },
+      todos = { buffer_name = "Tasks" },
+    },
+  },
+}
+```
+
+You can also use a function that receives the header parts and returns a string:
+
+```lua
+{
+  "carlos-algms/agentic.nvim",
+  opts = {
+    windows = {
+      chat = {
+        buffer_name = function(parts)
+          return "AI: " .. parts.title
+        end,
+      },
+    },
+  },
+}
+```
+
+When a panel has no `buffer_name` set, it falls back to the header title.
+
 ### Folding
 
 Long tool call outputs are automatically folded to keep the chat buffer
@@ -690,7 +731,7 @@ are provided by your ACP provider.
 
 ### File Picker
 
-You can reference and add files to the context by typing `@` in the Prompt.  
+You can reference and add files to the context by typing `@` in the Prompt.
 It will trigger the native Neovim completion menu with a list of all files in
 the current workspace.
 
@@ -1146,7 +1187,7 @@ Enable debug logging to troubleshoot issues:
 
 View debug logs with `:messages` (lost after restarting Neovim)
 
-View messages exchanged with the ACP provider in the log file at:  
+View messages exchanged with the ACP provider in the log file at:
 (persistent until you delete it)
 
 - `~/.cache/nvim/agentic_debug.log`
@@ -1157,7 +1198,7 @@ View messages exchanged with the ACP provider in the log file at:
 
 ## 📄 License
 
-[MIT License](LICENSE.txt)  
+[MIT License](LICENSE.txt)
 Feel free to copy, modify, and distribute, just be a good samaritan and include
 the the acknowledgments 😊.
 

doc/agentic.txt

@@ -284,6 +284,10 @@ windows ~
   `height`             Height when position is `"bottom"`. String
                        percentage or number. Default: `"30%"`.
   `stack_width_ratio`  Ratio for stacked panels. Default: `0.4`.
+  `buffer_name`        Name of the window buffer. String title
+                       or function returning string title.
+                       Default: window header title.
+                       See agentic-config-headers.
 
   Sub-panel options (each accepts `win_opts` table):
 

lua/agentic/config_default.lua

@@ -71,26 +71,34 @@
 --- Overrides default options (wrap, linebreak, winfixheight)
 --- @alias agentic.UserConfig.WinOpts table<string, any>
 
+--- @alias agentic.UserConfig.BufferNameFn fun(header: agentic.ui.ChatWidget.HeaderParts): string|nil
+
 --- @class agentic.UserConfig.Windows.Chat
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Input
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Code
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Files
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Diagnostics
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts
 
 --- @class agentic.UserConfig.Windows.Todos
+--- @field buffer_name? string|agentic.UserConfig.BufferNameFn
 --- @field display boolean
 --- @field max_height number
 --- @field win_opts? agentic.UserConfig.WinOpts

lua/agentic/ui/window_decoration.lua

@@ -195,12 +195,73 @@ local function set_winbar(winid, text)
     vim.api.nvim_set_option_value("winbar", winbar_text, { win = winid })
 end
 
+--- Resolves the buffer name from config, supporting string or function values
+--- @param window_name string Window name for Config.windows[name].buffer_name lookup
+--- @param header_parts agentic.ui.ChatWidget.HeaderParts Header parts passed to function-type buffer_name
+--- @param fallback string|nil Fallback name (resolved header text) when buffer_name is not set
+--- @return string|nil name
+local function resolve_buffer_name(window_name, header_parts, fallback)
+    local win_cfg = Config.windows[window_name]
+    local buffer_name = win_cfg and win_cfg.buffer_name
+
+    if buffer_name == nil then
+        return fallback
+    end
+
+    if type(buffer_name) == "string" then
+        return buffer_name
+    end
+
+    if type(buffer_name) == "function" then
+        local ok, result = pcall(buffer_name, header_parts)
+        if not ok then
+            Logger.notify(
+                string.format(
+                    "Error in buffer_name function for '%s': %s",
+                    window_name,
+                    result
+                )
+            )
+            return fallback
+        end
+        if result ~= nil and type(result) ~= "string" then
+            Logger.notify(
+                string.format(
+                    "buffer_name function for '%s' must return string|nil, got %s",
+                    window_name,
+                    type(result)
+                )
+            )
+            return fallback
+        end
+        return result
+    end
+
+    Logger.notify(
+        string.format(
+            "buffer_name for '%s' must be string|function|nil, got %s",
+            window_name,
+            type(buffer_name)
+        )
+    )
+    return fallback
+end
+
 --- Sets the buffer name based on header text and tab count
 --- @param bufnr integer Buffer number
 --- @param header_text string|nil Resolved header text
 --- @param tab_page_id integer Tab page ID for suffix
-local function set_buffer_name(bufnr, header_text, tab_page_id)
-    if not header_text or header_text == "" then
+--- @param window_name string Window name for Config.windows[name].buffer_name lookup
+--- @param header_parts agentic.ui.ChatWidget.HeaderParts Header parts for function-type buffer_name
+local function set_buffer_name(
+    bufnr,
+    header_text,
+    tab_page_id,
+    window_name,
+    header_parts
+)
+    local name = resolve_buffer_name(window_name, header_parts, header_text)
+    if not name or name == "" then
         return
     end
 
@@ -210,9 +271,9 @@ local function set_buffer_name(bufnr, header_text, tab_page_id)
     --- @type string|nil
     local buf_name
     if total_tabs > 1 then
-        buf_name = string.format("%s (Tab %d)", header_text, tab_page_id)
+        buf_name = string.format("%s (Tab %d)", name, tab_page_id)
     else
-        buf_name = header_text
+        buf_name = name
     end
 
     vim.api.nvim_buf_set_name(bufnr, buf_name)
@@ -263,7 +324,13 @@ function WindowDecoration.render_header(bufnr, window_name, context)
         local text = (header_text and header_text ~= "") and header_text or ""
 
         set_winbar(winid, text)
-        set_buffer_name(bufnr, header_text, tab_page_id)
+        set_buffer_name(
+            bufnr,
+            header_text,
+            tab_page_id,
+            window_name,
+            dynamic_header
+        )
     end)
 end
 

tests/integration/test_buffer_naming.lua

@@ -78,6 +78,47 @@ end)()
         assert.equal(5, session_count)
     end)
 
+    it("uses custom buffer_name from windows config when set", function()
+        child.lua([[
+            require("agentic").setup({ windows = { chat = { buffer_name = "My Chat" } } })
+            require("agentic").toggle()
+        ]])
+        child.flush()
+
+        local basename = get_panel_basename("chat")
+        assert.is_true(vim.startswith(basename, "My Chat"))
+    end)
+
+    it("uses buffer_name function to derive name from header parts", function()
+        child.lua([[
+            require("agentic").setup({
+                windows = {
+                    chat = {
+                        buffer_name = function(parts)
+                            return "Custom: " .. parts.title
+                        end,
+                    },
+                },
+            })
+            require("agentic").toggle()
+        ]])
+        child.flush()
+
+        local basename = get_panel_basename("chat")
+        assert.is_true(vim.startswith(basename, "Custom: 󰻞 Agentic Chat"))
+    end)
+
+    it("falls back to header title when buffer_name not set", function()
+        child.lua([[
+            require("agentic").setup({})
+            require("agentic").toggle()
+        ]])
+        child.flush()
+
+        local basename = get_panel_basename("chat")
+        assert.is_true(vim.startswith(basename, "󰻞 Agentic Chat"))
+    end)
+
     it("each panel has distinct buffer name prefix", function()
         child.lua([[ require("agentic").toggle() ]])
         child.flush()