適用情境
已經有 pi 的設定、skills、provider 憑證，想知道換 ThinkRail 要重來多少。答案（官方部落格《Pi compatibility》）：
If you have Pi installed separately, both share Pi’s hidden folder,
~/.pi. … If until now you have worked in Pi’s native CLI, you can switch to ThinkRail without losing any of your work. (The same goes the other way…)
核心步驟
- 裝好直接開——ThinkRail 讀
~/.pi/agent的既有設定：provider 清單與模型、extensions、對話歷史都自動出現。驗收：chat 的 model picker 列出你原本的模型。 - skills 原地生效——
~/.pi、~/.claude、~/.codex、~/.copilot、~/.gemini及專案內對應資料夾的技能自動被掃進 Skills 視窗（技能課）。驗收：top-right 的 Skills 按鈕點開，清單分「bundled」與「來自 pi／其他代理／專案」兩段。 - （可選）隔離一套設定——想讓 ThinkRail 用乾淨環境：Settings → Environment 指向別的 pi config dir，或啟動時
PI_CODING_AGENT_DIR=~/pi-sandbox thinkrail（下次啟動生效）。 - 兩邊自由往返——同一份
~/.pi：ThinkRail 裡跑的 session，回終端機 pi CLI 接著用；反之亦然。custom servers（models.json）兩邊同步看得到。
提醒
- 相容性三注意：技能跑在 ThinkRail 內嵌的 pi 上（版本可能與你另裝的 pi 不同）；pi 的視覺擴充（如終端主題）不適用；兩擴充註冊同工具名時 pi 保留兩個並回報衝突。
- 反過來，ThinkRail 的 ask-user-question／visualize 也能裝回 vanilla pi（pi install）——搬家是雙向的。