# mhinz/neovim-remote

:ok_hand: Support for --remote and friends.

Repository: https://github.com/mhinz/neovim-remote
Canonical: https://ross.abutalabs.com/products/neovim-remote
Language: Python
License: MIT
License Family: permissive
Topics: neovim, remote-control
Last push: 2023-09-29T19:22:47+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3925, "days_push": 1069, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1904, forks 84 (observed 2026-08-28T04:05:51.774056+00:00)

## What it is
neovim-remote (nvr) is a Python command-line tool that controls running Neovim processes remotely via their RPC server addresses. It lets you open files, send keys, and evaluate VimL expressions in another nvim instance, including from within :terminal buffers.

## Use cases
- open files in an already-running neovim instance from another terminal
- edit files from within :terminal without spawning a nested nvim
- use nvr as git core.editor to edit commit messages in an existing nvim
- send keystrokes to a remote nvim buffer from the shell
- evaluate VimL expressions in a running nvim process and get results
- open files in a split window of a running nvim

## When to choose
- you work with multiple terminal windows and want one shared nvim instance
- you frequently edit files from nvim's built-in terminal
- you want git commit messages to open in your existing nvim session

## When to avoid
- you don't use Neovim (it relies on nvim's RPC server)
- you need a solution on Windows, since spawning new processes via forking is unsupported
- you want a GUI editor integration rather than shell-based control

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: developer-tools, cli
- domain: developer-tools, text-editors
- platform: cli, python
- tags: neovim, remote-control, nvr, editor-integration, git-integration, command-line, linux, macos

## Member repositories
- mhinz/neovim-remote (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:51.774056+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:11:51.491987+00:00, confidence not recorded.
  - readme: https://github.com/mhinz/neovim-remote (fetched 2026-08-28T04:05:51.774056+00:00, sha 686441cbf8a2)
  - registry_pypi: https://pypi.org/pypi/neovim-remote/json (fetched 2026-08-29T10:50:47.049592+00:00, sha 193203e5ed5b)
- Data as of 2026-08-30T08:39:29.467469+00:00.
