Add nix flake

.github/workflows/ci.yml

@@ -32,3 +32,23 @@ jobs:
         run: |
           uv run graphify --help
           uv run graphify install
+
+  nix:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v27
+        with:
+          extra_nix_config: |
+            experimental-features = nix-command flakes
+
+      - name: Check flake
+        run: nix flake check --all-systems
+
+      - name: Build default package
+        run: nix build .#default
+
+      - name: Verify built binary runs
+        run: nix run .#default -- --help

.gitignore

@@ -21,6 +21,7 @@ skills/
 docs/superpowers/
 .vscode/
 openspec/
+result
 # Local benchmark scripts — never commit
 scripts/run_k2_*.py
 scripts/llm.py

README.md

@@ -55,6 +55,7 @@ graphify export callflow-html
 | Python | 3.10+ | `python --version` | [python.org](https://www.python.org/downloads/) |
 | uv *(recommended)* | any | `uv --version` | `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
 | pipx *(alternative)* | any | `pipx --version` | `pip install pipx` |
+| Nix *(alternative)* | 2.4+ (flakes enabled) | `nix --version` | [nixos.org](https://nixos.org/download/) |
 
 **macOS quick install (Homebrew):**
 ```bash
@@ -90,6 +91,36 @@ pipx install graphifyy
 pip install graphifyy
 ```
 
+**Nix (flake):**
+
+Run directly without installing:
+```bash
+nix run github:safishamsi/graphify
+```
+
+To expose `graphify` as a package inside another flake, add it as an input and reference its default package:
+```nix
+{
+  inputs = {
+    graphify.url = "github:safishamsi/graphify";
+    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
+  };
+
+  outputs = { nixpkgs, graphify, ... }: {
+    let
+      system = "x86_64-linux";
+      pkgs = nixpkgs.legacyPackages.${system};
+    in {
+      devShells.${system}.default = pkgs.mkShell {
+        buildInputs = [ graphify.packages.${system}.default ];
+      };
+    };
+  };
+}
+```
+
+---
+
 **Step 2 — register the skill with your AI assistant:**
 
 ```bash