xynovim

• Two diagnostic tiers: rust-analyzer answers while you type, clippy follows about half a second later, on every keystroke and before any save.

• A debugger and a test runner that look like the ones in an IDE: breakpoints with Rust-aware variable views, a test summary tree, coverage in the gutter.

• A safety net: every save is snapshotted as a git ref (a “Local History”), and the AI agent runs inside a sandbox.

• Treesitter everywhere: sticky scope, text objects, SQL injected into sqlx strings, a live syntax-tree view.

• Tested: 906 passing checks across 32 spec files, one per feature area, runnable with one command after a clone (below).

Standalone

• xyno-history.nvim

  Local History for Neovim: every throttled save is snapshotted into private git refs, so deletions, resets and bad edits can be recovered.

  Needs Neovim 0.12+, git; no other plugin

  Linux tested; Windows and macOS not verified

  { "xynorash/xyno-history.nvim", event = "VeryLazy", opts = {} }

  Repository of xyno-history.nvim Release v0.1.0 of xyno-history.nvim

• xyno-sandbox.nvim

  Runs a command-line coding agent inside a bubblewrap sandbox and refuses to start it without one. Linux only.

  Needs Neovim 0.12+, Linux with bubblewrap (bwrap); no other plugin

  Linux only

  {
    "xynorash/xyno-sandbox.nvim",
    cmd = { "XynoSandboxStatus", "XynoSandboxRun" },
    opts = {},
  }

  Repository of xyno-sandbox.nvim Release v0.1.1 of xyno-sandbox.nvim

• xyno-clipboard.nvim

  A clipboard provider for sessions whose yanks must reach another machine: tmux, SSH and herdr panes get OSC 52 copy, with no change anywhere else.

  Needs Neovim 0.12+, Linux; wl-copy and wl-paste optional

  Linux only

  {
    "xynorash/xyno-clipboard.nvim",
    lazy = false, -- the provider should exist before the first yank
    opts = {},
  }

  Repository of xyno-clipboard.nvim Release v0.1.0 of xyno-clipboard.nvim

• xyno-guard.nvim

  Keeps auto-save away from files it must never write: dependency and standard-library sources, files changed on disk, and similar. Works with any auto-save plugin.

  Needs Neovim 0.12+; an auto-save plugin with a condition function (I use okuuva/auto-save.nvim)

  Linux tested; Windows and macOS not verified

  {
    "okuuva/auto-save.nvim",
    event = { "InsertLeave", "TextChanged", "TextChangedI" },
    dependencies = { "xynorash/xyno-guard.nvim" },
    opts = function()
      require("xyno_guard").setup()
      return { condition = require("xyno_guard").can_save }
    end,
  }

  Repository of xyno-guard.nvim Release v0.1.0 of xyno-guard.nvim

Rust toolkit

• xyno-rust.nvim

  Rust project plumbing for Neovim: a per-project Cargo context, a targets picker, an HTTP route picker, navigation helpers, language-server restart handling and a statusline readiness indicator.

  Needs Neovim 0.12+, cargo, snacks.nvim for the pickers; rust-analyzer for the navigation helpers

  Linux tested; Windows and macOS not verified

  {
    "xynorash/xyno-rust.nvim",
    dependencies = { "folke/snacks.nvim" }, -- pickers and terminals
    ft = "rust",
    cmd = { "RustContext", "RustTargets", "RustTools", "RustRoutes", "RustNew", "RustRestart", "ActJob" },
    opts = {},
  }

  Repository of xyno-rust.nvim Release v0.1.0 of xyno-rust.nvim

• xyno-new.nvim

  New Rust projects from inside Neovim: a binary, a library, a workspace or an egui app, each behind a few guarded prompts.

  Needs xyno-rust.nvim, Neovim 0.12+, cargo; git optional; curl and unzip for :EguiNew

  Linux tested; Windows and macOS not verified

  {
    "xynorash/xyno-new.nvim",
    dependencies = { "xynorash/xyno-rust.nvim" },
    cmd = { "RustNewBin", "RustNewLib", "RustNewWorkspace", "RustNewMember", "EguiNew" },
    opts = {},
  }

  Repository of xyno-new.nvim Release v0.1.0 of xyno-new.nvim

