v1.0 · Übersicht widget · macOS

把真正的終端機
嵌進你的 macOS 桌面

vim、htop、ssh、tmux、fzf 全部正常運作 — 因為這個 widget 把終端模擬交給 ttyd + xterm.js,你只需要拖移、縮放、鎖定。

01核心功能

不是把命令輸出抓回來貼到畫面 — 是把整個 xterm.js 真實終端嵌進桌面。

02安裝

五分鐘從零到桌面有個 widget。

相依軟體

1

安裝相依工具

Übersicht 是顯示框架,ttyd 是真正跑終端的引擎。

brew install --cask ubersicht
brew install ttyd
2

把 widget 放進 Übersicht

整個資料夾複製過去:

cp -R terminal-widget.widget \
   "$HOME/Library/Application Support/Übersicht/widgets/"
3

跑互動安裝程式(推薦)

會自動分配 port、設定招呼語、AUTORUN 指令,並可一次建立多個獨立實例。

cd "$HOME/Library/Application Support/Übersicht/widgets/terminal-widget.widget"
python3 install.py

互動流程會問你:

    4

    啟動

    Übersicht 選單列 → Refresh All Widgets。約半秒後會看到桌面浮現一個終端機,就完成了。

    03客製化

    三個檔案可以調,全部都有中文註解。

    04注意事項

    事先知道這些可以省下不少 debug 時間。

    05調整 Widget 的 Skill

    隨 widget 一起出貨的 Claude Code skill 檔,把整套架構、常見除錯陷阱、標準骨架封裝成一份可被 AI 載入的方法論。

    ⚡
    uebersicht-interactive-widget
    建構 Übersicht 互動式桌面 widget 的方法論 Skill
    SKILL.md

    這份 skill 把今天從零打造這個 widget 的整段經驗濃縮成一份結構化的指南。在 Claude Code session 內呼叫它,AI 就會帶著正確的心智模型來幫你修改 widget — 不會走我們已經踩過的彎路。

    如何呼叫

    Skill("uebersicht-interactive-widget")

    這份 Skill 教 AI 哪些事

      什麼時候請 AI 用它

        本機檔案位置

        ~/Documents/Agent-Skills-Library/uebersicht-interactive-widget/SKILL.md
        ↳ 已 symlink 到 ~/.claude/skills/ 供 Claude Code 自動載入

        06開源授權

        本 widget 與所有依賴皆採 MIT 授權,可商用、可修改、可重新散佈。

        MIT LICENSE

        自由使用

        Copyright © 2026 Scott Chen | Terminal Widget for Übersicht / ttyd / xterm.js 皆 MIT 授權。

        允許你做幾乎任何事 — 只需在散佈時保留原始版權聲明與 MIT 授權文字。 本軟體按「現況」提供,作者不對任何使用情境作擔保。