Claude Code 循環：本地後台任務隊列管理器

Claude Code 循環：本地後台任務隊列管理器

Aiball 是一個開源本地守護進程，專為 Claude Code 用户設計，旨在提供一個共享積壓任務隊列，實現多會話間的無縫協調。該項目由 David Berlioz 開發，採用 MIT 許可證，目前處於實驗階段。

核心機制

Aiball 的核心是“軟循環”（soft-loop）機制。用户或另一個 Claude 會話可以隨時通過 Web UI、MCP 工具 (ticket_new) 或 CLI 提交任務（ticket）。任務會落入指定項目的積壓隊列中，並定向到特定的 Claude 會話 (通過 consumer_id) 或廣播給項目所有者。

關鍵設計在於，Claude 會話在處理當前任務時不會被中斷。當會話的當前回合結束時，Stop 鈎子會觸發（由 claude-loop 全局註冊或每循環註冊），檢查該消費者的積壓隊列。如果非空，鈎子會將待處理的任務以提示形式注入到下一輪用户提示中，彷彿用户直接輸入了“這是積壓任務”。

隨後，Claude 會逐個處理積壓任務：讀取任務、發佈回覆（通過 ticket_reply）、提出解決方案（標記為“resolved”），並關閉自己的任務（標記為“close”），每個動作都會向其他訂閲者發出事件。循環持續直到沒有可操作的任務為止，會話在保有完整上下文的情況下正常結束。

重要設計選擇

• 決策附加在評論上：當代理提出解決方案時，標籤直接附加在評論上，而不是獨立的“決策”行。報告者可以在原地接受或拒絕，審計線索保留在做出決策的線程中。
• SSE 事件總線：claude-loop 會話訂閲 /api/events，在有新通知時立即喚醒，無需輪詢延遲。

界面與工具

Aiball 提供多種操作方式：

• Web UI：瀏覽器界面，支持任務管理、項目統計等。
• CLI 命令：aiball 命令用於初始化、檢查狀態等；claude-loop 命令用於啓動帶有 tmux 包裝器的循環會話。
• MCP 工具：包括 poll、unread、ticket_get、ticket_reply、ticket_new、subscribe 等。

特別推薦使用 claude-loop 包裝器，它將 Claude 會話保留在 tmux 中，自動處理積壓任務。用户可以在一天中排隊多個任務，然後離開，Claude 會在每次收到通知時喚醒並處理它們。

安裝與使用

快速安裝步驟：

1. 克隆倉庫並運行 ./install.sh --auth-init 來安裝守護進程（systemd 用户單元）和二進制文件。
2. 在瀏覽器中打開 http://127.0.0.1:7777 創建管理員賬户。
3. 在每個倉庫中運行 aiball init 來配置 .mcp.json 和 .aiball.yaml。
4. 使用 claude-loop -- --resume 啓動循環會話。

其他設置包括：交互式 Claude（不帶 tmux）、裸 MCP 配置、創建消費者令牌、通過 Tailscale 遠程訪問等。

功能特性

• 每個項目範圍內的任務與線程評論，支持 Markdown、圖片粘貼、自動鏈接引用和子任務。
• 移動端讀取收件箱（通過 Tailscale 私有加密連接）。
• 審核規則與策略（手動/自動/自動回覆）。
• 生命週期信號：解決方案提議、阻塞升級、暫停、重新打開。
• 可點擊問答：任務主體中的 GFM 複選框變為可點擊引用的提問。
• 自動輪詢停止鈎子。
• 全文搜索（FTS5）、項目統計、離線備用 CLI。

技術細節

守護進程運行在 127.0.0.1，使用 Unix 域套接字和 SQLite 數據庫。所有存儲保留在本地 ~/.local/share/aiball 目錄下，無雲後端，無遙測。

生命週期管理：通過 systemctl --user start/stop aiball 控制，日誌可通過 journalctl 查看，數據目錄即 ~/.local/share/aiball。狀態檢查使用 aiball check 命令。

目前僅支持 Claude Code，但協議是通用的（MCP + 小型 HTTP/CLI 表面），未來可能支持其他 CLI 代理。

總結

Aiball 為 Claude Code 用户提供了一種優雅的異步工作流管理方式，將任務排隊與自動化處理結合，避免了中斷和上下文丟失。它的本地優先、無遙測的設計也符合隱私意識用户的需求。儘管目前處於實驗階段，API 和模式仍在變化，但其核心概念已經展示出提升 AI 代理協同工作生產力的潛力。