HM Ricing Mode is a utility to put Home Manager managed apps in ricing mode.
When tweaking your applications you need instant feedback. Change a setting in a dotfile; reload the application and see if it worked. Having to build all home-manager nix files take way too long to give this instant feedback.
HM Ricing Mode helps. When running hmrice rice, it replaces the Nix-store symlinks
with an temporary editable copy of all the files for debugging and ricing
purposes. When your finished, and backported the changes into the nix-files in
home-manager, the command hmrice unrise restores the original nix-symlinks.
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
home-manager.url = "github:nix-community/home-manager";
hm-ricing-mode.url = "github:mipmip/hm-ricing-mode";
};
outputs = { nixpkgs, home-manager, hm-ricing-mode, ... }: {
h
9237
omeConfigurations."«username»" = home-manager.lib.homeManagerConfiguration {
pkgs = nixpkgs.legacyPackages.x86_64-linux;
modules = [ hm-ricing-mode.homeManagerModules.hm-ricing-mode ];
};
};
}You need to enable hm-ricing-mode. Add this to your Home Manager configuration:
programs.hm-ricing-mode.enable = true;Every application which you want to allow in ricing mode should be added to the apps option.
When you have implemented the app-configuration using nix options. You should
choose the backport type. hmrice will then make a static copy and replace all
symlinks with real files.
{
programs.hm-ricing-mode.apps.ghostty = {
dest_dir = ".config/ghostty";
type = "backport"; # symlink | backport (default)
};
}When you have implemented the app-configuration with the
home.file.recursive=true method. You can choose the symlink-type. This saves
you the need of backporting all changes into Nix configuration. You should set
a correct source_dir where your original files are located.
{
programs.hm-ricing-mode.apps.neovim = {
dest_dir = ".config/nvim";
source_dir = "$HOME/nixos/home/pim/_hm-modules/programs/neovim/nvim";
type = "symlink"; # symlink | backport (default)
};
}Usage: hmrice <command>
Commands:
rice set all known apps in ricing mode
unrice remove ricing copies and restore nix-store symlinks and set locked mode
status get current rice mode: managed/ricing
help print usage
version print version
When running home-manager switch -b in ricing state it creates a lot of garbage
and wrong symlinks. Currently the best way to prevent this is to run home-manager
from a wrapper script. E.g...
#!/usr/bin/env bash
RICING=$(hmrice status | grep RICING | wc -l)
if [ $RICING -gt 0 ]; then
echo "Unrise first (hmrice unrice), then run again"
else
home-manager switch --flake .\#$USER@$(hostname)
fiFile issue requests in this repo
HM-Ricing-Mode is open source and we appreciate contributions and positive feedback.
Read the docs and roadmaps
Copyright 2025 Pim Snel | Published under the MIT.