how to install nvim-nu with Lazy.nvim

Add the plugin to your Lazy.nvim config with 'build = :TSInstall nu' and call setup, as shown in the README's installation snippet—this automatically installs the treesitter parser for seamless integration.

does nvim-nu work with nushell 0.50 or later

It was made for nu version ~0.45 and might not function perfectly with newer versions, as noted in the README; you may need to check for updates or contribute PRs to maintain compatibility.

nvim-nu vs a full nushell LSP server

nvim-nu is lighter, using null-ls.nvim for basic features like hover and completion, whereas a dedicated LSP server would offer more capabilities but requires additional setup and maintenance.

how to enable hover documentation in nvim-nu

Install null-ls.nvim, set 'use_lsp_features = true' in setup, and map a key like 'K' to vim.lsp.buf.hover in your ftplugin/nu.lua, following the README's configuration guidance.

why isn't hover working for subcommands in nvim-nu

This is a known issue listed in the README—hover only works for top-level commands, not subcommands, and requires community fixes via PRs.

can nvim-nu autocomplete nushell variables or arguments

No, it only supports command name completion via the 'all_cmd_names' config, as specified in the README; variable or argument completion isn't included in its current feature set.

nvim-nu

GPL-3.0Lua

A Neovim plugin providing syntax highlighting, LSP features, and editor support for the nushell language.

GitHub

160 stars12 forks0 contributors

What is nvim-nu?

nvim-nu is a Neovim plugin that provides basic editor support for the nushell language, including syntax highlighting and optional LSP features like hover documentation and command completion. It solves the problem of lacking integrated editor tools for nushell scripting within Neovim, making it easier to write and maintain nushell scripts.

Target Audience

Neovim users who work with nushell scripts, including system administrators, DevOps engineers, and developers using nushell for shell scripting and automation.

Value Proposition

Developers choose nvim-nu because it seamlessly integrates nushell support into Neovim using established plugins like nvim-treesitter and null-ls.nvim, offering a lightweight, configurable solution without requiring a full standalone LSP server.

Overview

Basic editor support for the nushell language

Use Cases

Best For

Writing and editing nushell scripts in Neovim
Adding syntax highlighting for nushell files via treesitter

Related Projects

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

Enabling hover documentation for nushell commands in Neovim

Autocompleting nushell command names in editor

Integrating nushell support into a Neovim-based development workflow

Maintaining nushell scripts with basic LSP features

Not Ideal For

Users working with nushell versions significantly beyond 0.45, due to potential compatibility breaks
Developers needing full LSP features like go-to-definition, diagnostics, or refactoring support
Neovim setups aiming for minimal plugin dependencies or zero-configuration environments
Teams requiring stable, production-ready editor tools with guaranteed long-term maintenance

Pros & Cons

Pros

Accurate Syntax Highlighting

Integrates with nvim-treesitter to provide precise syntax highlighting for nushell files, ensuring code readability and correctness directly from the README's reliance on this plugin.

Lightweight LSP Features

Uses null-ls.nvim to enable hover documentation and command name completion without a full LSP server, offering essential editing aids as described in the configuration section.

Easy Installation

Supports popular package managers like Lazy.nvim and vim-plug with automatic treesitter parser installation, making setup straightforward per the installation examples.

Customizable Configuration

Allows users to tweak LSP features and completion sources via a simple setup function, such as defining command lists dynamically, as shown in the default settings.

Cons

Version Compatibility Issues

Built for nushell version ~0.45 and may not work with newer releases, as the README explicitly warns, relying on community PRs for updates.

Limited LSP Support

Only offers hover and command completion, with known bugs like hover failing on subcommands, and lacks advanced features like diagnostics or code navigation.

Dependency on External Plugins

Requires nvim-treesitter and optionally null-ls.nvim, adding setup complexity and potential breakpoints for minimal Neovim configurations.

Frequently Asked Questions

Home

Neovim

nvim-treesitter

Nvim Treesitter configurations and abstraction layer

Stars13,937

Forks1,405

Last commit1 month ago

nvim-surround

Add/change/delete surrounding delimiter pairs with ease. Written with :heart: in Lua.

Stars4,220

Forks78

Last commit29 days ago

nvim-treesitter-textobjects

nvim-treesitter-textobjects is a Neovim plugin that leverages Tree-sitter's parsing capabilities to define and manipulate text objects based on the abstract syntax tree (AST) of your code. It enables precise, language-aware editing operations, moving beyond simple regex-based text objects to understand the actual structure of programming languages. ## Key Features - **Syntax-Aware Selection** — Define custom text objects (like `@function.inner` or `@class.outer`) for precise selection within syntactic structures. - **Intelligent Movement** — Jump between text objects (e.g., functions, classes, loops) with mappings that understand code hierarchy. - **Node Swapping** — Swap adjacent syntactic nodes (like parameters or arguments) with simple commands. - **Repeatable Actions** — Make movements repeatable with `;` and `,` for efficient navigation. - **Extensible Queries** — Override or extend built-in textobjects by adding custom Tree-sitter query files. - **Multiple Modes** — Support for charwise, linewise, and blockwise selection modes per text object. ## Philosophy The plugin embraces Tree-sitter's accuracy to provide text objects that are deeply integrated with the language's syntax, offering a more reliable and intuitive editing experience compared to traditional pattern-based approaches.

Stars2,774

Forks265

Last commit1 month ago