Quire CLI 正式登場：直接從終端機管理您的專案

摘要
Quire CLI 是從終端機管理 Quire 的獨立命令列工具。透過 npm 或 Homebrew 安裝一次，以 OAuth 登入，即可執行可導管、可腳本化、可排程的結構化子指令（quire project list、quire task create、quire mine）。它與 Quire MCP 伺服器屬於不同類別——後者是為 Claude Code、ChatGPT 等 AI 代理程式以工具形式呼叫 Quire 而設計的。若您長期使用終端機，並追求速度、可腳本化與可預測指令，CLI 就是您的最佳選擇。

大多數 Quire 用戶習慣在瀏覽器中工作。網頁應用程式是視覺化規劃、拖放子清單及與相關人員協作的理想介面。但有一群較為低調的用戶——開發者、營運人員、技術型項目經理，以及所有本就常駐終端機的人——對他們而言，單純為了標記三個任務完成而開啟瀏覽器分頁，根本就是多此一舉。Quire CLI 正是為這群人而生。

它不是 AI 工具，也不內建任何語言模型。它的定位就像 git、gh 或 aws：一個針對您已在使用之服務的結構化命令列介面，每個操作都對應一個可預測的指令，可導管、可腳本化、可進行行程安排。登入一次，下次需要建立任務時，您無需中斷工作流程去翻找正確的 Quire 分頁。

以下是 Quire CLI 的真實面貌：它是什麼、如何安裝、值得熟悉的指令，以及五個在第一週就能回本的工作流程範例。

什麼是 Quire CLI？

Quire CLI（npm 上的 @quire-io/quire-cli，安裝後以 quire 呼叫）是一個透過 OAuth 與 Quire API 溝通的單一執行檔。

它的特點：

• 具備可導管、可腳本化之結構化子指令的標準命令列工具。
• OAuth 驗證。執行一次 quire login，無需管理 API 金鑰，無需處理服務帳號。
• 跨平台支援。macOS、Linux、Windows，任何能執行 Node.js 或單一執行檔的環境皆可使用。
• Quire API 的直接介面。每個 CLI 指令都對應一個真實的 API 端點，CLI 的操作完全透明，沒有任何隱藏的薄層。

它不是什麼：

• AI 工具。Quire CLI 不理解自然語言。指令是結構化的（quire task create "Marketing_Q4" --name "Draft launch email"），而非專案聊天提示詞。
• 綁定於特定 AI 客戶端。若您希望 AI 代理程式代為讀寫 Quire，那是 Quire MCP 伺服器的職責。不同的介面，不同的目標用戶。

為什麼 Quire 需要 CLI？

三個具體原因，而非模糊的感受。

原因一：速度。 開啟 Quire、找到正確的專案、找到正確的任務、點擊「完成」，就算一切順利也需要 15 到 20 秒。而在已開啟的終端機中輸入 quire task complete <task-id> 只需一秒。將這個差距乘以重度 Quire 用戶每天進行的三十多次操作，時間差距便會不斷累積。

原因二：腳本與 cron 排程。 CLI 是自動化的基礎構件。早晨的 Shell 腳本可以將您的逾期任務匯出為 Markdown 摘要；make weekly-status 目標可以搜尋所有專案中本週完成的項目並生成狀態更新；cron 工作可以在每週五下午四點將結果發佈至 Slack。這些都是專案聊天視窗或網頁分頁無法做到的。

原因三：誠實的輸出。 每個 CLI 指令都會印出它所做的事。您能看到剛建立的任務 ID、API 的回應，以及失敗時的錯誤訊息。沒有隱藏的工具呼叫，也不會出現「我已幫您建立這些內容」卻無從查驗的情況。當 40 個任務即將進入共享工作區時，這種透明度正是有用工具與潛在風險之間的分界線。

Quire CLI vs Quire MCP 伺服器 vs Quire REST API

Quire 提供三種程式化操作介面。請根據工作性質選擇最適合的一種。

MCP 伺服器與 CLI 均透過 OAuth 進行身份驗證；REST API 則使用存取令牌。三者皆操作相同的資料，並遵守相同的授權規則，因此任一介面建立的任務都會立即在其他介面中顯示。

若您需要 AI 端的功能，Quire MCP 設定指南詳細說明了如何將 MCP 伺服器連接至 Claude Code、ChatGPT 或任何相容客戶端。CLI 與 MCP 是互補關係，而非互斥選擇。

