Open Source Terminal GUI

ShellFrame

非工程師也能直覺上手的 AI 終端機。
從一位設計師的需求出發,擴展到整個團隊。

2026 Python + pywebview MIT License

起源

我的合作夥伴是設計師,她看到我用 Claude Code 和 Codex 在終端機裡飛速工作,也想試試看。但她馬上遇到一個問題:終端機沒辦法貼圖

Windsurf、Cursor 這些 IDE 可以直接貼截圖問 AI,但純終端機做不到。她每次都要先存檔、再打路徑,光這一步就把使用意願磨掉了。

於是我決定做一個超輕量的 GUI 包裝器——不是 Electron 那種肥大框架,而是用 Python + 原生 OS WebView,啟動快、記憶體小。Cmd+V 就能貼圖,多分頁管理不同專案,還有 Telegram 橋接讓你不在電腦前也能遠端操作。

完成後我也推廣給公司同事使用,設計師和 PM 團隊同樣從中受益。他們終於不用再面對黑底白字的終端機——ShellFrame 把 AI CLI 工具的門檻,降到了「會用通訊軟體就會用」的程度。

痛點與解法

痛點

  • x 終端機無法直接貼圖片
  • x 非工程師害怕命令列介面
  • x 不在電腦前就無法操作 AI
  • x Electron 太肥、VS Code 太複雜

解法

  • > Cmd+V 一鍵貼上截圖
  • > 簡潔 GUI,預設指令一鍵啟動
  • > Telegram 橋接,手機遠端操作
  • > 原生 WebView,輕量無負擔

一行安裝

macOS / Linux

$ curl -fsSL https://raw.githubusercontent.com/h2ocloud/shellframe/main/install.sh | bash

自動安裝 Python venv + 所有相依套件。macOS 已有 Python,Linux 需先裝 python3。

Windows (PowerShell)

PS> irm https://raw.githubusercontent.com/h2ocloud/shellframe/main/install.ps1 | iex

需先安裝 Python 3.9+Git。安裝程式會自動設定 PATH 和桌面捷徑。

Homebrew (macOS)

$ brew tap h2ocloud/shellframe && brew install shellframe

安裝後輸入 shellframe 啟動,或從 Spotlight / 開始選單搜尋 ShellFrame。

功能亮點

📋

截圖 & 多檔貼上

Cmd+V 直接貼圖片或多個檔案,支援預覽和批次路徑送出。拖放也行。

📑

多分頁

每個分頁一個獨立 PTY session,同時管理多個專案,互不干擾。

📱

Telegram 橋接

一個 bot 管所有分頁。支援文字、圖片、檔案雙向傳輸,手機也能遠端操作 AI。

🧠

AI 上下文注入

啟動 Claude / Codex 時自動帶入環境 context,AI 立刻知道自己在 ShellFrame 裡、能做什麼。

🔄

自我進化

AI 可以直接修改 ShellFrame 的程式碼,用 sfctl reload 熱載入,不需重啟。開源精神的極致——工具和 AI 一起進化。

🌐

跨平台

Mac(.app + Spotlight)、Windows(ConPTY + Start Menu)、Linux 都支援,一行指令安裝。

技術架構

Frontend

xterm.js 終端機
原生 OS WebView
零 Electron 依賴

Backend

Python + pywebview
PTY / ConPTY
pyte 虛擬終端

Bridge

Telegram Bot API
多 session 路由
圖片/檔案雙向傳輸

Self-Evolution

sfctl 遠端控制
INIT_PROMPT.md
AI 熱載入自我修改

讓 AI 工具屬於每一個人

Claude Code 和 Codex 是強大的 AI 工具,但它們活在終端機裡——對非工程師來說,那是一道無形的牆。

ShellFrame 把這道牆拆掉了。

當設計師能用截圖問 AI 設計問題;
當 PM 能用 Telegram 遠端請 AI 幫忙整理資料;
當新人不用學 command line 就能開始用 AI——

這就是工具應該有的樣子:為人服務,而不是讓人遷就。

v0.3.0

開源 MIT — macOS / Windows / Linux