t3code-flake

A small, focused Nix flake that packages the upstream release binaries for T3 Code on Linux and macOS.

This repo exposes packages and apps so you can nix run, nix build, or consume it from another flake. Every package contains two executables:

• t3code launches the Electron desktop app.
• t3 runs the bundled headless CLI using Electron's Node mode.

Why This Flake

• Reproducible packaging for the official T3 Code release artifacts.
• Clean flake outputs for both package and runnable app workflows.

Quick Start

Run straight from GitHub:

nix run github:omarcresp/t3code-flake#t3-code

Run the pinned nightly build:

nix run github:omarcresp/t3code-flake#t3-code-nightly

Run the stable or nightly headless CLI:

nix run github:omarcresp/t3code-flake#t3 -- serve --help
nix run github:omarcresp/t3code-flake#t3-nightly -- serve --help

Build locally from a clone:

nix build .#t3-code

Install into your profile:

nix profile install github:omarcresp/t3code-flake#t3-code

Install nightly into your profile:

nix profile install github:omarcresp/t3code-flake#t3-code-nightly

Both packages install the desktop executable as t3code and the headless CLI as t3.

The default package and app remain the stable release.

Install as a Flake Input

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    t3code-flake.url = "github:omarcresp/t3code-flake";
  };

  outputs = { self, nixpkgs, t3code-flake, ... }:
    let
      system = builtins.currentSystem;
    in
    {
      # NixOS example
      nixosConfigurations.my-host = nixpkgs.lib.nixosSystem {
        inherit system;
        modules = [
          ({ ... }: {
            environment.systemPackages = [
              t3code-flake.packages.${system}.t3-code
            ];
          })
        ];
      };

      # Home Manager / devShell / plain package set example
      packages.${system}.default = t3code-flake.packages.${system}.t3-code;
    };
}

Flake Outputs

Output	Description
packages.x86_64-linux.default	Alias of Linux t3-code package
packages.x86_64-linux.t3-code	Electron app extracted from the upstream AppImage and patched for Nix
packages.x86_64-linux.t3-code-nightly	Pinned nightly Electron app extracted from the upstream AppImage and patched for Nix
packages.aarch64-darwin.t3-code	macOS Apple Silicon app bundle package
packages.aarch64-darwin.t3-code-nightly	Pinned nightly macOS Apple Silicon app bundle package
apps.<system>.t3-code	Runnable app (nix run) for each supported system
apps.<system>.t3-code-nightly	Runnable nightly app (nix run) for each supported system
apps.<system>.t3code	Alias for the stable desktop app
apps.<system>.t3code-nightly	Alias for the nightly desktop app
apps.<system>.t3	Stable headless CLI
apps.<system>.t3-nightly	Nightly headless CLI
checks.<system>.t3-cli	Verifies stable and nightly t3 serve --help reach the headless CLI

Inspect outputs:

nix flake show github:omarcresp/t3code-flake

Platform Support

• x86_64-linux
• aarch64-darwin

Intel macOS (x86_64-darwin) is not supported: nixpkgs 26.05 is the last release supporting that platform, so it was dropped from this flake.

Troubleshooting

If your Nix install does not have flakes enabled yet, add:

experimental-features = nix-command flakes

to your nix.conf.