前置需求

• 一個免費或付費的 Quire 帳號，且至少擁有一個您希望從終端機操控的組織與專案。
• 終端機：macOS Terminal、iTerm2、Windows Terminal 或任何 Linux Shell。
• 以下其中一項：Node.js 18 或更新版本（用於 npm 安裝）、Homebrew（macOS 或 Linux），或能從 GitHub Releases 下載單一執行檔的能力。
• 能夠在 localhost 上接收 OAuth 回調。大多數網路允許此操作，但部分企業 VPN 可能封鎖。若 quire login 在等待重定向時逾時，請聯絡 IT 部門將本機回調列入白名單。

安裝 Quire CLI

Quire CLI 以單一命令列執行檔形式提供。請選擇與您現有 CLI 管理方式相符的安裝方法。GitHub README 列出了所有選項。

npm（大多數用戶）：

npm i -g @quire-io/quire-cli

Homebrew（macOS 或 Linux）：

brew install quire-io/quire/quire

免安裝試用：

npx @quire-io/quire-cli --help

或從 GitHub Releases 頁面下載單一執行檔。

安裝完成後，執行一次性 OAuth 登入。瀏覽器分頁隨即開啟，登入 Quire 並核准工作區存取權限，CLI 便會將令牌儲存至 ~/.config/quire/credentials.json（或在可用時存入作業系統金鑰鏈）：

quire login
quire whoami

若 quire whoami 顯示您的帳號資訊，即表示已成功連線。接著可嘗試幾個實際指令：

quire project list
quire task list "Marketing_Q4"
quire mine --all-orgs --json

Quire CLI 能做什麼

完整的子指令說明載於 GitHub README，但第一天值得熟悉的指令，一個螢幕就能容納。

quire login                                       # 一次性 OAuth 設定
quire whoami                                      # 確認已登入
quire logout                                      # 移除本機憑證

quire project list                                # 列出您的專案
quire task list "<project>"                       # 列出專案中的任務
quire task tree <task-id> --depth full            # 遞迴子樹狀檢視
quire task search "release notes" --mine          # 搜尋任務（僅限您的）
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id>                     # 標記任務完成
quire mine --all-orgs --json                      # 列出您在所有組織中的任務

每個指令均支援 --help 查看完整選項。大多數指令亦支援 --json 輸出機器可讀格式，這也是以下所有工作流程範例的基礎。

每個操作均 1:1 對應一個 Quire REST API 端點。

工作流程範例

五個小型模式，能在第一週就回本。

每日站會摘要

quire mine --all-orgs --json \
  | jq -r '.[] | select(.due == "2026-05-11") | "- [" + .name + "](" + .url + ") (" + .project + ")"'

早上九點執行，將 Markdown 貼入 Slack 或每日狀態文件。在 .zshrc 加入別名，隔天早上一個字就能搞定：

alias standup='quire mine --all-orgs --json | jq -r "..."'

從會議記錄批量建立任務

grep "^TODO:" ./meetings/2026-05-04-sync.md \
  | sed 's/^TODO: //' \
  | while read task; do
      quire task create "Marketing_Q4" \
        --name "$task" \
        --tag "from-monday-sync" \
        --due 2026-05-08
    done

十二分鐘的週一行政工作，精簡為一個 Shell 迴圈。放入 Makefile 後，每週一同一個目標即可執行，無需記住語法。

Cron 工作：週五逾期任務摘要

0 17 * * 5  cd ~/work && /usr/local/bin/quire task search "overdue" --mine --json > friday.json

搭配後續腳本，將 JSON 發佈至 Slack webhook、生成 Notion 頁面，或直接以電子郵件寄給您。CLI 負責資料管線，後端接什麼由您決定。

將內容行事曆 CSV 轉換為任務

tail -n +2 ./calendar/2026-Q2.csv \
  | while IFS=, read -r publish_date channel title; do
      quire task create "Content_Pipeline" \
        --name "$title" \
        --due "$publish_date" \
        --tag "$channel"
    done

一個管線，將 CSV 轉為任務。若同時為每列加上來源識別標籤，執行出錯時亦便於清理，可達到冪等效果。

從檔案批量完成任務

cat finished_today.txt | xargs -n 1 quire task complete

其中 finished_today.txt 只是每行一個任務 ID 的清單。週五下午五點同時要關閉八件事時特別好用，在瀏覽器中逐一點擊實在令人煩躁。

