Agent Session.Nvim — AI skill for Claude Code

agent-session.nvim

A Neovim plugin for managing multiple AI agent sessions (Claude Code, terminal agents, LLM CLI sessions) with floating windows, session switching, and lifecycle management.

https://github.com/user-attachments/assets/cd545acf-2252-4ef8-a37d-2e7a003adb13

---

Features

• Multi-session management. Run and track multiple background AI agent processes.
• Interactive session tab bar. A browser-like tab bar at the top of the window shows every active session, its status icon (⚡/🟢/⚪, animated while running), and highlights the active one.
• Targeted prompting and session dispatch. Send prompts or commands to a specific agent by name or through an interactive picker, without switching windows.
• Session renaming and role tagging. Rename sessions to assign roles such as architect, coder, tester, or reviewer.
• Left sidebar session explorer. A side drawer, similar to Neo-tree or Aerial, to view, launch, rename, prompt, and manage sessions.
• Background task notifications. Get a native desktop notification through the host terminal (Warp, Ghostty, WezTerm, or iTerm2 via OSC 777 / OSC 9) or the OS notification center (macOS osascript, Linux notify-send) when a background agent session goes idle or exits.
• Floating and split windows. Toggle floating modal terminals or splits.
• Zoom and center full-view toggle. Switch between a right-side split (compact view) and a centered full-screen float (large reading view) with z or :AgentSessionZoom.
• Universal picker integration. Switch sessions through vim.ui.select (Telescope, Snacks, fzf-lua, dressing.nvim all work).
• Lazy.nvim, LazyVim, and AstroNvim ready. Setup and keymapping configuration with no boilerplate.

---

Installation and setup

Using [lazy.nvim](https://github.com/folke/lazy.nvim) / LazyVim / AstroNvim

Add the following spec to your plugin configuration (e.g. `lua/plugins/agent-session.lua`):

return {
  "yoch/agent-se