nvr-list

# List All Neovim Instances

## Purpose

Display all running neovim instances with their working directories, socket paths, and process IDs. Useful for understanding which projects have active editors and troubleshooting multi-project setups.

## When to Use This Skill

Use this skill when the user wants to see all neovim instances across all projects:

- "List all neovim instances"
- "Show me all running nvim"
- "What neovim processes are active?"
- "Which projects have editors open?"
- "Show all active neovim sessions"

## Active Instances (Auto-Captured)

**Total Instances**: !```nvr --serverlist 2>/dev/null | wc -l```
**Current Directory**: !```pwd```

## How to Use

Invoke the list script:

```bash
bash $CLAUDE_PLUGIN_ROOT/skills/list/scripts/list.sh
```

No arguments needed - the script discovers and lists all active neovim instances.

### Success Output

When instances are found:
```
Active neovim instances:

[/home/user/project-A]
  Socket: /run/user/1000/nvim.123.0
  PID: 123

[/home/user/project-B]
  Socket: /run/user/1000/nvim.456.0
  PID: 456
```

Present this information to the user, optionally highlighting which instance corresponds to the current working directory.

### No Instances Output

When no instances are running:
```
No neovim instances found
```

Inform the user that no neovim processes are currently running and suggest starting neovim if needed.

## Use Cases

### Use Case 1: Multi-Project Overview

**User**: "Show me all my neovim instances"
**Action**: Run list script
**Response**: Display all instances with their project directories

### Use Case 2: Troubleshooting Wrong Instance

**User**: "Why is the wrong neovim opening my files?"
**Action**: Run list script to show all instances
**Response**: Help user identify which instance is for which project

### Use Case 3: Before Starting New Instance

**User**: "Should I start neovim for this project?"
**Action**: Run list script to check existing instances
**Response**: Show if an instance al