Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 8 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand All @@ -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`)

Expand All @@ -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
Expand Down
5 changes: 3 additions & 2 deletions apps/web/src/components/settings/SettingsPanels.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Expand Down Expand Up @@ -321,7 +322,7 @@ function AboutVersionSection() {
</Tooltip>
}
/>
{hasDesktopBridge ? (
{hasDesktopBridge && FORK_HAS_UPDATE_TRACKS ? (
<SettingsRow
{...searchableSetting("update-track")}
description={
Expand Down Expand Up @@ -384,7 +385,7 @@ function AboutVersionSection() {
</Select>
}
/>
) : selectedHostedAppChannel ? (
) : !hasDesktopBridge && selectedHostedAppChannel ? (
<SettingsRow
{...searchableSetting("update-track")}
description="Switches the hosted app release channel."
Expand Down
4 changes: 3 additions & 1 deletion apps/web/src/components/settings/settingsSearch.ts
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ import {
sourceControlClients,
type SourceControlDefinition,
} from "@t3tools/client-runtime/source-control-clients";
import { FORK_HAS_UPDATE_TRACKS } from "@t3tools/shared/fork";
import { DEFAULT_KEYBINDINGS } from "@t3tools/shared/keybindings";
import * as Schema from "effect/Schema";
import { TYPOGRAPHY_ADVANCED_STORAGE_KEY } from "../../appearanceFonts";
Expand Down Expand Up @@ -1503,7 +1504,8 @@ export function settingsForThisPlatform(
return items.filter(
(item) =>
(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)),
Expand Down
35 changes: 17 additions & 18 deletions docs/user/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
| ------------------------------------------------ | ----------------------------------------------------------------------- |
Expand All @@ -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
```
Expand All @@ -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 |
| ------------------ | ------------------------------------------------------------ |
Expand All @@ -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:
Expand All @@ -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.

Expand Down Expand Up @@ -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
Expand Down
3 changes: 3 additions & 0 deletions docs/user/updating.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
11 changes: 11 additions & 0 deletions packages/shared/src/fork.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
4 changes: 3 additions & 1 deletion packages/shared/src/fork.ts
Original file line number Diff line number Diff line change
@@ -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;
6 changes: 4 additions & 2 deletions scripts/install.ps1
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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
}
Expand Down
10 changes: 6 additions & 4 deletions scripts/install.sh
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -134,15 +136,15 @@ 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" ;;
x86_64 | amd64) arch="x64" ;;
*) 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
Expand Down Expand Up @@ -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
Expand Down
Loading