Add a flake.nix for NixOS Flake users

[Khitboksy]

What Changed

A - flake.nix
A - flake.lock
M - README.md

flake.nix looks at the parent repo (pingdotgg/t3code), pulls it, builds it from source, and caches the build in a nix/store directory on first build. unless the user runs 'nix flake update', manually updating their flake inputs, t3code on the user machine will not receive codebase changes from the repository. It also will not rebuild the application unless the nix/store hash, and updated repo hash are different.

README.md now includes how to install this application on nixos flake enabled machines.

Why

Currently using t3code on nixos requires using appimages, and other "not-very-nix" ways of installing applications depending on your mode of attack. Ive spent the past few hours creating a flake.nix that reads the repo, builds it from source, and only rebuilds the app if the repo updates. this enables a simple and easy oneliner installation of t3code on nixos machines.

there is very little maintenance on your behalf, only ever needing to update flake.nix:6:nixpkgs.url= to be the latest nixpkgs stable release, OR for a set-and-forget you can set it to nixos-unstable, and change the readme accordingly. the flake handles the nixos specific runtime shenanigans, your source code just tells it what to build

Checklist

• This PR is small and focused
• I explained what changed and why
• [N/A] I included before/after screenshots for any UI changes
• [N/A] I included a video for animation/interaction changes

---

Note

Low Risk
Low risk: adds Nix packaging/docs only and does not change application runtime code paths, but installs are now pinned to a specific AppImage release/hash for NixOS users.

Overview
Adds first-class NixOS Flake support by introducing flake.nix/flake.lock that package t3code (x86_64-linux) by fetching a pinned GitHub Releases AppImage and exposing a t3code launcher that runs it via appimage-run.

Updates README.md with NixOS (Flakes) installation instructions showing how to add the flake input and install the package via environment.systemPackages.

^{Reviewed by Cursor Bugbot for commit 1bed46e. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add Nix flake for installing t3code on NixOS

• Adds flake.nix that fetches the t3code AppImage from GitHub releases (pinned to v0.0.24) and wraps it in an appimage-run launcher script, exposing it as packages.x86_64-linux and defaultPackage.
• Updates README.md with a new 'NixOS (Flakes)' section showing how to add the flake as an input and install the package via systemPackages.
• Support is limited to x86_64-linux only.

^{Macroscope summarized 1bed46e.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 42b599c6-88c6-4d1e-8abc-b09fd39c63f3

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[macroscopeapp]

Approvability

Verdict: Approved

This PR adds NixOS Flake packaging support - purely additive distribution configuration that downloads the existing AppImage release and wraps it for NixOS users. No application code or runtime behavior is changed.

^{You can customize Macroscope's approvability policy. Learn more.}

[Khitboksy]

minor update: im switching to using the provided appimages instead of building from source

[Khitboksy]

Updates

M - flake.nix

this started out building from source but ive pivoted due to sandboxing issues, instead deciding to wrap the pre-build appimage with appimage-run. this flake currently only supports the linux appimage.

Maintenance

releaseTag = "v0.0.23";                // version
appimageHash = "sha256-...";           // update with `nix hash url <appimage-url>
supportedSystems = [ "x86_64-linux" ];

i have tested this build on my local flake, AND my fork with the changes. the app built, and opened through my launcher just fine.

README.md updates that for some reason arent appearing on my end.

NixOS (Flakes)

# /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";
    t3code-flake.inputs.nixpkgs.follows = "nixpkgs";
  };
}

# /path/to/your/configuration.nix
{
  nix.settings.experimental-features = [ "nix-command" "flakes" ];
  environment.systemPackages = [
    pkgs.appimage-run
    inputs.t3code-flake.packages.${system}
  ];
}

this addresses the appimage issue.

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 01f0ee6. Configure here.}