Quire CLI 不適合的情況

幾個誠實的取捨說明。

• 您不使用終端機。 若 cd 讓您感到不自在，Quire 網頁應用程式才是您的正確介面。CLI 能做的事，網頁應用程式都能做；CLI 只是對本就常駐 Shell 的人來說更快捷。
• 您希望 AI 進行推理分析。 當工作內容是「找出所有停滯的專案並告訴我哪些需要上報」時，這是 AI 擅長的任務。將 Quire MCP 伺服器連接至 Claude Code、Codex CLI、ChatGPT 或 Claude Desktop，讓模型自行決定要呼叫哪些工具。CLI 負責資料管線；MCP 負責推理。
• 您需要完全託管的伺服器端整合。 對於由 webhook 觸發或在您自行維運的服務上運行的工作流程，Quire REST API 比放在開發者筆記型電腦上的 OAuth CLI 更為耐用。
• 您的網路封鎖 OAuth 本機回調重定向。 部分企業 VPN 有此限制。若 quire login 在等待重定向時卡住，請在放棄前先請 IT 部門將 127.0.0.1 回調列入白名單。

技巧與最佳實踐

• 任何需要重複使用的內容，請搭配 --json 與 jq。 純文字輸出便於閱讀；JSON 則適用於其他一切情況。大多數 CLI 指令均支援 --json。
• 精確引用專案名稱。 "Marketing_Q4" 是明確的，"那個市場的"對 CLI 來說並不是專案名稱。專案名稱區分大小寫。
• 為批量建立的任務加上標籤。 加入 --tag from-cli（或 --tag bulk-import-2026-05-11）可輕鬆找出並清理腳本執行出錯時產生的任務。
• 在新機器的設定腳本中加入 OAuth 登入步驟。 全新安裝後一行 quire login && quire whoami，讓新筆記型電腦在 30 秒內進入可用狀態。
• 善用 quire <command> --help。 它比任何部落格文章都更精簡、更準確。每個子指令的所有選項都在裡面。
• 將 CLI 與 MCP 伺服器結合使用。 確定性的工作（建立、完成、列出、搜尋）交給 CLI；模糊的工作（分流、摘要、規劃）則透過連接 MCP 的 AI 客戶端處理。相同的資料，兩個互補的操作介面。

重點摘要

2026 年最有趣的轉變，不在於 AI 客戶端能夠管理專案，而在於那些最常進行專案管理的人，早就有一個值得信賴的工具：終端機。Quire CLI 為他們提供了進入工作區的一流入口，AI 不在路徑中——除非他們主動選擇加入。

若您長期使用終端機，這週就安裝吧。將上面其中一個工作流程範例加入您的早晨或週五例行程序。設定只需五分鐘，而回報會隨著您持續使用 Quire 而不斷累積。

當推理才是工作重點時，MCP 伺服器仍是正確的工具。兩者並非競爭關係，而是同一工作區上的互補介面。

常見問題

什麼是 Quire CLI？

Quire CLI 是專為 Quire 打造的獨立命令列工具。透過 npm、Homebrew 或執行檔安裝，執行 quire login，即可從任何終端機管理任務、專案與文件。

Quire CLI 與 Quire MCP 伺服器相同嗎？

不同。Quire CLI 供人工輸入指令使用；Quire MCP 伺服器則供 AI 代理程式以工具形式呼叫 Quire 使用。資料相同，目標用戶不同。

使用 Quire CLI 需要具備開發者背景嗎？

不需要。只要您能開啟終端機並執行兩個指令，就能上手。

Quire CLI 能做什麼？

列出與搜尋任務、批量建立任務、標記完成、整理子任務、管理專案與成員、發佈留言、建立文件。Quire 的所有物件皆可存取。

什麼時候應該改用 MCP 伺服器？

當工作需要推理分析時。分流、摘要、將非結構化記錄轉化為任務。Quire CLI 適用於確定性的那一半工作流程。

Quire CLI 能在 cron 工作中使用嗎？

可以。使用 --json 輸出，以 cron 排程，將結果發佈至任何您需要的地方。

有免費方案嗎？

有。Quire 的免費方案享有與付費方案相同的 CLI 存取權限。

準備好從終端機管理您的 Quire 工作區了嗎？

安裝 Quire CLI，可透過 npm、Homebrew 或 GitHub Releases 取得。Quire 免費帳號，完整存取，無需信用卡。