Skip to content

Conversation

@benbrastmckie
Copy link

Summary

  • Adds full NixOS support for the development environment
  • Provides NixOS-specific installation script and documentation
  • Fixes pf CLI build issue affecting all platforms

Changes

  • scripts/install-nixos.sh: NixOS-compatible installation script that uses Python venv and provides exact Nix package instructions
  • NIX_GUIDE.md: Comprehensive guide for NixOS users including troubleshooting and advanced configurations
  • core/cli/pf/main.go: Fixed rootCmd scope issue preventing successful builds

Key Features

  • ✅ Automatic dependency checking with NixOS package suggestions
  • ✅ Python virtual environment to bypass NixOS pip restrictions
  • ✅ Colored output for clear status indication
  • ✅ Detailed error messages and troubleshooting
  • ✅ Support for all NixOS installation methods (configuration.nix, nix-shell, nix-env)
  • ✅ Convenient activation script for daily development

Test Plan

  • Tested installation script on NixOS
  • Verified pf CLI builds and runs correctly
  • Confirmed Python dependencies install in venv
  • Tested agent initialization (pf init test-agent)
  • Documentation reviewed for accuracy
  • All paths work with NixOS filesystem structure

Compatibility

  • Fully backward compatible - doesn't affect existing installation methods
  • The pf CLI fix benefits all platforms, not just NixOS
  • Documentation is NixOS-specific and won't confuse users of other systems

🤖 Generated with Claude Code

- Add NixOS-specific installation script (scripts/install-nixos.sh)
- Create comprehensive NixOS development guide (NIX_GUIDE.md)
- Fix pf CLI build issue by making rootCmd package-level variable
- Use Python virtual environments to work around NixOS restrictions
- Provide clear dependency installation instructions for NixOS users
- Add colored output and detailed error messages in install script
- Create activation script for convenient environment setup

The NixOS installation script handles the unique requirements of NixOS:
- Avoids global pip installations (uses venv instead)
- Provides exact Nix package names for missing dependencies
- Works with NixOS's read-only filesystem structure
- Supports all installation methods (configuration.nix, nix-shell, nix-env)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant