From a4ca38acaf126d56a8e4b2b9b44abce141d3f497 Mon Sep 17 00:00:00 2001 From: yves <123611181+yvesoddly@users.noreply.github.com> Date: Mon, 2 Nov 2026 10:13:21 -0600 Subject: [PATCH 1/2] fix: fork install docs, scripts and settings stop pointing at upstream Co-Authored-By: Claude Opus 5.5 --- README.md | 12 +++++---- .../components/settings/SettingsPanels.tsx | 5 ++-- .../src/components/settings/settingsSearch.ts | 4 ++- docs/user/install.md | 26 +++++++++---------- docs/user/updating.md | 3 +++ packages/shared/src/fork.test.ts | 9 +++++++ packages/shared/src/fork.ts | 4 ++- scripts/install.ps1 | 6 +++-- scripts/install.sh | 10 ++++--- 9 files changed, 51 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 1f63f3609ae0d..b40f2dc91ed9a 100644 --- a/README.md +++ b/README.md @@ -25,23 +25,25 @@ We wanted something performant, remote-ready, and truly open. If we ever go the ### Command line +This fork publishes only nightly builds, so the commands below select the nightly train. + ```bash -curl -fsSL https://t3.codes/install.sh | sh +curl -fsSL https://raw.githubusercontent.com/issuelt/t3code/main/scripts/install.sh | T3CODE_CHANNEL=nightly sh ``` On Windows, in PowerShell: ```powershell -irm https://t3.codes/install.ps1 | iex +$env:T3CODE_CHANNEL = "nightly"; irm https://raw.githubusercontent.com/issuelt/t3code/main/scripts/install.ps1 | iex ``` Then run `t3` to start the server and open the local web app. `t3 service install` keeps it running in the background, `t3 update` moves to a newer release, and `t3 --help` has the full reference. -To try it once without installing, run `npx t3@latest` instead. +`npx t3` runs upstream T3 Code from npm, not this fork. Where the docs say `npx t3`, run `t3` instead. ### Desktop app -Install the latest version of the desktop app from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), or from your favorite package registry: +Install the latest version of the desktop app from [GitHub Releases](https://github.com/issuelt/t3code/releases). The package registries below ship upstream T3 Code, not this fork: #### Windows (`winget`) @@ -63,7 +65,7 @@ brew install --cask t3-code #### Debian, Ubuntu (`.deb`) -Download the `.deb` from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), then: +Download the `.deb` from [GitHub Releases](https://github.com/issuelt/t3code/releases), then: ```bash sudo apt install ./T3-Code-*.deb diff --git a/apps/web/src/components/settings/SettingsPanels.tsx b/apps/web/src/components/settings/SettingsPanels.tsx index 362210f96eee1..9e33961a82027 100644 --- a/apps/web/src/components/settings/SettingsPanels.tsx +++ b/apps/web/src/components/settings/SettingsPanels.tsx @@ -24,6 +24,7 @@ import { SidebarProjectSortOrder, } from "@t3tools/contracts/settings"; import { desktopUpdateChannelOf } from "@t3tools/shared/cliRelease"; +import { FORK_HAS_UPDATE_TRACKS } from "@t3tools/shared/fork"; import { createModelSelection } from "@t3tools/shared/model"; import { resolvePastedPath } from "@t3tools/shared/path"; import * as Equal from "effect/Equal"; @@ -321,7 +322,7 @@ function AboutVersionSection() { } /> - {hasDesktopBridge ? ( + {hasDesktopBridge && FORK_HAS_UPDATE_TRACKS ? ( } /> - ) : selectedHostedAppChannel ? ( + ) : !hasDesktopBridge && selectedHostedAppChannel ? ( (isElectron || item.desktopOnly !== true) && - (!item.releaseChannelOnly || isElectron || HOSTED_APP_CHANNEL !== null) && + (!item.releaseChannelOnly || + (isElectron ? FORK_HAS_UPDATE_TRACKS : HOSTED_APP_CHANNEL !== null)) && (!item.secretsFeatureOnly || isSecretsFeatureEnabled) && (!item.macOnly || isMacPlatform(platform)) && (!item.windowsOnly || isWindowsPlatform(platform)), diff --git a/docs/user/install.md b/docs/user/install.md index eb01607a91782..f960ed8c15ada 100644 --- a/docs/user/install.md +++ b/docs/user/install.md @@ -11,19 +11,19 @@ launch T3 Code and configure providers afterwards. ## Command line ```bash -curl -fsSL https://t3.codes/install.sh | sh +curl -fsSL https://raw.githubusercontent.com/issuelt/t3code/main/scripts/install.sh | T3CODE_CHANNEL=nightly sh ``` On Windows, in PowerShell: ```powershell -irm https://t3.codes/install.ps1 | iex +$env:T3CODE_CHANNEL = "nightly"; irm https://raw.githubusercontent.com/issuelt/t3code/main/scripts/install.ps1 | iex ``` This installs the `t3` binary to `~/.local/bin`. If your shell reports `command not found` afterwards, that directory is not on your `PATH` yet; the installer prints the -line to add. Set `T3CODE_CHANNEL=nightly` to install the nightly train, or -`T3CODE_VERSION` to pin an exact version. +line to add. This fork publishes only nightly builds, so the commands select the +nightly train. Set `T3CODE_VERSION` to pin an exact version. | Task | Command | | ------------------------------------------------ | ----------------------------------------------------------------------- | @@ -43,17 +43,17 @@ If `t3` or `t3 start` reports an already running server, connect to that server instead. Stop it before starting a replacement, or use a different `--base-dir` for an independent server. -To try T3 Code once without installing it, run `npx t3@latest` instead (needs -Node.js for `npx`). +`npx t3` runs upstream T3 Code from npm, not this fork. Where these docs say +`npx t3`, run `t3` instead. ### Intel Macs -There is no `t3` executable for Intel Macs (the desktop app is available). To +There is no `t3` executable or desktop app for Intel Macs. To run a server there, build it from source with `vp`, which provides the Node version it needs -([Install vp](https://github.com/pingdotgg/t3code#install-vp)): +([Install vp](https://github.com/issuelt/t3code#install-vp)): ```bash -git clone https://github.com/pingdotgg/t3code +git clone https://github.com/issuelt/t3code cd t3code && vp i && vp run build:desktop node apps/server/dist/bin.mjs ``` @@ -63,8 +63,8 @@ update it with `git pull` and a rebuild. ## Desktop app -Download a release from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), -or use a package manager: +Download a release from [GitHub Releases](https://github.com/issuelt/t3code/releases). +Apart from the `.deb`, the package managers below install upstream T3 Code, not this fork: | Platform | Install | | ------------------ | ------------------------------------------------------------ | @@ -142,8 +142,8 @@ Store links and QR codes are also available in **Settings → About → Mobile a on web and desktop. The store apps work with both stable and Nightly servers. Test builds are optional: - **iPhone and iPad:** TestFlight is invite-only. -- **Android:** download an APK from the - [Android beta releases](https://github.com/pingdotgg/t3code/releases?q=android-beta-). +- **Android:** download this fork's APK from + [GitHub Releases](https://github.com/issuelt/t3code/releases). If the app crashes during launch, open Settings → Diagnostics on the next launch that succeeds. It lists startup crashes from the last 7 days with the error and diff --git a/docs/user/updating.md b/docs/user/updating.md index 6f8b35945cf6b..68c7ad8da80aa 100644 --- a/docs/user/updating.md +++ b/docs/user/updating.md @@ -38,6 +38,9 @@ below. ## Switch between Stable and Nightly +This fork publishes only Nightly, so its desktop app has no **Update track** +setting. The rest of this section applies to upstream T3 Code. + In the desktop app, change **Settings → About → Update track**. T3 Code shows each connected machine it will move and each one it skips, then moves them in one step. Remote servers install the latest release on the new track. Remote desktop diff --git a/packages/shared/src/fork.test.ts b/packages/shared/src/fork.test.ts index 69614ec16057a..5748fe09ccfa8 100644 --- a/packages/shared/src/fork.test.ts +++ b/packages/shared/src/fork.test.ts @@ -30,6 +30,15 @@ describe("fork release source", () => { expect(repoLiteral.exec(repoFile(path))?.[1]).toBe(FORK_REPOSITORY); }); + it.each(["README.md", "docs/user/install.md", "scripts/install.sh", "scripts/install.ps1"])( + "points install commands and release links at the fork in %s", + (path) => { + const source = repoFile(path); + expect(source).not.toMatch(/t3\.codes\/install|pingdotgg\/t3code\/releases/); + expect(source).toContain(`raw.githubusercontent.com/${FORK_REPOSITORY}/main/scripts/install`); + }, + ); + it.each([ "apps/desktop/src/app/DesktopStartupRecovery.ts", "apps/web/src/components/desktopUpdate.logic.ts", diff --git a/packages/shared/src/fork.ts b/packages/shared/src/fork.ts index be5322d9ce71c..94baf0c44dc0c 100644 --- a/packages/shared/src/fork.ts +++ b/packages/shared/src/fork.ts @@ -1,4 +1,6 @@ // The fork's release source: CLI and desktop updates, installers, and release links point here. -// scripts/install.sh and scripts/install.ps1 repeat the slug as a literal; fork.test.ts keeps them in sync. +// The install scripts and docs repeat the slug as a literal; fork.test.ts keeps them in sync. export const FORK_REPOSITORY = "issuelt/t3code"; export const FORK_RELEASES_URL = `https://github.com/${FORK_REPOSITORY}/releases`; +// The fork publishes only nightly releases and no npm package, so desktop has no track to switch to. +export const FORK_HAS_UPDATE_TRACKS = false; diff --git a/scripts/install.ps1 b/scripts/install.ps1 index eda37a6b018a1..297c69a1fd11d 100644 --- a/scripts/install.ps1 +++ b/scripts/install.ps1 @@ -1,7 +1,9 @@ # Installs the T3 Code CLI from a GitHub Release archive on Windows. Needs # only PowerShell 5.1+; no Node, npm, or compiler. # -# irm https://t3.codes/install.ps1 | iex +# $env:T3CODE_CHANNEL = "nightly"; irm https://raw.githubusercontent.com/issuelt/t3code/main/scripts/install.ps1 | iex +# +# The fork publishes only nightly releases, so the default stable channel finds nothing. # # Environment: # T3CODE_CHANNEL release train to follow: stable, nightly, or preview @@ -177,7 +179,7 @@ if ((Test-Path $marker) -and ((Get-Content $marker -Raw).Trim() -eq $version)) { } catch { $status = $_.Exception.Response.StatusCode.value__ if ($status -eq 404) { - Fail "t3 $version has no release archive for win32-$arch; releases before the self-contained CLI can only be installed with 'npm install -g t3@$version'" + Fail "t3 $version has no release archive for win32-$arch" } throw } diff --git a/scripts/install.sh b/scripts/install.sh index e445459337c65..7b1f53186f786 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -2,7 +2,9 @@ # Installs the T3 Code CLI from a GitHub Release archive. Needs only sh, tar, # sha256sum or shasum, and curl or wget; no Node, npm, or compiler. # -# curl -fsSL https://t3.codes/install.sh | sh +# curl -fsSL https://raw.githubusercontent.com/issuelt/t3code/main/scripts/install.sh | T3CODE_CHANNEL=nightly sh +# +# The fork publishes only nightly releases, so the default stable channel finds nothing. # # Environment: # T3CODE_CHANNEL release train to follow: stable, nightly, or preview @@ -126,7 +128,7 @@ download() { case "$(uname -s)" in Darwin) platform="darwin" ;; Linux) platform="linux" ;; - *) fail "unsupported operating system $(uname -s); use the desktop app or npm" ;; + *) fail "unsupported operating system $(uname -s); use the desktop app" ;; esac case "$(uname -m)" in arm64 | aarch64) arch="arm64" ;; @@ -134,7 +136,7 @@ case "$(uname -m)" in *) fail "unsupported architecture $(uname -m)" ;; esac if [ "${platform}-${arch}" = darwin-x64 ]; then - fail "there is no t3 CLI for Intel Macs. Install the desktop app from https://t3.codes/download, or run a server from source: https://github.com/${repo}/blob/main/docs/user/install.md#intel-macs" + fail "there is no t3 CLI or desktop app for Intel Macs. Run a server from source: https://github.com/${repo}/blob/main/docs/user/install.md#intel-macs" fi command -v tar >/dev/null 2>&1 || fail "tar is required" if command -v sha256sum >/dev/null 2>&1; then @@ -205,7 +207,7 @@ else fetch_status=0 fetch "${base_url}/v${version}/SHA256SUMS" "${staging}/SHA256SUMS" || fetch_status=$? if [ "$fetch_status" -eq 44 ]; then - fail "t3 ${version} has no release archive for ${platform}-${arch}; releases before the self-contained CLI can only be installed with \`npm install -g t3@${version}\`" + fail "t3 ${version} has no release archive for ${platform}-${arch}" elif [ "$fetch_status" -ne 0 ]; then fail "could not download the release checksums" fi From b23f45a6fe409b74c6f8087e87844e96c3f82439 Mon Sep 17 00:00:00 2001 From: eyeveil <64274427+eyeveil@users.noreply.github.com> Date: Sat, 7 Nov 2026 13:47:51 +0100 Subject: [PATCH 2/2] Point the new Linux install notes and README desktop link at the fork Upstream's Linux section promised ARM64 desktop downloads the fork does not publish, and the README's desktop app link still opened t3.codes. The fork test now also rejects t3.codes download links. --- README.md | 2 +- docs/user/install.md | 9 ++++----- packages/shared/src/fork.test.ts | 4 +++- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index b40f2dc91ed9a..dd1ae2bf99ea7 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # T3 Code -T3 Code is an "agent harness control surface". It enables control of the agents on your machine with a best-in-class mobile app ([iOS](https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824), [Android](https://play.google.com/store/apps/details?id=com.t3tools.t3code)), [web app](https://app.t3.codes) and [Electron-based desktop app](https://t3.codes). +T3 Code is an "agent harness control surface". It enables control of the agents on your machine with a best-in-class mobile app ([iOS](https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824), [Android](https://play.google.com/store/apps/details?id=com.t3tools.t3code)), [web app](https://app.t3.codes) and [Electron-based desktop app](https://github.com/issuelt/t3code/releases). Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, Google Antigravity, and fx. If they're set up on your computer, T3 Code can control them. diff --git a/docs/user/install.md b/docs/user/install.md index 1ea3792927cd9..3408500d67d90 100644 --- a/docs/user/install.md +++ b/docs/user/install.md @@ -77,10 +77,9 @@ Apart from the `.deb`, the package managers below install upstream T3 Code, not ### Linux -AppImage and `.deb` downloads are available for x86_64 and ARM64. Check your -architecture with `uname -m`: for `x86_64`, choose a file ending in -`x86_64.AppImage` or `amd64.deb`; for `aarch64`, choose `arm64.AppImage` or -`arm64.deb`. +This fork publishes AppImage and `.deb` downloads for x86_64 only, as files +ending in `x86_64.AppImage` or `amd64.deb`. Check your architecture with +`uname -m`. On `aarch64` there is no fork desktop build. To launch an AppImage, open a terminal in its download folder. Replace `T3-Code.AppImage` below with the exact filename you downloaded: @@ -94,7 +93,7 @@ The `.deb` updates itself like the other desktop builds. It asks for your password to install each update. If your desktop has no password prompt, the update fails. Download the new `.deb` and install it the same way. -The AUR packages currently support x86_64 only; on ARM64, use the AppImage. +The AUR packages install upstream T3 Code and support x86_64 only. Update AUR installs with your AUR helper, such as `yay -Syu`, instead of the in-app updater. diff --git a/packages/shared/src/fork.test.ts b/packages/shared/src/fork.test.ts index 5748fe09ccfa8..be970796c1e20 100644 --- a/packages/shared/src/fork.test.ts +++ b/packages/shared/src/fork.test.ts @@ -34,7 +34,9 @@ describe("fork release source", () => { "points install commands and release links at the fork in %s", (path) => { const source = repoFile(path); - expect(source).not.toMatch(/t3\.codes\/install|pingdotgg\/t3code\/releases/); + expect(source).not.toMatch( + /t3\.codes\/(?:install|download)|\(https:\/\/t3\.codes\)|pingdotgg\/t3code\/releases/, + ); expect(source).toContain(`raw.githubusercontent.com/${FORK_REPOSITORY}/main/scripts/install`); }, );