KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

home-manager.nvim

★ 32 Open GitHub ↗

A neovim plugin to help edit and maintain a nix home-manager configuration

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Home Manager
This neovim plugin provides a few commands to help edit and maintain a nix home-manager environment

# Installation
Vim plug:
```
Plug 'nvim-lua/plenary.nvim'
Plug 'protex/home-manager.nvim'
```

You'll also obviously need nix and home-manager present on your system.

### Other dependencies
This plugin uses `xxd` and `base64` binaries which are standard on most linux operating systems, but if you're using a non-standard linux operating system you'll need to make sure they're installed.

### Why no home-manager installation?
I like home manager a lot. But, my philosophy with it is that a dotfile manager should manage your dotfiles, not replace them. I firmly believe that instead of re-implementing all of the complex and highly customizable configuration that one can accomplish using neovim, home-manager should just help you pull in your existing configuration. Thus, my recommendation is to install neovim as a package and link your existing neovim dotfiles to "~/.config/nvim", relying as little as possible on home-manager to actually influence neovim itself. [Here](https://github.com/protex/home/blob/master/home.nix) is an example of how to do this. I install neovim as a package, add vim plugged, pull in my config, and let neovim do its thing.

That being said, I am not opposed to someone making a PR to add steps to the readme.

# Usage
The plugin provides three commands

`HomeManager`
Exactly like executing `home-manager` in the shell but output will be placed in a nice popup window. Tab completion is also provided.

`HomeManagerPrefetchSha256`:

When the cursor is positioned in a fetchFromGithub statement like the following:
```
    source = pkgs.fetchFromGitHub {
      owner = "zsh-users";
      repo = "zsh-autosuggestions";
      rev = "v0.4.0";
      sha256 = "bBqJCkhygrXqAfWBsvUNpXu9IrwLyn/ypmTRKSVP0Xw=";
    };
```
it will prefetch the resource and add/update the sha256 value

`HomeManagerBuild (deprecated)`:
This command will run `home-manager build --no-out-link`, and print the output in a popup window

`HomeManagerSwitch (deprecated)`:
This command will run `home-manager switch`, and print the output in a popup window

## Output Highlighting
The output popup has basic highlighting setup. Currently, lines that beging with 'Activating' are highlighted, as well as any lines that contain '[Ee]rror' or '[Ww]warning'. I tried to find more highlights that home manager applies on its own, but was unable to find any more then I just mentioned. So, there is a way to add new highlight groups and regular expressions should you notice something that should be highlightd but isn't. To do this, create a dictionary that follows the following format:
```
vim.g.HomeManagerHighlights = {
  {
    groupName = 'HomeManagerInfo',
    color = 'cyan',
    reg = '^Activating'
  },
  {
    groupName = 'ErrorMsg',
    reg = '[Ee]rror'
  },
}
```
Color is optional (example 2) if the highlight group already exists (see `:h highlight-groups`). Reg is a vim regular expression and any valid vim regular expression should work. Keep in mind that the regular expression is only applied on a *per line basis*.

# Issues
This is very much a work in progress and has very little error checking. If you run into any problems, or have a suggestion, please submit an issue.

home-manager.nvim

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README