From eba195c192c2b220757a54ba3f6ce6fba1625211 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Torjus=20H=C3=A5kestad?= Date: Fri, 6 Feb 2026 00:19:49 +0100 Subject: [PATCH] docs: add nixos-rebuild-test usage to CLAUDE.md Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 7eb92c6..b32b5d6 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -35,6 +35,21 @@ nix build .#create-host Do not automatically deploy changes. Deployments are usually done by updating the master branch, and then triggering the auto update on the specific host. +### Testing Feature Branches on Hosts + +All hosts have the `nixos-rebuild-test` helper script for testing feature branches before merging: + +```bash +# On the target host, test a feature branch +nixos-rebuild-test boot +nixos-rebuild-test switch + +# Additional arguments are passed through to nixos-rebuild +nixos-rebuild-test boot my-feature --show-trace +``` + +When working on a feature branch that requires testing on a live host, suggest using this command instead of the full flake URL syntax. + ### Flake Management ```bash