K-Browser

開源 · MIT · macOS

你的 agent，你的 Chrome，你的規則。

K-Browser 讓你 Mac 上的 agent 使用你已經登入的 Chrome,在你看得到的視窗裡操作。每個 agent 只看得到自己開的分頁，不會搶走你的鍵盤，需要人處理時就把分頁交給你。

開始使用運作方式
幾分鐘就能裝好
# 1
$ npm install
# 2 · agent + 橋接
$ k-browser install
? Block site categories: banking,email
✓ claude-code  ✓ codex  ✓ antigravity  ✓ gemini-cli
# 3 · 配對擴充
$ k-browser pair
$ k-browser doctor
"ok": true, "startedBy": "launchd"
支援以及任何你給它專屬 CDP 端點的程式

三個小部分，一條清楚的界線

agent 從不直接碰 Chrome。每個要求都先經過本機的橋接，它知道是誰在要求、可以做什麼。

  1. 1

    MCP server

    每家 agent 一份

    每家 agent 有自己的 token 和權限。Claude Code、Codex、Antigravity、Gemini CLI 都會自動登記好。

  2. 2

    橋接

    127.0.0.1:9444

    登入時自動啟動的本機小服務。套用每個 client 的規則、遮掉秘密、留下活動紀錄。

  3. 3

    擴充

    在你的 Chrome 裡

    只操作 agent 自己的分頁，放在永遠不會跳到前面的獨立視窗。用你手上的配對碼配對。

從設計上讓你保有控制權

agent 操作你已登入的瀏覽器時，必須容易看、容易停，而且跑不出它該在的範圍。

在側邊面板看清楚一切

打開 K-Browser 側邊面板，就能看到每個 agent 在做什麼、處理交接，並調整它的規則，不用改設定檔。

  • 每個 agent 的分頁和動作，即時更新
  • 等你處理的交接，有「顯示」和「交還」
  • 每個 agent 的封鎖類別、截圖、eval
  • 撤銷 agent,或關閉它的分頁
K-Browser 側邊面板：兩個 agent、一個等待處理的交接、它們的分頁和動作紀錄。
側邊面板(範例資料)。介面跟著 Chrome 的語言(繁體中文或英文)。

agent 拿到的工具

15 個 MCP 工具，範圍都限定在 agent 自己的分頁。

在文件看所有工具

選用:用 Kav 跑存好的流程

Kav-FastwebAgent 執行事先寫好的網站流程，每一步都不用呼叫模型。設定 Kav 後,agent 會多一個 run_flow,以那個 agent 的身分在你的 Chrome 裡跑，規則一樣適用。Kav 要判斷時預設交給本機模型;雲端模型要你選擇，並會先列出會送出什麼。

Kav 流程

開始使用

需要 macOS、Chrome 125 以上、Node.js 22 以上。

  1. 取得程式
    git clone https://github.com/kaiwutech-TW/k-browser.git && cd k-browser && npm install
  2. 登記你的 agent,啟動橋接
    k-browser install
  3. 在 chrome://extensions 載入 extension/(開發人員模式 → 載入未封裝項目)
  4. 配對擴充和橋接
    k-browser pair
  5. 確認，然後重開你的 agent
    k-browser doctor
完整安裝說明