feat: Add Nix flake and Devbox support for reproducible builds

.gitignore

@@ -20,9 +20,16 @@ agentmemory-debug/
 .gstack/
 
 # Lock files — never commit (see feedback_no_lockfiles memory)
-package-lock.json
+# Except package-lock.json which is required for Nix buildNpmPackage reproducibility.
+!package-lock.json
 pnpm-lock.yaml
 yarn.lock
+flake.lock
+devbox.lock
+
+# Nix build result symlinks
+/result
+/result-*
 integrations/hermes/__pycache__/
 
 # Eval reports (transient; published scorecards live in docs/benchmarks/)

README.md

@@ -107,6 +107,45 @@ Heads-up — npx caches per version. If a bare `npx @agentmemory/agentmemory` se
 
 Full options at [Quick Start](#quick-start) below. Agent-specific wiring at [Works with every agent](#works-with-every-agent).
 
+### Nix
+
+For users who already use Nix with flakes:
+
+```bash
+# Run directly from the latest source
+nix run github:rohitg00/agentmemory
+
+# Build locally
+nix build github:rohitg00/agentmemory
+
+# Enter the dev shell for development
+nix develop github:rohitg00/agentmemory
+```
+
+### Devbox
+
+For reproducible development environments, use Devbox:
+
+```bash
+# Install devbox first (if not already installed)
+curl -fsSL https://get.jetify.dev/devbox | bash
+
+# Initialize the environment
+devbox shell
+
+# Install dependencies
+devbox run install
+
+# Build the project
+devbox run build
+```
+
+Or install devbox via Homebrew:
+
+```bash
+brew install jetify-com/devbox/devbox
+```
+
 ---
 
 <h2 id="works-with-every-agent"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-agents.svg"><img src="assets/tags/section-agents.svg" alt="Works with every agent" height="32" /></picture></h2>

devbox.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://raw.githubusercontent.com/jetify-com/devbox/0.12.0/.schema/devbox.schema.json",
+  "packages": [
+    "nodejs_22",
+    "git"
+  ],
+  "hooks": {
+    "on_create": [
+      "[ -d node_modules ] || npm install --legacy-peer-deps"
+    ]
+  },
+  "shell": {
+    "init_hook": [
+      "echo 'Welcome to the agentmemory devbox environment!'"
+    ],
+    "scripts": {
+      "install": "npm install --legacy-peer-deps",
+      "build": "npm run build",
+      "test": "npm test",
+      "dev": "npm run dev"
+    }
+  }
+}

flake.nix

@@ -0,0 +1,77 @@
+{
+  description = "agentmemory - Persistent memory for AI coding agents";
+
+  inputs = {
+    nixpkgs.url = "github:NixOS/nixpkgs/nixpkgs-unstable";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = nixpkgs.legacyPackages.${system};
+
+        agentmemory = pkgs.buildNpmPackage {
+          pname = "agentmemory";
+          version = "0.9.24";
+          src = ./.;
+
+          npmDepsHash = "sha256-+fXZndf9P+h1SX+dQz7WQwyqAqMMKfXjV5u3Npn45Nk=";
+
+          nativeBuildInputs = [ pkgs.nodejs_22 ];
+
+          postPatch = ''
+            echo "legacy-peer-deps=true" >> .npmrc
+          '';
+
+          NPM_CONFIG_IGNORE_SCRIPTS = "true";
+
+          meta = {
+            description = "Persistent memory for AI coding agents, powered by iii-engine's three primitives";
+            homepage = "https://github.com/rohitg00/agentmemory";
+            license = pkgs.lib.licenses.asl20;
+            mainProgram = "agentmemory";
+          };
+        };
+      in
+      {
+        packages = {
+          default = agentmemory;
+          source = agentmemory;
+        };
+
+        apps = {
+          default = {
+            type = "app";
+            program = "${agentmemory}/bin/agentmemory";
+          };
+          source = {
+            type = "app";
+            program = "${agentmemory}/bin/agentmemory";
+          };
+        };
+
+        overlays.default = final: prev: {
+          agentmemory = agentmemory;
+        };
+
+        devShells.default = pkgs.mkShell {
+          buildInputs = [ pkgs.nodejs_22 pkgs.git ];
+
+          shellHook = ''
+            echo "Welcome to agentmemory dev shell"
+            export PATH="$PWD/node_modules/.bin:$PATH"
+
+            if [ ! -d "node_modules" ]; then
+              echo "Installing dependencies..."
+              npm install --legacy-peer-deps
+            fi
+          '';
+        };
+
+        checks = {
+          build = agentmemory;
+        };
+      }
+    );
+}