claude-code.nvim

🤖 claude-code.nvim

A streamlined Neovim plugin for seamlessly using Claude Code with git worktree support.

🎬 Demo

*Watch the complete workflow: worktree creation, Claude integration, and real-time session management*

✨ Features

🎯 Core Features
- One-key Claude toggle with cc - instant access to Claude CLI
- Per-worktree Claude sessions - each git worktree gets its own independent Claude instance
- Real-time session monitoring - see all Claude sessions at a glance
- Seamless worktree management - create, switch, and manage worktrees from Neovim
- nvim-tree integration - worktree operations directly from the file explorer

🚀 Advanced Features
- Live session monitor - dedicated window showing all Claude sessions in real-time
- Independent terminal sessions - each worktree maintains its own Claude CLI state
- Automatic context switching - Claude sessions automatically update when switching worktrees
- Clean interface - minimal, distraction-free design

📦 Installation

Using lazy.nvim

Using packer.nvim

🎮 Usage

Basic Operations

Git Worktree Management

nvim-tree Integration

When in nvim-tree buffer:

📊 Real-time Session Monitor

Press cm to toggle the Claude sessions monitor:

- ● = Claude CLI running
- ◑ = Claude waiting for user input
- ◐ = Terminal ready (Claude not active)
- ○ = No session
- \* = Currently visible session
- Auto-refresh every 2 seconds

🔄 Workflow Examples

Creating a new feature branch

1. Create worktree: cw → select "Create new worktree"
2. Open Claude: cc (automatically creates session for this worktree)
3. Monitor sessions: cm to see all active Claude sessions
4. Switch between features: cw to change worktrees, Claude sessions switch automatically

Working with multiple features

1. Start monitor: cm to see all sessions
2. Switch…