Knowns CLI
Knowns · 生產力 · AI 學習
Knowns CLI 是一套本機優先的命令列工具，為 AI 程式助理提供專案的持久記憶層。你不必在每次對話重複同一段脈絡，只要在儲存庫裡執行一次 `knowns init`。之後，任務、文件、決策與代理脈絡會持續連結在終端機與本機 WebUI 之間。它能與 Claude Code、Codex、GitHub Actions 等工具並行運作。不需要任何託管帳號。
關於 Knowns CLI
什麼是 Knowns CLI
Knowns CLI 處理的是任何使用 AI 程式助理的人都很快會碰到的問題：助理會忘。每個新工作階段都從零開始，於是你得重新解釋架構、重新貼上同樣的檔案，然後希望模型自己把線索接起來。Knowns 把這些脈絡從對話視窗搬到儲存庫本身，讓人與代理日後都能檢視。
這套工具圍繞著一組精簡指令運作，指令會留下結構化狀態。knowns init 建立儲存庫的記憶層。knowns task create 把一件工作變成可定址的物件，帶著優先順序、關聯與來源脈絡。knowns retrieve 回傳附有引用的排序脈絡包，而不是毫無根據的猜測。knowns doctor 則在工作開始前，把斷裂的參照與過時的指引找出來。
有兩個限制值得先知道。Knowns 是開發者工具，不是消費級 App。如果你不習慣終端機，又沒在用程式代理，這裡能給你的東西不多。語意搜尋還需要嵌入供應商，例如 Ollama 或相容 OpenAI 的端點；少了它，搜尋會退回關鍵字結果。這對檢索品質是實質的降級。工具本身仍然可用。
開始使用
- 用 Homebrew、npm、shell 腳本、PowerShell 或 npx 安裝 CLI，再用
knowns --version驗證。 - 切換到你想讓 Knowns 管理的儲存庫，執行
knowns init建立本機記憶層與輕量指引檔案。 - 用
knowns task create "Setup project" -d "Initialize project with Knowns"建立第一項任務，並用knowns doc create建立第一份文件。 - 執行
knowns search與knowns validate，確認檢索找得到你的脈絡，且專案結構沒問題。 - 用
knowns setup claude --global或knowns setup codex --global連接你的 AI 平台，再以knowns browser --open開啟 WebUI。
產品資訊
快速了解 Knowns CLI 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 使用 AI 程式助理的獨立開發者：只要你習慣執行終端機指令，Knowns 能讓 Claude Code 或 Codex 跨工作階段取得可靠的專案脈絡。
- 小型工程團隊：共享的任務、文件與可引用的決策，能省下反覆的到職說明。每個人都得在本機安裝 CLI。
任務
- 找回專案脈絡：`knowns retrieve` 會組成含引用的脈絡包，讓代理一開始就有真實來源，而不是猜測。
- 追蹤已規劃的工作：任務帶著優先順序與關聯，所以待辦事項會與背後的檔案和決策保持連結。
- 稽核文件健康度：`knowns doctor` 會在斷裂的參照與過時指引拖垮工作階段之前先把它們標出來。
情境
- 在長期運作的儲存庫開啟新工作階段：記憶層讓你不用每次都重貼同樣的檔案。
- 在多個專案之間切換：每個儲存庫各自保留記憶，脈絡不會在程式庫之間滲漏。
- 在 CI 執行代理工作流程：GitHub Actions 能讀取你本機 CLI 寫入的同一份專案狀態。
主要功能
持久的專案記憶
核心概念很簡單：指令會留下結構化脈絡，而不只是印出結果。儲存庫初始化一次，之後任務、文件、決策與代理脈絡就會持續連結。這就是一個只回答問題的工具，跟一個會把答案記到下次的工具之間的差別。
可引用的脈絡檢索
knowns retrieve 回傳附有引用的排序脈絡包。每筆引用都包含類型，以及路徑或 ID。你可以先搜尋找出候選來源，只有當工作流程需要更深時，才用 --expand-references 展開關聯。關鍵字、語意與混合模式都可用。
以任務管理作為專案狀態
透過 CLI 建立的任務會成為可定址物件，不只是一行清單項目。優先順序、關聯與來源脈絡會跟著每項任務走，所以 knowns task TASK-042 --plain 會回傳可審閱的內容。正是這樣的結構，讓程式代理能接手既有任務，立刻理解塑造它的決策、文件與相關工作，而你不必把這些背景貼進對話。
取代重複脈絡的文件
文件保存專案耐久知識。這比在每個 AI 對話重新解釋同一套架構要好。knowns doc create 把它們加進 CLI 與 WebUI 共用的同一份儲存庫，所以真相只有一個版本。
本機 WebUI
knowns browser --open 會開啟本機 WebUI，對映 CLI 的專案狀態，包括任務、文件、圖譜檢視與設定。你不必離開自己的機器，也不用登入託管服務，就能取得視覺化總覽。
為程式代理設定平台
knowns setup <target> --global 會為 Claude Code、Codex、OpenCode、Kiro、Cursor、Gemini CLI、GitHub Copilot 及通用代理目標產生正確的 MCP 整合設定、skills 與執行階段 hooks。Claude 使用 /kn- 技能指令。Codex 使用 $kn- 指令。
用 knowns doctor 做健康檢查
過時的指引與斷裂的參照，往往是你在最糟的時刻才會發現的東西，通常是在任務進行到一半，代理自信滿滿地照著一份已經不符程式碼的文件走。knowns doctor 會在工作開始前把它們找出來，讓記憶層長期保持可信。
彈性安裝
單一二進位檔為各平台發佈，不綁任何共享函式庫，所以 CLI 在 macOS、Linux 與 Windows 上行為一致。Homebrew、npm、shell、PowerShell 與 npx 都支援。npx 讓你不用全域安裝就能試用。
優缺點
優點
- 本機優先設計，沒有託管帳號，專案記憶留在自己的機器上。
- 可引用的檢索讓代理取得有根據的來源，而不是自信的猜測。
- 平台涵蓋範圍紮實，從 Claude Code、Codex 到 Cursor 與 GitHub Copilot 都有。
- 能搭配你現有的儲存庫，不需要搬遷步驟。
缺點
- 語意搜尋需要另外的嵌入供應商，否則品質會退回關鍵字搜尋。
- 沒有託管帳號，代表脈絡預設不會跨機器同步。
- 如果你是命令列工具新手，會有小小的學習曲線，因為價值來自持續使用指令。
常見問題
它為 AI 程式助理提供持久的專案記憶。你把儲存庫初始化一次，任務、文件、決策與代理脈絡就會持續連結。助理不會再於工作階段之間失去脈絡。
相關內容
探索與 Knowns CLI 相關的工具、技能與文章。
Knowns CLI 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改，看著預覽確認結果，再以 Pull Request 交回工程團隊。
Knocket
Knocket (Tencent RTC team) · 生產力 · 商業 · 聊天機器人Knocket 是免費的線上客服與聯絡頁面工具，訪客可從網站、App 或一條分享連結傳訊息，你在 Telegram 或單一收件匣就能回覆。
FloorGen
Vinit Kumar (FloorGen) · 生產力 · 中國 AIFloorGen 是瀏覽器上的平面圖製作工具，能把一句描述或一張草圖變成可編輯的 2D 平面圖與 3D 導覽。可匯出 PDF、DXF 或影片，不註冊也能開始畫。