diff --git a/README.md b/README.md
index c439743cea..a1742eebed 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
+
 # T3 Code
 
 T3 Code is a minimal web GUI for coding agents (currently Codex, Claude, and OpenCode, more coming soon).
@@ -40,6 +41,33 @@ brew install --cask t3-code
 yay -S t3code-bin
 ```
 
+#### NixOS (Flakes)
+
+```nix
+# /path/to/your/flake.nix
+{
+  inputs = {
+    # This flake is pinned to nixpkgs stable
+    nixpkgs.url = "github:nixos/nixpkgs/nixos-25.05";
+
+    t3code-flake.url = "github:pingdotgg/t3code";  
+      # Or pin a version: "github:pingdotgg/t3code?ref=v0.0.23"
+    t3code-flake.inputs.nixpkgs.follows = "nixpkgs";
+  };
+}
+```
+
+```nix
+# /path/to/your/configuration.nix
+{
+  nix.settings.experimental-features = [ "nix-command" "flakes" ];
+  environment.systemPackages = [
+    pkgs.appimage-run
+    inputs.t3code-flake.packages.${system}.default
+  ];
+}
+```
+
 ## Some notes
 
 We are very very early in this project. Expect bugs.
diff --git a/flake.lock b/flake.lock
new file mode 100644
index 0000000000..ab429ceebf
--- /dev/null
+++ b/flake.lock
@@ -0,0 +1,27 @@
+{
+  "nodes": {
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1767313136,
+        "narHash": "sha256-16KkgfdYqjaeRGBaYsNrhPRRENs0qzkQVUooNHtoy2w=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "ac62194c3917d5f474c1a844b6fd6da2db95077d",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixos-25.05",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "nixpkgs": "nixpkgs"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}
diff --git a/flake.nix b/flake.nix
new file mode 100644
index 0000000000..dcb7f68201
--- /dev/null
+++ b/flake.nix
@@ -0,0 +1,75 @@
+{
+  description = "T3 Code - A harness for coding agents";
+
+  # ===== MAINTENANCE NOTES FOR MAINTAINERS =====
+  #
+  #   let
+  #     releaseTag = "v0.0.24";
+  #     version = lib.removePrefix "v" releaseTag;
+  #     appimageHash = "sha256-t8KYAtaQKWmCVOOwvHByosYoqb0Ji35Qe4m+8Gtp/+k=";
+  #   in
+  #   {
+  #     . . .
+  #   };
+  #
+  # To update to a new release:
+  #   1. Update `releaseTag` to the new version (e.g., "v0.0.25")
+  #   2. Update `appimageHash`:
+  #       nix-prefetch-url https://github.com/pingdotgg/t3code/releases/download/v0.0.25/T3-Code-0.0.25-x86_64.AppImage
+  # ==============================================
+
+  inputs = {
+    nixpkgs.url = "github:nixos/nixpkgs/nixos-25.05";
+  };
+
+  outputs =
+    { self, nixpkgs }:
+    let
+      lib = nixpkgs.lib;
+
+      releaseTag = "v0.0.24";
+      version = lib.removePrefix "v" releaseTag;
+      appimageHash = "sha256-t8KYAtaQKWmCVOOwvHByosYoqb0Ji35Qe4m+8Gtp/+k=";
+
+      supportedSystems = [ "x86_64-linux" ];
+
+      pkgs = import nixpkgs { system = "x86_64-linux"; };
+
+      appimage = pkgs.fetchurl {
+        url = "https://github.com/pingdotgg/t3code/releases/download/${releaseTag}/T3-Code-${version}-x86_64.AppImage";
+        sha256 = appimageHash;
+      };
+    in
+    {
+      packages.x86_64-linux = {
+        default = pkgs.stdenv.mkDerivation {
+          pname = "t3code";
+          inherit version;
+
+          src = appimage;
+
+          dontStrip = true;
+          dontUnpack = true;
+
+          installPhase = ''
+            mkdir -p $out/bin
+            cp $src $out/bin/t3code.AppImage
+            chmod +x $out/bin/t3code.AppImage
+
+            cat > $out/bin/t3code << 'LAUNCHER'
+            #!/bin/sh
+            exec appimage-run "$(dirname "$0")/t3code.AppImage" "$@"
+            LAUNCHER
+            chmod +x $out/bin/t3code
+          '';
+
+          meta = {
+            description = "T3 Code - A harness for coding agents";
+            homepage = "https://t3.codes";
+            license = lib.licenses.mit;
+            platforms = supportedSystems;
+          };
+        };
+      };
+    };
+}