Add Nix CI support with GitHub-hosted runners

- Add flake.nix for reproducible builds using Cargo.toml version
- Add Nix job to rust.yml workflow running parallel to existing tests
- Update README.md with comprehensive Nix development instructions
- Update AGENTS.md with separate Nix development commands
- Supports Linux/macOS with platform-specific dependencies

Author: g

.github/workflows/rust.yml

@@ -152,3 +152,18 @@ jobs:
         
         # Test with invalid WebSocket URL
         timeout 5s ./target/release/obs-cmd --ws-url invalid-url scene list || echo "Expected URL parsing failure"
+        
+  nix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Nix
+        uses: cachix/install-nix-action@v25
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+      - name: Check flake
+        run: nix flake check
+      - name: Build package
+        run: nix build
+      - name: Test dev shell
+        run: nix develop --run "cargo test"

AGENTS.md

@@ -75,6 +75,8 @@ src/
 - **Scene Collections**: List, create, switch between scene collections
 
 ## Development Commands
+
+### Traditional Rust Development
 ```bash
 # Build and run
 cargo run                    # Build and run locally
@@ -94,6 +96,22 @@ cargo deny check             # License and dependency checks
 cargo install --path .       # Install locally
 ```
 
+### Nix Development
+```bash
+# Nix development (alternative)
+nix develop                  # Enter development shell
+nix build                    # Build reproducible package
+nix flake check             # Validate flake configuration
+
+# Run from Nix store
+./result/bin/obs-cmd --help
+
+# Code quality (within nix develop)
+cargo fmt                    # Format code
+cargo clippy -- -D warnings  # Lint with strict warnings
+cargo test                   # Run tests
+```
+
 ## Release Configuration
 - Optimized release profile in `Cargo.toml` with size optimizations
 - LTO enabled, single codegen unit, panic=abort for smaller binaries

README.md

@@ -326,6 +326,8 @@ RUST_LOG=debug obs-cmd info
 
 ## Development
 
+### Traditional Rust Development
+
 ```bash
 # Build from source
 cargo build --release
@@ -340,6 +342,35 @@ cargo fmt
 cargo clippy -- -D warnings
 ```
 
+### Nix Support
+
+This project supports Nix for reproducible builds and development environments.
+
+#### Development with Nix
+
+1. **Enter development shell**:
+   ```bash
+   nix develop
+   ```
+
+2. **Build project**:
+   ```bash
+   nix build
+   ```
+
+3. **Run from Nix store**:
+   ```bash
+   ./result/bin/obs-cmd --help
+   ```
+
+#### Nix Flakes
+
+This project uses Nix Flakes for reproducible builds. The flake provides:
+- `obs-cmd` package: Build release binary
+- `devShell`: Development environment with Rust tools and dependencies
+
+See [flake.nix](./flake.nix) for full configuration.
+
 ## Donations
 
 If you find this project helpful, please consider making a donation to support its development.

flake.nix

@@ -0,0 +1,48 @@
+{
+  description = "A minimal command to control obs via obs-websocket";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = nixpkgs.legacyPackages.${system};
+        # Extract version from Cargo.toml
+        version = (pkgs.lib.importTOML ./Cargo.toml).package.version;
+      in {
+        packages.default = pkgs.rustPlatform.buildRustPackage {
+          pname = "obs-cmd";
+          inherit version;
+          src = ./.;
+          cargoLock = {
+            lockFile = ./Cargo.lock;
+            allowBuiltinFetchGit = true;
+          };
+          
+          # Build dependencies
+          nativeBuildInputs = with pkgs; [ pkg-config ];
+          buildInputs = with pkgs; [ openssl ]
+            ++ pkgs.lib.optionals pkgs.stdenv.isDarwin [ 
+              pkgs.darwin.apple_sdk.frameworks.Security 
+            ];
+        };
+        
+        devShells.default = pkgs.mkShell {
+          buildInputs = with pkgs; [ 
+            rustc 
+            cargo 
+            clippy 
+            rustfmt 
+            pkg-config 
+            openssl 
+          ] ++ pkgs.lib.optionals pkgs.stdenv.isDarwin [ 
+            pkgs.darwin.apple_sdk.frameworks.Security 
+          ];
+          
+          RUST_BACKTRACE = "1";
+        };
+      });
+}