From a544a890a16e9d41f54cbbd5d3e258193c6b8a70 Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Sun, 29 Mar 2026 22:19:41 -0700
Subject: [PATCH 1/2] Document install options for T3 Code

- Split the install section into run-without-install and desktop app methods
- Add platform-specific install commands and package references
---
 README.md | 33 ++++++++++++++++++++++++++++++---
 1 file changed, 30 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 5f842e3709..883222ff5a 100644
--- a/README.md
+++ b/README.md
@@ -2,18 +2,45 @@
 
 T3 Code is a minimal web GUI for coding agents (currently Codex and Claude, more coming soon).
 
-## How to use
+## Installation
 
 > [!WARNING]
 > You need to have [Codex CLI](https://github.com/openai/codex) installed and authorized for T3 Code to work.
 
+### Run without installing
+
 ```bash
 npx t3
 ```
 
-You can also just install the desktop app. It's cooler.
+### Desktop app
+
+Install the desktop app using whichever method fits your platform:
+
+- Direct download: [GitHub Releases](https://github.com/pingdotgg/t3code/releases)
+- Windows (`winget`):
+
+```bash
+winget install T3Tools.T3Code
+```
+
+- macOS (Homebrew):
+
+```bash
+brew install --cask t3-code
+```
+
+- Arch Linux (AUR, with an AUR helper such as `yay`):
+
+```bash
+yay -S t3code-bin
+```
+
+Package references:
 
-Install the [desktop app from the Releases page](https://github.com/pingdotgg/t3code/releases)
+- `winget`: [pingdotgg/t3code#1544](https://github.com/pingdotgg/t3code/issues/1544), [winget-pkgs manifest](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/T3Tools/T3Code/)
+- Homebrew: [t3-code cask](https://formulae.brew.sh/cask/t3-code#default)
+- AUR: [t3code-bin](https://aur.archlinux.org/packages/t3code-bin)
 
 ## Some notes
 

From 1311258c3cb8c0ce319ddd5e7168557d892f656e Mon Sep 17 00:00:00 2001
From: Julius Marminge <julius0216@outlook.com>
Date: Sun, 29 Mar 2026 22:22:33 -0700
Subject: [PATCH 2/2] Clarify desktop install methods in README

- Split download, winget, Homebrew, and AUR installs into their own sections
- Add package references for each platform
---
 README.md | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 883222ff5a..be07ecdf9f 100644
--- a/README.md
+++ b/README.md
@@ -17,31 +17,34 @@ npx t3
 
 Install the desktop app using whichever method fits your platform:
 
-- Direct download: [GitHub Releases](https://github.com/pingdotgg/t3code/releases)
-- Windows (`winget`):
+#### Direct download
+
+[GitHub Releases](https://github.com/pingdotgg/t3code/releases)
+
+#### Windows (`winget`)
+
+Reference: [pingdotgg/t3code#1544](https://github.com/pingdotgg/t3code/issues/1544), [winget-pkgs manifest](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/T3Tools/T3Code/)
 
 ```bash
 winget install T3Tools.T3Code
 ```
 
-- macOS (Homebrew):
+#### macOS (Homebrew)
+
+Reference: [t3-code cask](https://formulae.brew.sh/cask/t3-code#default)
 
 ```bash
 brew install --cask t3-code
 ```
 
-- Arch Linux (AUR, with an AUR helper such as `yay`):
+#### Arch Linux (AUR)
+
+Reference: [t3code-bin](https://aur.archlinux.org/packages/t3code-bin)
 
 ```bash
 yay -S t3code-bin
 ```
 
-Package references:
-
-- `winget`: [pingdotgg/t3code#1544](https://github.com/pingdotgg/t3code/issues/1544), [winget-pkgs manifest](https://github.com/microsoft/winget-pkgs/tree/master/manifests/t/T3Tools/T3Code/)
-- Homebrew: [t3-code cask](https://formulae.brew.sh/cask/t3-code#default)
-- AUR: [t3code-bin](https://aur.archlinux.org/packages/t3code-bin)
-
 ## Some notes
 
 We are very very early in this project. Expect bugs.