• xyno-imports.nvim

  Imports without the menu for Rust: auto-import of unresolved names, ranked disambiguation with a per-project memory, and organize imports, on top of rust-analyzer code actions.

  Needs xyno-rust.nvim, Neovim 0.12+, cargo, rust-analyzer, tree-sitter rust parser

  Linux tested; Windows and macOS not verified

  {
    "xynorash/xyno-imports.nvim",
    dependencies = { "xynorash/xyno-rust.nvim" },
    ft = "rust",
    cmd = { "ImportName", "ImportForget", "ImportOrganize" },
    opts = {},
  }

  Repository of xyno-imports.nvim Release v0.1.0 of xyno-imports.nvim

• xyno-crates.nvim

  Cargo dependencies from inside Neovim: search crates.io, add crates with their features, enable a missing feature from a code action, and import from crates that are not dependencies yet.

  Needs xyno-rust.nvim, xyno-imports.nvim, snacks.nvim, Neovim 0.12+, cargo, network for crates.io

  Linux tested; Windows and macOS not verified

  {
    "xynorash/xyno-crates.nvim",
    dependencies = {
      "xynorash/xyno-rust.nvim",
      "xynorash/xyno-imports.nvim",
      "folke/snacks.nvim", -- pickers
    },
    ft = "rust",
    cmd = { "CrateAdd", "CrateFeatures" },
    opts = {},
  }

  Repository of xyno-crates.nvim Release v0.1.0 of xyno-crates.nvim

• xyno-macros.nvim

  Rust macro help in Neovim: completion inside helper attributes and derives (serde, clap, tokio, sqlx and more), macro_rules! signature help, :MacroExpand and proc-macro status.

  Needs xyno-rust.nvim, xyno-imports.nvim, Neovim 0.12+, cargo, rust-analyzer; blink.cmp optional

  Linux tested; Windows and macOS not verified

  {
    "xynorash/xyno-macros.nvim",
    dependencies = { "xynorash/xyno-rust.nvim", "xynorash/xyno-imports.nvim" },
    ft = "rust",
    cmd = { "MacroExpand", "MacroFormatFix", "MacroSignature", "ProcMacroStatus", "MacroAttrs" },
    opts = {},
  }

  Repository of xyno-macros.nvim Release v0.1.0 of xyno-macros.nvim

All nine plugins, the full install spec and the FAQ

• 32spec files
• 906checks passing
• 35skipped with a stated reason
• 0failing

scripts/test.sh                  # everything (or: make test)
scripts/test.sh routes smoke     # only spec files whose path contains one of the words
scripts/test.sh --list           # the spec files, nothing run
scripts/test.sh --coverage       # also a per-file line-coverage report

• Nothing of yours is touched: the specs run against a temp config / state / cache. Missing tools (rust-analyzer, tmux, bubblewrap, lazygit, ...) make their specs skip with a message, never fail.
• One spec per feature area: tests/COVERAGE.md maps every feature to the spec that tests it and lists what has no test and why.
• CI: the ci workflow bootstraps the plugins on their locked commits, runs a startup smoke test and the whole suite on a clean Ubuntu machine for every push.
• How the harness works and how to write a spec: docs/TESTING.md.

git clone https://github.com/xynorash/xynovim ~/.config/nvim   # or ln -s <checkout> ~/.config/nvim
~/.config/nvim/scripts/bootstrap.sh

Platforms

The shell scripts are bash conveniences for Linux and macOS, with PowerShell counterparts for Windows (scripts/bootstrap.ps1). The config itself is Lua and is meant to run wherever Neovim 0.12 runs with the prerequisites. What CI shows, and no more:

