nix-flake-update
Update Nix flake inputs in persops. Use when asked to update flake.lock/inputs, update AI inputs (codex-cli-nix, claude-code-nix, llm-agents), or run full `nix flake update`, then verify with `nix flake check` and commit the update-only changes.
When & Why to Use This Skill
This Claude skill automates the end-to-end lifecycle of Nix flake management within the persops repository. It streamlines dependency updates for flake.lock, specifically targeting AI tools and general inputs, while ensuring system stability through automated verification checks and standardized Git commits.
Use Cases
- Automated Dependency Maintenance: Efficiently update all Nix flake inputs or specific AI-related packages like codex-cli-nix and claude-code-nix to ensure the development environment is up-to-date.
- Continuous Integration Workflow: Execute a 'nix flake update' followed by 'nix flake check' to catch breaking changes early and maintain a healthy build state.
- Standardized DevOps Operations: Automate the 'update-switch-verify-commit' cycle using Conventional Commits, ensuring a clean and traceable version control history for infrastructure changes.
| name | nix-flake-update |
|---|---|
| description | Update Nix flake inputs in persops. Use when asked to update flake.lock/inputs, update AI inputs (codex-cli-nix, claude-code-nix, llm-agents), or run full `nix flake update`, then verify with `nix flake check` and commit the update-only changes. |
Nix Flake Update
Workflow
- Decide scope
- AI update: run
nix flake update codex-cli-nix claude-code-nix llm-agents - Full update: run
nix flake update(default when user does not mention AI)
- AI update: run
- Switch
- Run
make switchafter any update
- Run
- Verify (full updates only)
- Run
nix flake check - If failure, quote exact error, fix only update-related fallout, rerun
nix flake check
- Run
- Commit
- Stage only update-related files (typically
flake.lock, maybeflake.nixor other necessary fixes) - Use Conventional Commit, keep commit isolated to the update
- Examples:
chore(nix): update flake inputsorchore(nix): update ai inputs
- Stage only update-related files (typically
Notes
- Skip
nix flake checkwhen updating AI inputs (unless explicitly requested). - Work from repo root.
- Keep changes minimal; no unrelated refactors.