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
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ body:
id: version
attributes:
label: T4 Code version
placeholder: "0.1.17"
placeholder: "0.1.18"
validations:
required: true
- type: dropdown
Expand Down
33 changes: 16 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,35 +4,34 @@ T4 Code is a free, open-source (MIT) desktop app for [Oh My Pi](https://github.c

![T4 Code main window](docs/assets/t4-code-main.png)

[**Download v0.1.17**](https://github.com/LycaonLLC/t4-code/releases/tag/v0.1.17) · [**Docs**](https://t4code.net/docs) · [**Get the source**](#build-from-source)
[**Download v0.1.18**](https://github.com/LycaonLLC/t4-code/releases/tag/v0.1.18) · [**Docs**](https://t4code.net/docs) · [**Get the source**](#build-from-source)

## Requirements

T4 Code needs an OMP build with desktop appserver support. For v0.1.17, use the public integration build below.
T4 Code needs an OMP build with desktop appserver support. For v0.1.18, use the public integration build below.

T4 Code v0.1.17 was verified with OMP 16.5.2 built from [`264958b2`](https://github.com/lyc-aon/oh-my-pi/commit/264958b23acac16baaf3bf0024129dc1a57f9d14), tagged [`t4code-16.5.2-appserver-4`](https://github.com/lyc-aon/oh-my-pi/tree/t4code-16.5.2-appserver-4). That public integration is based on the official upstream [`v16.5.2`](https://github.com/can1357/oh-my-pi/tree/v16.5.2) tag at [`7d02778c`](https://github.com/can1357/oh-my-pi/commit/7d02778c60f4b5db60f84bedbca79d6e64cb91f5). The transcript behavior introduced in appserver-2 remains unchanged: tool results preserve sanitized structured details, subagent RPC reads have byte and record ceilings, and child-transcript image digests use the same verified image-read path as the parent session. Appserver-4 fixes the appserver clean-source TypeScript/build check and makes the appserver type check plus full runtime tests mandatory before OMP release binaries can publish. It also carries forward T4's appserver, lifecycle, image, session-control, and atomic maintenance integration. The official upstream v16.5.2 tag has no `appserver` command, so it cannot host T4 Code. The verified runtime is a normal build from the public `lyc-aon/oh-my-pi` source; T4 Code does not depend on private home-directory files, an auth broker, or a custom Codex CLI fork. T4 Code vendors `@oh-my-pi/app-wire` 0.5.5 from integration commit [`6a87fa64`](https://github.com/lyc-aon/oh-my-pi/commit/6a87fa6407ebff20417b4d52885a6bb3091003ea), source tree `a2495fe8781c979184fe7fb9a6d37d8f33bad30f`.
T4 Code v0.1.18 was verified with OMP 17.0.0 built from [`6e2f2350`](https://github.com/lyc-aon/oh-my-pi/commit/6e2f2350cfe9e6f5db691c311333cae33cdb62ba), tagged [`t4code-17.0.0-appserver-1`](https://github.com/lyc-aon/oh-my-pi/tree/t4code-17.0.0-appserver-1). That public integration is based on the official upstream [`v17.0.0`](https://github.com/can1357/oh-my-pi/tree/v17.0.0) tag at [`d5cd24f3`](https://github.com/can1357/oh-my-pi/commit/d5cd24f39a951bfbd50dc8f50bcf095d59694d6c). It carries T4's bounded transcript replay, structured tool-result details, child-agent transcript and image projection, session lifecycle controls, ordered outbound frames, and atomic maintenance drain onto the 17.0.0 codebase. Fork CI rechecks the exact upstream ancestry before publishing binaries. The official upstream v17.0.0 tag has no `appserver` command, so it cannot host T4 Code. The verified runtime is a normal build from the public `lyc-aon/oh-my-pi` source; T4 Code does not depend on private home-directory files, an auth broker, or a custom Codex CLI fork. T4 Code vendors `@oh-my-pi/app-wire` 0.5.5 from integration commit [`6a87fa64`](https://github.com/lyc-aon/oh-my-pi/commit/6a87fa6407ebff20417b4d52885a6bb3091003ea), source tree `a2495fe8781c979184fe7fb9a6d37d8f33bad30f`.

| Platform | Arch | Package |
| -------- | --------------------- | ---------------------------------------- |
| Android | arm64, armv7, x86_64 | `.apk` (**signed**) |
| Linux | x86_64 | `.deb`, AppImage |
| macOS | Apple Silicon (arm64) | `.dmg`, `.zip` (**unsigned, see below**) |

No Windows build and no Intel Mac build in v0.1.17. The iOS TestFlight build is coming soon.
No Windows build and no Intel Mac build in v0.1.18. The iOS TestFlight build is coming soon.

## What changed in v0.1.17
## What changed in v0.1.18

- Empty working-folder rows now have a **Remove shortcut** action. It only hides the row in the current T4 Code client; it does not delete the folder or any OMP session.
- The preference survives a restart. Archived sessions stay visible, **Show shortcut** restores the row, and a new or restored current session makes the row visible again.
- T4 Code disables removal while the host's session inventory is incomplete, so an unseen current session cannot be hidden by mistake.
- The verified OMP appserver-4 runtime and app-wire 0.5.5 contract are unchanged.
- The verified runtime now uses the exact official OMP 17.0.0 base at `d5cd24f3`.
- The public appserver integration keeps bounded replay, image prompts and transcript images, two-client session control, reconnect-safe history, and atomic maintenance drain.
- The app-wire contract remains at 0.5.5, so this compatibility release does not introduce a client protocol migration.

## Install

### Android

1. On the Android phone, sign in to Tailscale with an account that can reach the T4 Code host.
2. Download [`T4-Code-0.1.17-android.apk`](https://github.com/LycaonLLC/t4-code/releases/download/v0.1.17/T4-Code-0.1.17-android.apk).
2. Download [`T4-Code-0.1.18-android.apk`](https://github.com/LycaonLLC/t4-code/releases/download/v0.1.18/T4-Code-0.1.18-android.apk).
3. If Android asks, allow your browser or file manager to install unknown apps, then install the APK.
4. Open T4 Code and enter the host's HTTPS Tailscale address, including its port.

Expand All @@ -41,26 +40,26 @@ The APK does not contain an appserver or expose one to the public internet. It c
### Linux (Debian/Ubuntu)

```sh
wget https://github.com/LycaonLLC/t4-code/releases/download/v0.1.17/T4-Code-0.1.17-linux-amd64.deb
sudo apt install ./T4-Code-0.1.17-linux-amd64.deb
wget https://github.com/LycaonLLC/t4-code/releases/download/v0.1.18/T4-Code-0.1.18-linux-amd64.deb
sudo apt install ./T4-Code-0.1.18-linux-amd64.deb
```

Use `apt install` rather than `dpkg -i` so system dependencies resolve automatically.

### Linux (AppImage)

```sh
wget https://github.com/LycaonLLC/t4-code/releases/download/v0.1.17/T4-Code-0.1.17-linux-x86_64.AppImage
chmod +x T4-Code-0.1.17-linux-x86_64.AppImage
./T4-Code-0.1.17-linux-x86_64.AppImage
wget https://github.com/LycaonLLC/t4-code/releases/download/v0.1.18/T4-Code-0.1.18-linux-x86_64.AppImage
chmod +x T4-Code-0.1.18-linux-x86_64.AppImage
./T4-Code-0.1.18-linux-x86_64.AppImage
```

### macOS (Apple Silicon)

> [!WARNING]
> **The macOS v0.1.17 build is unsigned and unnotarized.** Apple has not signed or notarized it, so Gatekeeper can report a "damaged" app or an unidentified developer. Only continue if you trust the release from this repository. You can always build from source instead.
> **The macOS v0.1.18 build is unsigned and unnotarized.** Apple has not signed or notarized it, so Gatekeeper can report a "damaged" app or an unidentified developer. Only continue if you trust the release from this repository. You can always build from source instead.

1. Download [`T4-Code-0.1.17-mac-arm64.dmg`](https://github.com/LycaonLLC/t4-code/releases/download/v0.1.17/T4-Code-0.1.17-mac-arm64.dmg) (or [`T4-Code-0.1.17-mac-arm64.zip`](https://github.com/LycaonLLC/t4-code/releases/download/v0.1.17/T4-Code-0.1.17-mac-arm64.zip)).
1. Download [`T4-Code-0.1.18-mac-arm64.dmg`](https://github.com/LycaonLLC/t4-code/releases/download/v0.1.18/T4-Code-0.1.18-mac-arm64.dmg) (or [`T4-Code-0.1.18-mac-arm64.zip`](https://github.com/LycaonLLC/t4-code/releases/download/v0.1.18/T4-Code-0.1.18-mac-arm64.zip)).
2. Drag `T4 Code.app` into `/Applications`.
3. If Gatekeeper blocks the app and you choose to proceed, remove the quarantine attributes from the copied app bundle:

Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ We read every report and will reply to tell you what happens next. This is a sma

- T4 Code is a desktop client. The OMP runtime is a separate project; runtime vulnerabilities belong at <https://github.com/can1357/oh-my-pi>.
- Pairing credentials are encrypted with the OS keychain via Electron `safeStorage`. Reports about credential handling, the pairing flow, or the `t4-code://` deep-link handler are especially welcome.
- The macOS v0.1.17 build is unsigned and unnotarized; that is a known, disclosed limitation, not a vulnerability report. Removing `com.apple.quarantine` changes Gatekeeper handling but does not sign, notarize, or verify the app.
- The macOS v0.1.18 build is unsigned and unnotarized; that is a known, disclosed limitation, not a vulnerability report. Removing `com.apple.quarantine` changes Gatekeeper handling but does not sign, notarize, or verify the app.
2 changes: 1 addition & 1 deletion apps/desktop/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@t4-code/desktop",
"version": "0.1.17",
"version": "0.1.18",
"private": true,
"type": "module",
"main": "dist-electron/main.cjs",
Expand Down
2 changes: 1 addition & 1 deletion apps/desktop/src/target-manager.ts
Original file line number Diff line number Diff line change
Expand Up @@ -339,7 +339,7 @@ export class DesktopTargetManager {
capabilities: requestedCapabilities,
requestedFeatures: REQUESTED_FEATURES,
compatibilityRequestedFeatures: COMPATIBILITY_FEATURES,
client: { name: "T4 Code", version: "0.1.17", build: "desktop", platform: process.platform },
client: { name: "T4 Code", version: "0.1.18", build: "desktop", platform: process.platform },
reconnect: { attemptCap: 12, baseMs: 250, maxMs: 10_000 },
};
const client = createOmpClient(clientOptions);
Expand Down
2 changes: 1 addition & 1 deletion apps/mobile/capacitor.config.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"appName": "T4 Code",
"webDir": "dist",
"loggingBehavior": "debug",
"appendUserAgent": " T4CodeMobile/0.1.17",
"appendUserAgent": " T4CodeMobile/0.1.18",
"android": {
"path": "android",
"minWebViewVersion": 60,
Expand Down
2 changes: 1 addition & 1 deletion apps/mobile/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@t4-code/mobile",
"version": "0.1.17",
"version": "0.1.18",
"private": true,
"type": "module",
"scripts": {
Expand Down
2 changes: 1 addition & 1 deletion apps/site/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@t4-code/site",
"version": "0.1.17",
"version": "0.1.18",
"private": true,
"type": "module",
"scripts": {
Expand Down
24 changes: 12 additions & 12 deletions apps/site/src/release.ts
Original file line number Diff line number Diff line change
Expand Up @@ -5,16 +5,16 @@ export const SITE_URL = "https://t4code.net";
export const DOCS_URL = `${SITE_URL}/docs`;
export const REPO_URL = "https://github.com/LycaonLLC/t4-code";
export const OMP_URL = "https://github.com/can1357/oh-my-pi";
export const OMP_RUNTIME_VERSION = "16.5.2";
export const OMP_RUNTIME_COMMIT = "264958b23acac16baaf3bf0024129dc1a57f9d14";
export const OMP_RUNTIME_TAG = "t4code-16.5.2-appserver-4";
export const OMP_RUNTIME_VERSION = "17.0.0";
export const OMP_RUNTIME_COMMIT = "6e2f2350cfe9e6f5db691c311333cae33cdb62ba";
export const OMP_RUNTIME_TAG = "t4code-17.0.0-appserver-1";
export const OMP_RUNTIME_URL = `https://github.com/lyc-aon/oh-my-pi/tree/${OMP_RUNTIME_TAG}`;
export const OMP_UPSTREAM_TAG = "v16.5.2";
export const OMP_UPSTREAM_COMMIT = "7d02778c60f4b5db60f84bedbca79d6e64cb91f5";
export const OMP_UPSTREAM_TAG = "v17.0.0";
export const OMP_UPSTREAM_COMMIT = "d5cd24f39a951bfbd50dc8f50bcf095d59694d6c";
export const OMP_UPSTREAM_URL = `${OMP_URL}/tree/${OMP_UPSTREAM_TAG}`;
export const APP_WIRE_VERSION = "0.5.5";
export const RELEASE_TAG = "v0.1.17";
export const RELEASE_VERSION = "0.1.17";
export const RELEASE_TAG = "v0.1.18";
export const RELEASE_VERSION = "0.1.18";
export const RELEASES_URL = `${REPO_URL}/releases/tag/${RELEASE_TAG}`;

export type Platform = "android" | "linux" | "mac";
Expand Down Expand Up @@ -48,11 +48,11 @@ function asset(
}

export const RELEASE_ASSETS: readonly ReleaseAsset[] = [
asset("android", "apk", "universal", "T4-Code-0.1.17-android.apk", "Android APK"),
asset("linux", "deb", "x86_64", "T4-Code-0.1.17-linux-amd64.deb", "Linux .deb"),
asset("linux", "appimage", "x86_64", "T4-Code-0.1.17-linux-x86_64.AppImage", "Linux AppImage"),
asset("mac", "dmg", "arm64", "T4-Code-0.1.17-mac-arm64.dmg", "macOS .dmg"),
asset("mac", "zip", "arm64", "T4-Code-0.1.17-mac-arm64.zip", "macOS .zip"),
asset("android", "apk", "universal", "T4-Code-0.1.18-android.apk", "Android APK"),
asset("linux", "deb", "x86_64", "T4-Code-0.1.18-linux-amd64.deb", "Linux .deb"),
asset("linux", "appimage", "x86_64", "T4-Code-0.1.18-linux-x86_64.AppImage", "Linux AppImage"),
asset("mac", "dmg", "arm64", "T4-Code-0.1.18-mac-arm64.dmg", "macOS .dmg"),
asset("mac", "zip", "arm64", "T4-Code-0.1.18-mac-arm64.zip", "macOS .zip"),
];

export function assetsFor(platform: Platform): readonly ReleaseAsset[] {
Expand Down
30 changes: 15 additions & 15 deletions apps/site/test/release.test.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
// Release contract guard: exact v0.1.17 asset names and URLs, and the
// Release contract guard: exact v0.1.18 asset names and URLs, and the
// platform-detection rule the hero download button relies on.
import { describe, expect, it } from "vite-plus/test";
import {
Expand All @@ -19,13 +19,13 @@ import {
} from "../src/release.ts";

describe("release assets", () => {
it("carries the five contracted v0.1.17 filenames", () => {
it("carries the five contracted v0.1.18 filenames", () => {
expect(RELEASE_ASSETS.map((a) => a.filename)).toEqual([
"T4-Code-0.1.17-android.apk",
"T4-Code-0.1.17-linux-amd64.deb",
"T4-Code-0.1.17-linux-x86_64.AppImage",
"T4-Code-0.1.17-mac-arm64.dmg",
"T4-Code-0.1.17-mac-arm64.zip",
"T4-Code-0.1.18-android.apk",
"T4-Code-0.1.18-linux-amd64.deb",
"T4-Code-0.1.18-linux-x86_64.AppImage",
"T4-Code-0.1.18-mac-arm64.dmg",
"T4-Code-0.1.18-mac-arm64.zip",
]);
});

Expand All @@ -37,8 +37,8 @@ describe("release assets", () => {

it("targets the public LycaonLLC repo", () => {
expect(REPO_URL).toBe("https://github.com/LycaonLLC/t4-code");
expect(RELEASE_TAG).toBe("v0.1.17");
expect(RELEASE_VERSION).toBe("0.1.17");
expect(RELEASE_TAG).toBe("v0.1.18");
expect(RELEASE_VERSION).toBe("0.1.18");
});

it("splits assets by platform with correct architectures", () => {
Expand All @@ -59,14 +59,14 @@ describe("release assets", () => {

describe("OMP integration contract", () => {
it("pins the verified runtime tag, commit, and app-wire package", () => {
expect(OMP_RUNTIME_TAG).toBe("t4code-16.5.2-appserver-4");
expect(OMP_RUNTIME_COMMIT).toBe("264958b23acac16baaf3bf0024129dc1a57f9d14");
expect(OMP_RUNTIME_TAG).toBe("t4code-17.0.0-appserver-1");
expect(OMP_RUNTIME_COMMIT).toBe("6e2f2350cfe9e6f5db691c311333cae33cdb62ba");
expect(OMP_RUNTIME_URL).toBe(
"https://github.com/lyc-aon/oh-my-pi/tree/t4code-16.5.2-appserver-4",
"https://github.com/lyc-aon/oh-my-pi/tree/t4code-17.0.0-appserver-1",
);
expect(OMP_UPSTREAM_TAG).toBe("v16.5.2");
expect(OMP_UPSTREAM_COMMIT).toBe("7d02778c60f4b5db60f84bedbca79d6e64cb91f5");
expect(OMP_UPSTREAM_URL).toBe("https://github.com/can1357/oh-my-pi/tree/v16.5.2");
expect(OMP_UPSTREAM_TAG).toBe("v17.0.0");
expect(OMP_UPSTREAM_COMMIT).toBe("d5cd24f39a951bfbd50dc8f50bcf095d59694d6c");
expect(OMP_UPSTREAM_URL).toBe("https://github.com/can1357/oh-my-pi/tree/v17.0.0");
expect(APP_WIRE_VERSION).toBe("0.5.5");
});
});
Expand Down
2 changes: 1 addition & 1 deletion apps/web/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@t4-code/web",
"version": "0.1.17",
"version": "0.1.18",
"private": true,
"type": "module",
"scripts": {
Expand Down
1 change: 1 addition & 0 deletions apps/web/src/app.css
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,7 @@
height: 100dvh;
max-width: 100%;
width: 100%;
isolation: isolate;
overflow: hidden;
}
}
Expand Down
2 changes: 1 addition & 1 deletion apps/web/src/platform/browser-shell-port.ts
Original file line number Diff line number Diff line change
Expand Up @@ -279,7 +279,7 @@ export function createBrowserShellPort(
},
client: {
name: "T4 Code",
version: "0.1.17",
version: "0.1.18",
build: mobilePlatform ?? "browser",
platform: mobilePlatform ?? (platform === "darwin" ? "darwin" : "linux"),
},
Expand Down
14 changes: 7 additions & 7 deletions compat/omp-app-matrix.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,14 @@
},
"verifiedRuntime": {
"package": "omp",
"version": "16.5.2",
"version": "17.0.0",
"sourceRepository": "https://github.com/lyc-aon/oh-my-pi",
"sourceCommit": "264958b23acac16baaf3bf0024129dc1a57f9d14",
"sourceUrl": "https://github.com/lyc-aon/oh-my-pi/commit/264958b23acac16baaf3bf0024129dc1a57f9d14",
"sourceTag": "t4code-16.5.2-appserver-4",
"sourceCommit": "6e2f2350cfe9e6f5db691c311333cae33cdb62ba",
"sourceUrl": "https://github.com/lyc-aon/oh-my-pi/commit/6e2f2350cfe9e6f5db691c311333cae33cdb62ba",
"sourceTag": "t4code-17.0.0-appserver-1",
"upstreamRepository": "https://github.com/can1357/oh-my-pi",
"upstreamTag": "v16.5.2",
"upstreamCommit": "7d02778c60f4b5db60f84bedbca79d6e64cb91f5",
"upstreamTag": "v17.0.0",
"upstreamCommit": "d5cd24f39a951bfbd50dc8f50bcf095d59694d6c",
"integrationPatches": [
"bounded-growing-session-replay",
"complete-session-event-projection",
Expand Down Expand Up @@ -60,6 +60,6 @@
},
"desktop": {
"package": "@t4-code/protocol",
"version": "0.1.17"
"version": "0.1.18"
}
}
Loading
Loading