• Linux: developed on (Arch), fully tested. Ubuntu ci run 39695896272: 1749 passed, 0 failed, 76 skipped.
• Windows: the plugin restore from the lockfile, a silent headless start and the specs that are not Linux-only pass. platforms run 39673715062: 1077 passed, 0 failed, 87 skipped; 10 of the 38 spec files are skipped whole there and not demonstrated. Green in 5 of the 6 runs from 39660597368 on (the one red run was a spec path assertion, fixed afterwards).
• macOS: not reliably green. Neovim starts and most specs pass, but the job did not pass in 4 of the 5 runs that finished from 39660597368 on (green once: run 39663956677, 1431 passed, 0 failed, 73 skipped).
• Linux only by design: the 99 agent sandbox (bubblewrap; without it 99 refuses to run), the remote clipboard, the tmux-based and bash-stub test tooling (scripts/test.sh) and the mold linker setup.
• Not demonstrated on Windows or macOS: Local History, startup options, new Rust and egui project creation, live rust-analyzer flows on Windows, and debugging through codelldb. docs/KNOWN_ISSUES.md has the list.

Keys you will use

Commands

• :RustContext
• :RustTargets
• :RustTools
• :RustNew
• :RustNewBin
• :RustNewLib
• :RustNewWorkspace
• :RustNewMember
• :EguiNew
• :RustRoutes
• :RustRestart
• :CrateAdd
• :CrateFeatures
• :ImportName
• :ImportForget
• :ImportOrganize
• :MacroAttrs
• :MacroExpand
• :MacroSignature
• :MacroFormatFix
• :ProcMacroStatus
• :ActJob
• :LocalHistory
• :LocalHistoryRestore
• :LocalHistoryPrune
• :ColorblindDiagnostics
• :checkhealth xynovim

Plugin management is stock LazyVim: :Lazy sync updates (the update checker is off), :LazyExtras toggles extras, :Mason manages language servers.

• Neovim 0.12; developed on Linux. Windows is exercised in CI and macOS is not reliably green (Platforms). The previous from-scratch Windows config lives on the windows-legacy branch.
• The agent sandbox is a seatbelt, not a jail. The network stays open, and no real request to the agent was driven in the test suite.
• The macros and dependencies work is tested headless. The suite uses real cargo and rust-analyzer, but the pickers and key presses were not driven in a real terminal; the unknown-crate hint is deliberately conservative (a miss is better than a false hint), and a “(guess)” import can miss.
• Two Neovim instances on the same workspace share bacon-ls’s shadow, so one’s unsaved text can show up as clippy errors in the other (upstream; open one Neovim per workspace). A multi-file rename is undone per buffer: use <leader>gH local history to revert it.

The complete list, with what was decided and why: docs/KNOWN_ISSUES.md.

• Rust diagnosticsHow xynovim gets Rust errors on screen while you type: rust-analyzer for instant type errors, clippy through bacon-ls half a second later, before any save.
• Rust debuggingSet breakpoints, read Rust values and stop at panics in Neovim: the nvim-dap and codelldb setup of xynovim, with the debuginfo setting that makes locals work.
• Tests and coverageRun Rust tests from Neovim with neotest and cargo-nextest, read a summary tree, and see line coverage from cargo-llvm-cov in the gutter, on demand.
• Workspaces, features, cratesCreate Rust binaries, libraries and workspaces, add crates with their features and fix missing derive features from Neovim: :CrateAdd, :CrateFeatures and more.
• Git safety netEvery save in Neovim written as a git ref you can restore, plus lazygit and diffview: how xynovim recovers deleted files and edits that undo cannot bring back.
• Island Dark themeIsland Dark is the dark colour scheme of xynovim: a generated palette mapped to Treesitter captures, LSP tokens and the plugins in use, tuned for contrast.

• README.mdthe overview this site is built from
• docs/DETAILS.mdthe engineering notes behind each setting, what was measured and what was not verified
• docs/KNOWN_ISSUES.mdlimitations that were found and deliberately left alone
• docs/TESTING.mdhow the test harness works and how to write a spec
• tests/COVERAGE.mdwhich spec tests which feature, and what has no test and why
• docs/PLAN_MACROS_DEPS.mdthe assessment behind the macros and dependencies work and what of the plan is done
• CHANGELOG.mdevery notable change