tmux-ide 2.6.1 → 2.8.0

package/README.md

@@ -1,8 +1,25 @@
-# tmux-ide
-
-[![CI](https://github.com/wavyrai/tmux-ide/actions/workflows/ci.yml/badge.svg)](https://github.com/wavyrai/tmux-ide/actions/workflows/ci.yml)
-
-**The terminal that understands your agents.**
+<p align="center">
+  <picture>
+    <source
+      media="(prefers-color-scheme: dark)"
+      srcset="https://raw.githubusercontent.com/wavyrai/tmux-ide/main/.github/assets/icon-dark.png"
+    />
+    <img
+      src="https://raw.githubusercontent.com/wavyrai/tmux-ide/main/.github/assets/icon-light.png"
+      alt="tmux-ide"
+      width="120"
+      height="120"
+    />
+  </picture>
+</p>
+
+<h1 align="center">tmux-ide</h1>
+
+<p align="center"><strong>The terminal that understands your agents.</strong></p>
+
+<p align="center">
+  <a href="https://github.com/wavyrai/tmux-ide/actions/workflows/ci.yml"><img src="https://github.com/wavyrai/tmux-ide/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+</p>
 
 Other tools rebuild the terminal to understand agents. tmux-ide teaches the terminal you already use to understand them. One command adds a native chrome to any tmux session: a fleet of tabs with live agent-status glyphs, ground-truth working/blocked/done detection, notifications when an agent needs you, and a crash-proof restore that rebuilds your whole fleet — including your Claude conversations. It's built _around_ tmux, so there's nothing to migrate and nothing to lock into.
 
@@ -121,15 +138,20 @@ pnpm build:tui   # → packages/daemon/dist/tui/tmux-ide-tui (requires bun to bu
 
 It bundles every surface behind a `tmux-ide-tui <surface> [flags]` dispatcher,
 embeds the native OpenTUI dylib, and pre-transforms JSX at build time — so it
-needs no runtime. The CLI resolves surfaces checkout-first, binary-second; the
-binary is the installed fallback.
-
-**Note:** a compiled binary is platform-specific (built for the host
-OS/arch). Shipping it for every platform requires per-target builds
-(`--target bun-<os>-<arch>`); a single npm tarball carries only the build host's
-binary. Until per-platform artifacts are wired, installs on other platforms fall
-back to the "install bun + run from a checkout" path, which `tmux-ide doctor`
-spells out.
+needs no runtime. The CLI resolves surfaces checkout-first, then a shipped/local
+compiled binary, then a per-platform binary downloaded on demand.
+
+**Per-platform binaries.** The npm tarball does _not_ carry the ~70MB binary (a
+surprise on every install). Instead each release publishes one per platform
+(darwin-arm64, darwin-x64, linux-x64, linux-arm64) as a GitHub release asset. On
+a machine with no `bun` and no shipped binary, fetch the right one on demand:
+
+```bash
+tmux-ide update --tui-binary   # downloads it to ~/.tmux-ide/bin/ (verified, chmod +x)
+```
+
+Nothing is downloaded automatically on install. `tmux-ide doctor`'s "TUI
+surfaces" row spells out how surfaces currently resolve on your machine.
 
 ## Contributor workflow