Skip to content
<awesome-gh-repos>
vic

water-sucks/optnix

[mirror] - an options searcher for nix module systems
Source code at GitHub https://water-sucks.github.io/optnix/
water-sucks/optnix.json
{
  "createdAt": "2025-01-15T22:29:57Z",
  "defaultBranch": "main",
  "description": "[mirror] - an options searcher for nix module systems",
  "fullName": "water-sucks/optnix",
  "homepage": "https://water-sucks.github.io/optnix/",
  "language": "Go",
  "name": "optnix",
  "pushedAt": "2025-11-01T07:25:27Z",
  "stargazersCount": 79,
  "topics": [],
  "updatedAt": "2025-11-18T09:33:41Z",
  "url": "https://github.com/water-sucks/optnix"
}

optnix

An options searcher for Nix module systems.

Introduction

Section titled “Introduction”

optnix is a fast, terminal-based options searcher for Nix module systems.

![a demo of optnix]!(./doc/src/demo.gif)

There are multiple module systems that Nix users use on a daily basis:

And their documentation can be hard to look for. Not to mention, any external options from imported modules can be impossible to find without reading source code. optnix can solve that problem for you, and allows you to inspect their values if possible; just like nix repl in most cases, but better.

There is a website for high-level documentation available at https://water-sucks.github.io/optnix.

This repository is hosted on [sr.ht]!(sr.ht/~watersucks/optnix), with an official mirror on GitHub.

Install

Section titled “Install”

optnix is available in nixpkgs.

More installation instructions can be found on the website.

Integrations

Section titled “Integrations”

optnix can be used as a Go library, and is used as such in the following applications.

nixos-cli

Section titled “nixos-cli”

optnix is used as a library in the nixos option subcommand of nixos-cli.

nixos option requires zero configuration for discovery of NixOS options.

Contributing

Section titled “Contributing”

Prefer emailing patch sets to the [official development mailing list]!(mailto:~watersucks/optnix-devel@lists.sr.ht).

While the official repository is located on sr.ht, contributions are also accepted through GitHub using the official mirror, if desired.

Additionally, filing GitHub issues is fine, but consider using the official issue tracker on sr.ht. All issues from GitHub will be mirrored there by me anyway.