diff --git a/README.md b/README.md index 1f63f3609ae0d..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. @@ -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 d408d6c8d5d94..75e53c3be1af5 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 1b892851dd39a..3408500d67d90 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 | | ------------------ | ------------------------------------------------------------ | @@ -77,10 +77,9 @@ or use a package manager: ### 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. @@ -161,8 +160,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..be970796c1e20 100644 --- a/packages/shared/src/fork.test.ts +++ b/packages/shared/src/fork.test.ts @@ -30,6 +30,17 @@ 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|download)|\(https:\/\/t3\.codes\)|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 da7e540755691..64851b84991a6 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 @@ -134,7 +136,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" ;; @@ -142,7 +144,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 @@ -213,7 +215,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