跳到主要內容
Kiku.sh

代理

連接代理。

只要你指定是哪個代理、它能讀什麼,Claude Code、Claude Desktop、Cursor 或你自己的腳本就能在你的 Mac 上透過 Kiku 讀取你的通話。只需三步。

  1. 1開啟「代理」

    在 Kiku 的設定中,於「代理」下開啟「允許代理讀取你的通話」。「記憶」也需要開啟。Kiku 執行時才會回應代理。

  2. 2連接代理

    點按「連接代理」,幫它取個名字,例如 Claude。選擇它讀什麼(「筆記」或「筆記和引言」)、讀哪些通話(「最近 90 天」「全部」或「從現在起」),以及能讀多久(「30 天」「90 天」或「直到我撤銷」)。

  3. 3複製它的金鑰

    Kiku 只顯示一次代理的金鑰,以 kk_ 開頭,下面的設定行也已幫你填好。現在就複製:Kiku 只保存金鑰的指紋。

MCP

把 Kiku 加到你的代理。

Kiku 的 MCP 伺服器就是 App 裡的 kiku 輔助程式。你的代理會自己啟動它,金鑰放在 KIKU_TOKEN 中。把你的金鑰填在寫著 kk_... 的地方。

Claude Code

在終端機中,對所有專案生效:

claude mcp add --scope user kiku -e KIKU_TOKEN=kk_... -- /Applications/Kiku.app/Contents/Helpers/kiku mcp

然後在 Claude Code 中輸入 /mcp,就能看到 kiku 和它的工具。

Claude Desktop

在 Claude 中,依序進入設定、開發者、編輯設定,會打開 claude_desktop_config.json。加入以下內容,然後重新啟動 Claude:

{
  "mcpServers": {
    "kiku": {
      "command": "/Applications/Kiku.app/Contents/Helpers/kiku",
      "args": [
        "mcp"
      ],
      "env": {
        "KIKU_TOKEN": "kk_..."
      }
    }
  }
}

Cursor

對所有專案,把同樣的設定區塊放進 ~/.cursor/mcp.json;只對一個專案,放進 .cursor/mcp.json(別把金鑰提交到 git)。然後在 Cursor 設定的 MCP 中開啟 kiku。

其他 MCP App

指令為 /Applications/Kiku.app/Contents/Helpers/kiku,參數為 mcp,金鑰放在 KIKU_TOKEN 環境變數中。

然後問問看,例如:「關於發布日期,我們是怎麼決定的?」或「幫今天早上的通話寫一封跟進郵件。」

命令列

kiku api,給你的腳本用。

同一個輔助程式也能在 shell 中回應,每個操作一個子指令。kiku api 列出所有子指令,kiku api list_meetings --help 說明其中一個。透過管線輸出時(或加上 --json)印出 JSON,在終端機中則印出表格。

export KIKU_TOKEN=kk_...
alias kiku=/Applications/Kiku.app/Contents/Helpers/kiku
kiku api list_meetings --since 7d
kiku api get_meeting 1791194400000-launch01 --json | jq .result.notes
kiku api brief --people "Léa Martin" --people "Tom Becker"

本機 API

留在你 Mac 上的 REST API。

這一切底下是一個 REST API,執行在 Kiku 資料夾裡的一個 socket 上,只有你能打開:沒有網路連接埠,所以任何網頁、任何其他使用者都無法連上。它在 /v1/openapi.json 描述自己,也在 /v1/llms.txt 為讀網頁的代理提供說明。每個回答都會註明出自哪通電話。

curl --unix-socket "$HOME/Library/Application Support/Kiku/api.sock" \
  -H "Authorization: Bearer $KIKU_TOKEN" \
  "http://localhost/v1/meetings?since=7d"

它能回答什麼

search
依關鍵字搜尋以前的通話,最相關的排在前面,並附上符合的句子。
list_meetings
通話列表,最新的在前,可依日期、人或 App 篩選。
get_meeting
一通電話的筆記:摘要、決定、後續事項。
list_people
Kiku 從你的通話中認識的人。
get_person
和某人的通話,以及雙方各自的後續事項。
list_commitments
尚未完成的後續事項,你的或對方的。
list_decisions
就某個主題做出的決定。
brief
和這些人開會前的一份簡報。

如果它沒有回應

unauthorized
Kiku 不認得這把金鑰:代理已被撤銷,或金鑰輸入錯誤。
off
Kiku 設定中的「代理」處於關閉狀態。
needs_app
Kiku 沒有在執行。打開它即可。

由你掌控

始終屬於你的。

Kiku 自己什麼都不傳送。你連接的代理為了回答你,通常會把讀到的內容傳給其模型所屬的公司,而通話裡的其他人並沒有選擇這樣做。這台 Mac 上以你的身分執行的程式也能直接讀取 Kiku 的資料夾:金鑰只控制它們透過 Kiku 能拿到什麼。

Claude Code 可以透過它的 shell 讀取檔案。要讓它只讀你允許的內容,請把以下內容加到 ~/.claude/settings.json:

"permissions": {
  "deny": [
    "Read(~/Library/Application Support/Kiku/**)",
    "Bash(*Application Support/Kiku*)"
  ]
}