Timmy-TUI

Timmy-TUI

Timmy-TUI 是一個基於 TypeScript、由 OpenRouter 提供支援的終端 UI 搭建,它為您提供了一個可運行的代理程式線束,具有串流聊天、可配置工具和開箱即用的內建會話持久性。
https://github.com/woodman33/openrouter-tui-agent?ref=producthunt&utm_source=aipure
Timmy-TUI

產品資訊

更新時間:2026年06月12日

什麼是 Timmy-TUI

Timmy-TUI 是一個終端使用者介面 (TUI) 專案範本,用於在 OpenRouter 之上建構 AI 代理程式。概念上類似於「create-react-app」,但適用於終端代理程式,它以 TypeScript 搭建了一個完整、可執行的程式碼庫,其中包括代理程式執行器、配置系統、互動式 CLI 入口點和一個入門工具套件(檔案操作、搜尋和 shell 執行)。目標是讓開發人員能夠快速建立一個在終端中感覺原生且完全可自訂的代理程式——無論是在 UI 行為(輸入樣式、工具渲染模式、橫幅)還是代理程式功能(工具定義和模組)方面。

Timmy-TUI 的主要功能

Timmy-TUI 是一個終端原生的 AI 代理介面和骨架,可協助您從命令列快速建置和執行可自訂的代理驅動工作流程。它基於 OpenRouter 代理 TUI 骨架的參考來源,強調一個可立即執行的 TypeScript 專案結構,具有可配置的模型/提供者、串流輸出、會話持久性以及可插拔的工具系統(例如,檔案操作、搜尋、shell 執行)。它旨在為開發人員提供一個類似於「create-react-app」的代理 TUI 起點,讓他們可以專注於代理邏輯和工具,同時保留精緻的互動式終端體驗。
骨架代理 TUI 專案: 產生一個可執行的 TypeScript/Node 專案(配置、代理運行器、CLI 入口點和可選模組),因此您可以從單個提示開始建置代理 TUI,而不是手動組裝基礎設施。
可自訂的終端使用者體驗: 支援多種互動樣式和工具顯示模式,具有終端友好的渲染(例如,橫幅、自適應 UI 行為),旨在使長時間的代理會話可讀且操作員友好。
串流響應 + 令牌可見性: 專為即時、串流模型輸出和狀態式回饋(包括某些實作中的令牌計數)而設計,這提高了編碼和調試等迭代任務的可用性。
會話持久性和可重放性: 儲存對話(通常是 JSONL 樣式)以在運行中保留上下文,從而實現審計、恢復工作和比較代理行為。
工具/插件式架構: 提供一個工具註冊表模式,您可以在其中啟用內建工具(檔案讀取/寫入/編輯、grep/glob、列出目錄、shell 命令)並按照一致的模式添加自己的工具。
透過 OpenRouter 實現提供者/模型靈活性: 針對 OpenRouter 風格的路由,因此相同的 TUI 可以透過統一配置(透過 env/config 分層的鍵)在許多模型/提供者之間工作。

Timmy-TUI 的使用案例

終端中的開發人員編碼代理: 使用 Timmy-TUI 作為本地優先的編碼助手,可以讀取/編輯檔案、執行 shell 命令,並在保留持久會話日誌的同時迭代實施功能。
內部操作/運行手冊自動化: 將常見的操作任務(日誌檢查、配置編輯、腳本檢查)包裝成工具,並讓操作員透過帶有串流回饋的引導式代理 TUI 驅動它們。
安全和合規性分類: 建立工作流程以掃描儲存庫、搜尋危險模式、總結發現並產生可審計的會話記錄以供審查。
客戶支援故障排除控制台: 建立一個遵循故障排除手冊的代理,查詢本地工件(日誌/配置),並在一致的終端 UI 中產生逐步修復指南。
資料/機器學習實驗平台: 原型化小型代理工具,用於資料集檢查、實驗編排和結果總結,同時保留可重現的會話和可配置的模型選擇。

優點

快速實現第一個代理:骨架提供了一個完整的可工作基準(配置、運行器、工具、UI),設置最少。
可擴展的工具系統:內建檔案/搜尋/shell 工具和添加自訂工具的清晰模式。
良好的操作員人體工程學:串流輸出、可讀的工具渲染和會話持久性支援長時間運行的工作流程。

缺點

