@yushun815/ohno-cli
v0.1.0
Published
AI-powered terminal error explainer
Readme
ohno-cli
Terminal 指令失敗後,輸入 ohno 即可在原地重新執行、捕捉 stderr,並由本地 Ollama 分析錯誤原因與修復建議。
需求
安裝
npm install -g @yushun815/ohno-clinpm 不允許發佈與既有套件
opn-cli過於相似的名稱,因此使用 scoped package。安裝後指令仍為ohno。
安裝時會自動執行 postinstall,依你的 $SHELL 寫入 fish / zsh / bash hook(記錄最近一筆失敗指令至 /tmp/ohno_last_cmd)。
安裝後請重開 terminal,或手動 source 對應設定檔。
使用
$ npm run build
# ... 指令失敗 ...
$ ohno
重新執行以下指令來捕捉錯誤?
npm run build
按 Enter 確認,Ctrl+C 取消
(重新執行中...)
什麼出錯了:
...
建議修復指令:
...設定
ohno config互動式選單可調整:
| 項目 | 說明 | 預設 |
|------|------|------|
| language | AI 回答語系 | zh-TW |
| model | Ollama 模型名稱;auto 為使用本機第一個可用模型 | auto |
設定檔路徑:~/.config/ohno/config.json
運作方式
- Shell hook 在指令失敗時寫入
/tmp/ohno_last_cmd(僅記錄指令與 exit code,不捕捉 stderr) - 執行
ohno時讀取該檔,顯示確認提示 - 確認後重新執行指令,攔截 stderr 送往 Ollama
- 印出說明與建議修復指令
支援 fish、zsh、bash。
本機開發
git clone https://github.com/yushun815/ohno-cli.git
cd ohno-cli
npm install
npm link # 全域可用 ohno或直接執行:
node index.js
node index.js config手動安裝 Shell Hook
若 postinstall 未成功(不支援的 shell 等),請參考 install.sh 內容,手動將 hook 加入對應設定檔。
授權
ISC
