現在 · Workspace-first Codex runtime

threadBridge

threadBridge 是 workspace-first 的 Codex runtime。它把 macOS desktop process 作為 owner，Telegram 只是 adapter；真正重要的是讓 workspace、session、local TUI 和遠端訊息都能回到同一條可維護的工作連續性。

Agent RuntimeRustTelegramLocal-first

Narrative

設計與工程判斷

Product frame

這個 project 處理的是 agent 使用中的真實摩擦：人在 Telegram 裡提出需求，在本地 workspace 裡執行工作，還需要知道 session 是否可延續、workspace 是否 busy、什麼時候可以修復或切回本地。

Engineering frame

系統由 Rust desktop runtime owner、local management API、Telegram adapter、app-server observer、workspace runtime surface 和受管 hcodex entrypoint 組成。重點是 session bind/new/repair、workspace execution mode、TUI mirror 和 Telegram routing。

Design frame

這不是聊天 bot 包裝，而是 agent runtime 的操作界面設計：setup、launch、reconnect、archive、repair、approval、plan mode 和 final reply 都需要清楚、可恢復、可被使用者理解。

System

組件和資料可見性

Component	Type	Visibility	Role
threadbridge_desktop	macOS runtime owner	Public repo	持有 local management API、tray menu 和 runtime reconcile flow。
Telegram adapter	Remote interaction surface	Public repo	把 workspace thread 的文字、圖片、問題 flow 和 plan/default mode 連回保存的 Codex session。
Local management UI	Browser / API surface	Public repo	處理 setup、launch、reconnect、archive/restore、runtime repair 和 transcript inspection。
.threadbridge / hcodex	Workspace runtime surface	Public repo	在真實 workspace 裡安裝受管入口、狀態文件和 local TUI continuation。
Release pipeline	macOS distribution	Public release	建立 universal app bundle、簽名、notarize、DMG 和 release candidate。

Public URLs

公開工作面

Source GitHub

Public implementation for the workspace-first Codex runtime, desktop owner, and Telegram adapter.

github.com/qoli/threadBridge Distribution Releases

Release surface for macOS builds, candidates, and distribution state.

github.com/qoli/threadBridge/releases Media YouTube demo

Public video surface for seeing the runtime and interaction model in motion.