Open Source Terminal GUI
ShellFrame
非工程師也能直覺上手的 AI 終端機。
從一位設計師的需求出發,擴展到整個團隊。
起源
我的合作夥伴是設計師,她看到我用 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
自動安裝 Python venv + 所有相依套件。macOS 已有 Python,Linux 需先裝 python3。
Windows (PowerShell)
需先安裝 Python 3.9+ 和 Git。安裝程式會自動設定 PATH 和桌面捷徑。
Homebrew (macOS)
安裝後輸入 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——
這就是工具應該有的樣子:為人服務,而不是讓人遷就。