withoneai/cli

One CLI – 讓 AI 代理與任意網路服務溝通的命令列橋樑

是什麼 – 一個基於 Node 的 CLI（one），為 AI 驅動的代理提供統一介面，調用超過 600 個 SaaS 平台（Gmail、Slack、Stripe、Shopify、HubSpot 等）的 API。該工具自動處理認證、OAuth 流程、速率限制和請求格式，因此代理只需知道 想要做什麼，而無需了解每個服務的 如何呼叫。

如何運作

1. 設定 – one init 儲存你的 WithOne API 金鑰（或透過瀏覽器登入），並為所使用的 AI 代理（Claude、Cursor 等）安裝一個小型的「MCP」伺服器。
2. 連接平台 – one add <platform> 執行一次 OAuth 流程，建立代表已認證憑證的 connection key。
3. 發現動作 – one actions search <platform> "send email" 回傳與自然語言查詢相符的 API 動作列表（由 actionId 標示）。
4. 查看文件 – one actions knowledge <platform> <actionId> 顯示精確的請求模式、必要參數和範例。
5. 執行 – one actions execute <platform> <actionId> <connectionKey> -d '{…}' 發送請求，CLI 會自動注入正確的權杖並標準化回應。
6. 組合流程 – 使用 one flow create … 可將多個動作（例如：查找 Stripe 客戶然後寄送郵件）串聯成可重複使用、條件感知的流程，僅需一條命令即可執行。
7. 記憶體儲存 – one mem … 啟動一個本地 PostgreSQL 支援的儲存，可儲存使用者筆記和從連接平台同步的資料，支援代理進行快速的混合全文 + 語意搜尋。
8. 同步 – one sync 將平台資料拉取到記憶體儲存中，使代理無需每次呼叫外部 API 即可查詢資料。

主要命令

命令	用途
one init	認證，安裝 MCP 伺服器，選擇全域或專案級設定
one add <platform>	執行 OAuth 並建立連接金鑰
one list	顯示所有活動連接及其存取策略
one actions search …	透過自然語言描述查找 API 動作
one actions knowledge …	取得特定動作的完整文件
one actions execute …	使用 JSON 資料、路徑變數、查詢參數等呼叫動作
one flow create …	定義多階段工作流程（條件、迴圈、平行步驟）
one flow execute …	執行已儲存的工作流程
one mem …	管理本地統一記憶體儲存（新增、搜尋、列出、匯入等）
one sync	將平台資料拉入記憶體儲存以實現即時查詢
one cache …	檢查或清除 CLI 的動作元資料快取

對 AI 代理的意義

• 無需管理 API 金鑰 – 代理只需一個 connection key；CLI 在後台自動注入 OAuth 權杖。
• 統一介面 – 所有平台以相同結構（方法、路徑、JSON 模式）暴露動作，使單一 LLM 提示模板可在任何地方使用。
• 安全性 – 存取策略可依範圍（全部、方法層級、明確白名單）設定，代理在嘗試呼叫前即可知悉權限。
• 可組合工作流程 – 複雜業務邏輯（例如：「當新 Stripe 客戶出現時，發送歡迎郵件」）可表示為流程檔案，由代理程式化觸發。
• 本地記憶體 – 將資料同步至 PostgreSQL 儲存，使代理獲得快速、可搜尋的上下文，無需重複遠端呼叫，並支援透過 OpenAI 嵌入實現可選語意搜尋。

安裝

# 一次性安裝
npx @withone/cli@latest init
# 或全域安裝
npm install -g @withone/cli
one init   # 然後依照互動式提示操作

需要 Node 18+；one sync 需要 Node 20，因為它使用預建的 SQLite 二進位檔。

典型用例

one add gmail                     # OAuth 一次，取得連接金鑰
one actions search gmail "send email" -t execute
# 假設回傳的 action ID 為 12345
one actions execute gmail 12345 <key> -d '{"to":"jane@example.com","subject":"Hi","body":"Hello"}'

僅用幾條命令，代理就發送了一封經過認證的郵件，而無需處理 OAuth 權杖或學習 Gmail 的 REST 規範。

---

總結 – One CLI 是一個實用工具，抽象了數百個 SaaS API 的底層複雜性，為 AI 代理提供了一種乾淨、安全且可程式化的途徑來操作現實世界服務。