# Nina — A helper that makes NixOS a cozier place to live. Search, install, generations, services, flakes, multi-machine management etc
**URL:** https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070
**Category:** Links
**Created:** [June 5, 2026, 4:11pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070 "2026-06-05T16:11:24Z")
**Posts on this page:** 20
**Page:** 1
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 5, 2026, 4:11pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/1 "2026-06-05T16:11:24Z")
# Nina: NixOS Intuitive Navigation Assistant
* * *
Hey guys, [June](https://asha.software/) here! I’ve been building Nina for a while because NixOS became my favorite linux distro to use but the command surface is brutal and confusing with way too many layers of abstraction.
_I have actually some really exciting ambitious things planned for NixOS as a whole but i’ll talk more about that at a later date!_
**UPDATE: My account is under review and i can’t reply to comments. I have resolved the flake.lock and archive list issues. Thankyou for bringing them to my attention!** \*
Nina wraps the full NixOS command surface in plain memorable verbs. One binary, zero dependencies, written in Zig 0.16.
The search widget is the part I’m most proud of — it opens inline, results scroll with you as you navigate, you can backspace and search for something else without leaving. No more switching to the browser and searching the nixpkgs site for everything.
Install on NixOS:
```auto
curl -fsSL kepr.uk/nina/install.sh | sh
koh steal kepr.uk/nina && koh build
```
Source at [nina — kepr](http://kepr.uk/nina) .
More info and Documentation available at [nina - homepage](https://nina.asha.software)
Built by [Asha Software](https://asha.software) — a privacy-first indie studio.
`llm` — used Claude as an implementation partner. Architecture and all decisions are mine. Every agent save is attributed and auditable in the history.
---
### Author:  [@adomixaszvers](https://discourse.nixos.org/u/adomixaszvers)
#### Post date: [June 5, 2026, 7:44pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/2 "2026-06-05T19:44:20Z")
I see that the source code is available at [https://kepr.uk/nina/archive/HEAD.tar.gz](https://kepr.uk/nina/archive/HEAD.tar.gz) . Is the any way to pin it to a particular commit/save? And also there is no flake.lock file so it is not a proper flake. But it builds with `--no-write-lock-file`
```shell
❯ nix build --no-link --print-out-paths --no-write-lock-file https://kepr.uk/nina/archive/HEAD.tar.gz
warning: not writing modified lock file of flake 'https://kepr.uk/nina/archive/HEAD.tar.gz':
• Added input 'nixpkgs':
'github:NixOS/nixpkgs/331800de5053fcebacf6813adb5db9c9dca22a0c?narHash=sha256-x5UQuRsH3MqI0U9afaXSNqzTPSeZlRLvFAav2Ux1pNw%3D' (2026-05-31)
/nix/store/aqdkla6ni9n07m5zis8b51wxx447qfr7-nina-3.0.15
```
---
### Author:  [@dtomvan](https://discourse.nixos.org/u/dtomvan)
#### Post date: [June 6, 2026, 12:19am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/3 "2026-06-06T00:19:24Z")
Apparently the snapshot list is here: [nina — kepr](https://kepr.uk/nina?panel=archives)
So HEAD as of writing this could also be retrieved thru [https://kepr.uk/nina/archive/e4b3b0360ecc.tar.gz](https://kepr.uk/nina/archive/e4b3b0360ecc.tar.gz)
---
### Author:  [@mightyiam](https://discourse.nixos.org/u/mightyiam)
#### Post date: [June 7, 2026, 3:26pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/4 "2026-06-07T15:26:31Z")
Thank you for sharing!
Did anyone try this and willing to share impressions?
---
### Author:  [@qweered](https://discourse.nixos.org/u/qweered)
#### Post date: [June 7, 2026, 11:16pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/5 "2026-06-07T23:16:21Z")
Why not host source code on github so it can be audited and packaged in nixkpgs?
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 8, 2026, 12:53am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/6 "2026-06-08T00:53:27Z")
Sorry for the late response but thanks for bring that one to my attention, I have since resolved it. Specific saves are available to be pinned now and the flake.lock was fixed
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 8, 2026, 12:56am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/7 "2026-06-08T00:56:46Z")
I personally do not use git or github and they were not the ideal fit for my workflow, I also do not wish to support or use anything that Microsoft has control of. That is why I created my own version control system and source hosting platform to adapt to how I work. However the source being on Github is not a requirement as far as I understand to be added to nixpkgs. It seems like you just need a stable tarball url and hash, both of which are provided by Kepr. If a community member would like to open a PR for this they absolutely can.
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 8, 2026, 12:57am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/8 "2026-06-08T00:57:40Z")
I think you might have to take one for the team hahah
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 8, 2026, 12:58am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/9 "2026-06-08T00:58:54Z")
I’m still unable to update the post at the moment but I wanted to clarify that the install script is actually discontinued and now installing nina is as simple as
`nix profile add https://kepr.uk/nina/archive/HEAD.tar.gz`
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 8, 2026, 1:08am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/10 "2026-06-08T01:08:40Z")
One more thing, please feel free to file [issues on Kepr](https://kepr.uk/nina?panel=issues) if you encounter any weird stuff or problems with nina! I am trying to make Kepr easy and pleasant to use. You do not need any account or anything to file an issue, it takes only a moment to do so, no friction.
---
### Author:  [@adamdicarlo](https://discourse.nixos.org/u/adamdicarlo)
#### Post date: [June 10, 2026, 12:33am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/11 "2026-06-10T00:33:44Z")
I like it! Having `nina service logs ` is very nice, since `systemctl` doesn’t have a log command (I’ve never liked having to use `journalctl` instead and remember the flags).
The interactive package search with tryout option is also awesome.
I have some feature requests 😄
- Store the config file in `$XDG_CONFIG_HOME/` instead of in my home dir
- Support flake-based system configuration for rollbacks and such – and, ideally, disable channel commands for flake-based systems. It’d be nice if the first-time-run “where’s your configuration?” prompts accounted for this – like, asking whether you’re using a flake or not. I found the prompts really confusing. I just put ~/nixos-config for both prompts, since that’s where my git clone of my nixos configs resides. But I don’t think it’s making any use of that config since I’m using a flake…? (Or maybe `nina list` does?)
- `nina why ` to tell me what package(s)/derivation(s) caused a certain package to be installed
- Show a help message when a command is missing a sub-command, like `nina flake` (bonus, make `nina flake help` also show the help) - so I can discover how to use it directly on the command line
- `nina service --user logs `
- Support (flake-based) home manager configuration
I am very happy with `nh` as a wrapper for rebuilding my system and home-manager configurations, but I haven’t really had to do rollbacks or anything… I’d love to use nina for that.
Nice job on Nina, it’s already quite nice!
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 10, 2026, 12:56am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/12 "2026-06-10T00:56:13Z")
Thanks for the feedback! Check back around tomorrow morning or so and everything but home manager will be done. I intended to add support anyway. So all of it will be taken care of shortly! I want nina to be an excellent experience for everyone and I’m glad you enjoy her!
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 10, 2026, 2:29pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/14 "2026-06-10T14:29:34Z")
**Nina — What’s New**
**v3.1.3** — Flake and Home Manager support
**Home Manager**
A new `nina home` command group manages your Home Manager configuration alongside your system. All commands work with both standalone and NixOS module setups.
```auto
nina home apply apply your home configuration
nina home apply --dry preview changes without applying
nina home back roll back to the previous home generation
nina home history list all home manager generations
nina home diff what changed between generations
nina home check validate without applying
nina home edit open home.nix in your editor
nina home packages list packages managed by home manager
```
`nina status` and `nina doctor` now show your Home Manager generation and health alongside system information.
**Flake-aware system commands**
`nina apply` and `nina upgrade` now detect whether your config directory contains a `flake.nix` and use the correct rebuild path automatically. No configuration needed — it just works.
The setup wizard scans for `flake.nix` on first run and configures itself accordingly. Channel commands note themselves as irrelevant on flake systems and point you to `nina flake update` instead.
* * *
**v3.0.24** — Community feedback improvements
- Config now stored at `~/.config/nina/config` following XDG conventions. Existing `~/.nina.conf` is migrated automatically on first run.
- `nina why ` added as a top-level alias for `nina pkg why`
- `nina flake`, `nina service`, `nina store`, `nina channel`, `nina gen`, and `nina pkg` now show a subcommand list when called with no arguments
- All service commands support `--user` for user-managed systemd services
---
### Author:  [@adamdicarlo](https://discourse.nixos.org/u/adamdicarlo)
#### Post date: [June 10, 2026, 7:45pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/15 "2026-06-10T19:45:00Z")
Awesome, wow! Thanks so much. I’m trying it out now and am adding nina as an input to my main flake! 🙂
I’m finding some issues, so I will file reports on kepr.
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 10, 2026, 9:31pm UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/16 "2026-06-10T21:31:58Z")
No thank you Adam for the great suggestions and for your patience!
Your issue should be fixed in the latest build now. All five nina pkg commands now resolve packages as nixpkgs# consistently. Verified on a VM matching your setup, including the exact ffmpeg cases. Let me know if its all good on your end now!
---
### Author:  [@Thomashighbaugh](https://discourse.nixos.org/u/Thomashighbaugh)
#### Post date: [June 11, 2026, 12:22am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/17 "2026-06-11T00:22:38Z")
Like the way this manages things with arrow key navigation for search queries and is seems, at a glance, comprehensive in providing nix features.
I also really like this wraps other commands into the wrapper, to ease actual system use and not just using the nix subcommands and maybe bundling in flags. Helper scripts can be hard to write because anticipating use cases and patterns is hard but this one looks better than the others intended for community use.
Also noticed the use of zig, very nice. Been meaning to write something in it.
Not the biggest fan of the site and kepr repo’s fonts + color schemes but that is my arbitrary preferences and doesn’t detract from the overall high quality project. Great work.
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 11, 2026, 12:30am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/18 "2026-06-11T00:30:29Z")
Appreciate your feedback Thomas. I hope nina will be really useful to people and help bring more to NixOS which has quite the learning curve!
---
### Author:  [@cambria](https://discourse.nixos.org/u/cambria)
#### Post date: [June 12, 2026, 11:12am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/19 "2026-06-12T11:12:38Z")
> [@ashasoftware](#):
>
> I also do not wish to support or use anything that Microsoft has control of.
I personally do not wish to support or use anything that Anthropic has tainted, so I understand the desire to avoid Microsoft when possible.
> That is why I created my own version control system and source hosting platform to adapt to how I work.
Making your own personal VCS is neat and probably also a great learning experience.
You could potentially mirror the source code to codeberg or gitlab so that it’s available for more people to discover and audit.
---
### Author:  [@ashasoftware](https://discourse.nixos.org/u/ashasoftware)
#### Post date: [June 13, 2026, 12:37am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/20 "2026-06-13T00:37:49Z")
**Nina — What’s New (v3.2.x)**
**Lifecycle hooks**
Pre and post hooks for `apply`, `back`, `home apply`, and `upgrade`. Drop executable shell scripts in `~/.config/nina/hooks/` — nina runs them and checks the exit code before and after each operation.
```auto
# ~/.config/nina/hooks/pre-apply
# example: check for uncommitted changes before applying
if koh status | grep -q "unsaved changes"; then
echo "unsaved changes — save before applying"
exit 1
fi
```
If a pre-hook fails, nina warns and asks whether to continue. Post-hook failure shows a warning without affecting the command result.
**Plain-english error messages**
Build errors are no longer raw nix output. 25 known error patterns are translated to plain english with a specific suggestion. Unknown errors are structured and stripped of noise. You always get a calm, readable response — never a wall of nix machinery. Working to extend to more error patterns
**Live build panel**
`nina apply` and `nina upgrade` now show a live panel while the system rebuilds — the current package name updating in place and a colored progress bar.
---
### Author:  [@dtomvan](https://discourse.nixos.org/u/dtomvan)
#### Post date: [June 13, 2026, 11:38am UTC](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070/21 "2026-06-13T11:38:36Z")
> [@ashasoftware](#):
>
> Build errors are no longer raw nix output. 25 known error patterns are translated to plain english with a specific suggestion. Unknown errors are structured and stripped of noise. You always get a calm, readable response — never a wall of nix machinery. Working to extend to more error patterns
Now _that_ seems like a great idea! I have been a bit skeptical about this, since some mapping seem entirely redundant: `nix flake update` → `nina flake update`, `nix develop` → `nina develop`, `nix run` → `nina run` etc. But I am starting to see the overall vision behind this: not only _what is being typed_ by the user becomes more concise and intuitive, also the feedback the tool returns can be…
I think I’ll still be using plain `nix` and `nh` commands for now, since I’m quite comfortable with those already. But thanks for making beginners’ lives easier, I’ll definitely be pointing the nix-curious towards this…
Also, quick suggestion. As you have all of these `nina home`, commands, _managing_ a HM config is made simpler. But I’d propose `nina home init`, so that one can get started quickly with HM without having to look up how to `nix run github:nix-community/home-manager init`. Not sure if that _does_ a lot except effectively being an alias, but given so many commands already kind-of are, this could be a neat addition.
[Next page](https://discourse.nixos.org/t/nina-a-helper-that-makes-nixos-a-cozier-place-to-live-search-install-generations-services-flakes-multi-machine-management-etc/78070.md?page=2)