終端優先的使用者體驗限制了受眾:喜歡網頁 GUI 的使用者可能會覺得 TUI 不太容易使用。
工具的強大功能增加了風險:在敏感環境中啟用 shell/檔案寫入工具需要仔細的沙盒和權限控制。
模型/提供者配置可能會令人困惑:多提供者路由和模型選擇可能需要額外的配置調整才能符合預期。

如何使用 Timmy-TUI

1) 安裝先決條件: 安裝 Node.js(建議使用現代 LTS)並確保您有可用的 OpenRouter API 金鑰。
2) 取得 Timmy-TUI 專案(搭建或複製): 如果您要從頭開始建立 Timmy-TUI,請安裝 OpenRouter 技能並搭建一個 TUI 代理程式專案:`gh skill install OpenRouterTeam/skills create-agent-tui`。然後執行您的編碼代理程式並要求它生成一個 TUI 代理程式(它將使用該技能)。如果您已經有一個 Timmy-TUI 儲存庫,請改為複製它。
3) 安裝依賴項: 在專案資料夾中,安裝套件:`npm install`。
4) 配置您的 OpenRouter 金鑰: 從範本建立一個環境檔案(通常是 `.env.example` -> `.env`)並設定 `OPENROUTER_API_KEY=your-key-here`。
5) 審查並設定模型/配置: 開啟 `src/config.ts`(分層配置:預設值 -> 檔案 -> 環境)並設定您想要的模型/提供者選項。這是您選擇 Timmy-TUI 使用哪個 OpenRouter 模型的地方。
6) 啟動 Timmy-TUI: 以開發模式執行 TUI(通常):`npm start`(或專案的等效腳本)。您應該會看到一個帶有串流輸出的終端 UI。
7) 使用互動式 REPL: 直接在 TUI 輸入中輸入提示。Timmy-TUI 會串流回應,並通常在介面中顯示令牌計數和工具活動。
8) 使用內建工具(如果啟用): 由 create-agent-tui 搭建的 Timmy-TUI 專案通常在 `src/tools/` 下包含工具,例如檔案讀取/寫入/編輯、glob、grep、list-dir 和 shell 執行。當代理程式決定使用工具時,TUI 會渲染工具呼叫和結果。
9) 新增或自訂工具: 編輯 `src/tools/index.ts` 以註冊工具,並在 `src/tools/` 中按照 `@openrouter/agent/tool` 模式新增工具檔案。重新啟動應用程式以載入更改。
10) 自訂終端 UI: 調整搭建的 UI 模組(通常是 `src/renderer.ts` 和相關檔案)中的渲染和顯示行為。該搭建支援多種輸入樣式和工具顯示模式;選擇您喜歡的並調整格式。
11) 使用會話持久性: Timmy-TUI 搭建通常透過 `src/session.ts` 將對話持久化為 JSONL。根據專案的 CLI/TUI 控制項啟動新會話或恢復先前會話;在配置的儲存位置驗證保存的會話檔案。
12) 排除模型/配置不匹配問題: 如果 UI 顯示意外模型,請確認配置分層順序(預設值 -> 檔案 -> 環境)並確保您的模型識別碼與 OpenRouter 預期的格式匹配。重新檢查 `OPENROUTER_API_KEY` 是否已載入到用於啟動 TUI 的環境中。

Timmy-TUI 常見問題

Timmy-TUI 是指來自 OpenRouter Skills 生態系統的終端使用者介面 (TUI) 鷹架方法,它讓 AI 編碼代理能夠在 TypeScript 中生成一個完整、可執行的代理 TUI 專案——其精神類似於 create-react-app,但適用於基於終端的 AI 代理。

与 Timmy-TUI 类似的最新 AI 工具

Gait
Gait
Gait 是一個集成 AI 辅助代碼生成和版本控制的協作工具,使團隊能夠高效地追蹤、理解和共享 AI 生成代碼的上下文。
invoices.dev
invoices.dev
invoices.dev 是一個自動化發票平台,直接從開發者的 Git 提交生成發票,並具有 GitHub、Slack、Linear 和 Google 服務的集成能力。
EasyRFP
EasyRFP
EasyRFP 是一個 AI 驅動的邊緣計算工具包,通過深度學習技術簡化 RFP(請求提案)回應並實現實時田間表型。
Cart.ai
Cart.ai
Cart.ai 是一個 AI 驅動的服務平台,提供全面的業務自動化解決方案,包括編碼、客戶關係管理、視頻編輯、電商設置和定制 AI 開發,並提供 24/7 支持。