t3code-flake

Standalone Nix packaging for pingdotgg/t3code.

This repository does not rely on upstream Nix packaging. It fetches the upstream source as a non-flake input and builds local package expressions around that source tree.

What It Exports

For each supported system, the flake exports:

• apps.<system>.default
• apps.<system>.t3code-desktop
• apps.<system>.t3code-server
• packages.<system>.default
• packages.<system>.t3code-desktop
• packages.<system>.t3code-server
• checks.<system>.t3code-desktop
• checks.<system>.t3code-server

Current default points to the t3code-desktop.

There are also desktop and server shorthands available for apps and packages.

Usage

Inspect the flake surface:

nix flake show --all-systems

Build the desktop package:

nix build .#t3code-desktop

Build the server package:

nix build .#t3code-server

Run the desktop app:

nix run .#t3code-desktop

Run the server app:

nix run .#t3code-server

Agent CLI Support

Both packages can be overridden to add AI agent CLIs to the runtime PATH:

• withCodex adds github:numtide/llm-agents.nix#codex
• withClaudeCode adds github:numtide/llm-agents.nix#claude-code
• withOpencode adds github:numtide/llm-agents.nix#opencode

Agent CLIs can be overridden as well using codexPackage, claudeCodePackage and opencodePackage respectively.

These overrides wrap the finished package in a small postBuild layer, so changing the agent flags does not rebuild the full T3 Code package.

In a Nix expression, use the same package override directly (using perSystem from github:numtide/blueprint):

{perSystem, pkgs, ...}: {
  home.packages = [
    (perSystem.t3code.desktop.override {
      withCodex = true;
      claudeCodePackage = pkgs.claude-code-bin;
      withClaudeCode = true;
      opencodePackage = perSystem.foobar.my-awesome-opencode-fork;
      withOpencode = true;
    })
  ];
}

Layout

.
├── flake.nix
├── flake.lock
├── README.md
└── packages
    ├── common.nix
    ├── scripts
    │   ├── canonicalize-node-modules.ts
    │   └── normalize-bun-binaries.ts
    ├── t3code-desktop
    │   ├── build-nix-desktop-package.mjs
    │   ├── default.nix
    │   └── desktop-nix-autoupdate.patch
    └── t3code-server
        └── default.nix

Notes

• packages/common.nix contains the shared Bun workspace and node-pty setup used by both packages.
• packages/scripts/*.ts contains the Bun install-tree normalization helpers used by packages/common.nix.
• packages/t3code-desktop/build-nix-desktop-package.mjs is local packaging glue carried by this repo.
• packages/t3code-desktop/desktop-nix-autoupdate.patch is a downstream patch for desktop auto-update messaging in package-managed installs.
• Upstream source is pinned in flake.lock via the t3code input.
• Optional agent CLI packages are pinned in flake.lock via the llm-agents input.