Farol icon

Farol

Farol 是原生 macOS 終端機,可監督 Claude Code、Codex 與其他終端機 AI 程式設計代理。透過隔離的 Git worktree 管理工作階段、掌握狀態與通知,並檢閱、解決、提交、推送變更及建立 pull request。

Farol

以代理為核心的 macOS 終端機

Farol 是原生 macOS 終端機,專為代理導向的程式設計而設:開發人員可以執行 Claude Code、Codex 與其他終端機 AI 程式設計代理,同時監督其工作階段。側邊欄與狀態指示器會顯示哪些工作階段正在工作、等待輸入或核准、已完成或處於閒置狀態。

這款應用程式將終端機工作階段與工作設定、隔離的 git worktree、程式碼檢閱及 Git 操作結合。使用者可以描述工作、指派給代理、檢閱產生的變更、在需要時解決衝突,並在不離開 Farol 的情況下提交、推送或建立 pull request。Farol 建置於 libghostty 之上,並讀取 Ghostty 設定與主題。

功能

多代理工作階段總覽

在個別工作階段中執行 Claude Code、Codex 或其他終端機代理,並查看每個代理目前正在工作、等待、完成或閒置。

背景狀態監控

無論目前使用哪個應用程式,都可以透過選單列的燈塔圖示,或位於瀏海或螢幕邊緣的面板監控工作階段。macOS 通知與 Dock 會顯示等待中的工作階段數量。

以工作為導向的 git worktree

按下 ⇧⌘N 開始工作後,Farol 會先建立新分支與 git worktree,再將工作傳送給選取的代理,避免平行工作階段共用檔案。

檢閱並交付變更

瀏覽已變更的檔案、檢視差異、在內建編輯器中快速編輯,並選擇性地在 GitHub 或 GitLab 上提交、推送或建立 pull request。

Git 歷程與分支工具

使用 git 圖表檢視分支與提交,包括 checkout、建立、rebase、刪除、cherry-pick 與 revert 操作。

衝突解決

在三欄檢視中處理 merge、rebase、cherry-pick 與 revert 衝突,互動式決定變更、編輯結果,然後繼續或中止操作。

使用情境

  • 平行實作

    將不同工作指派給 Claude Code 或 Codex,讓每個代理在自己的分支與 checkout 上工作,減少同時進行的變更彼此干擾。

  • 監督背景代理

    在編輯器、瀏覽器或其他應用程式中工作時,讓程式設計代理持續執行;當 Farol 表示工作階段需要核准或已完成時再予以回應。

  • 檢閱並交付代理變更

    檢查已變更的檔案與分支歷程、進行針對性編輯、選取要提交的檔案,並在代理完成工作後建立 pull request。

  • 解決儲存庫衝突

    當代理的分支遇到 merge、rebase、cherry-pick 或 revert 衝突時,使用內建的三欄解決工具,逐一決定變更後繼續 Git 操作。

  • 管理多個代理帳戶

    連結多個 Claude 或 Codex 帳戶,並在開始工作時選取適當帳戶,同時保留各工具現有的設定。

Pros and Cons

Pros

  • 可透過個別的 git worktree 平行執行多個 AI 程式設計工作階段。
  • 使用者在其他應用程式中工作時,也能查看狀態並接收通知。
  • 包含檢閱、編輯、Git 歷程、pull request 與衝突解決工作流程。
  • 支援 Claude Code、Codex 以及其他在終端機中執行的代理。
  • 依 MIT 授權免費且開放原始碼。

Cons

  • 需要 Apple silicon 與 macOS 14 或更新版本。
  • 代理狀態整合會因工具而異:Claude Code 使用 hooks,Codex 需要終端機標題與 hooks;其他代理則需要 Farol CLI 回報或終端機響鈴訊號。
  • 提供的定價頁面無法存取,因此除了網站宣稱免費且採 MIT 授權外,無法確認其他定價或授權條款。

FAQ

Farol 是什麼?

Farol 是一款免費、開放原始碼的 macOS 終端機應用程式,用於監督 AI 程式設計代理。它為每個代理提供工作階段、狀態指示、通知,以及在交付程式碼前使用的檢閱工具。

Farol 的系統需求與安裝方式為何?

Farol 需要配備 Apple silicon 的 Mac,並執行 macOS 14 或更新版本。您可以下載已簽署並經公證的 Farol.dmg 進行安裝,也可以使用 Homebrew 執行 brew install --cask snowztech/tap/farol。

如何將 Claude Code 或 Codex 連結至 Farol?

開啟「設定」→「代理」並連結 Claude Code 或 Codex。Claude Code 會接收 Farol 的狀態 hooks;互動式工作階段中的 Codex 會透過終端機標題回報狀態;非互動式與背景執行的 Codex hooks 則需要 0.159.2 或更新版本。連結 hooks 後,現有工作階段可能需要重新啟動。

如何平行執行程式設計工作?

按下 ⇧⌘N,描述工作、選擇代理與帳戶,並選取分支名稱。Farol 會在新分支上建立 git worktree,並將工作作為代理的第一個提示傳送出去,讓平行代理的工作區彼此分離。

Farol 是否支援 Claude Code 和 Codex 以外的代理?

可以。Farol 支援任何在終端機中執行的代理。代理可以透過以 $FAROL_CLI 公開的 Farol CLI 回報狀態;若代理讓終端機響鈴,Farol 也會將其顯示為等待中,無需額外設定。

Quick Facts

類別
開發者工具
平台
採用 Apple silicon 的 macOS
系統需求
macOS 14 或更新版本
主要使用者
監督 AI 程式設計代理的開發人員
支援的代理
Claude Code、Codex 與其他終端機代理
授權
MIT;免費且開放原始碼
Farol - AI Tool, Features, Use Cases & Alternatives | UStack