翻訳準備中 — 韓国語の原文を表示しています。

NomaDamas/katok

Apple Silicon Mac의 카카오톡 대화를 로컬에서 키워드·BM25·의미론적 검색으로 찾는 Rust CLI

完成アプリ要確認データ・クローリングRust難易度
254+2今週0
30フォーク0Issue
콜드바이트 さんが用意した一膳
2026년 7월 30일에 차림 · 차린 밥상 60그릇
用意した人を見る →

中辛 の解説

Rust로 작성된 macOS 전용 로, Apple Silicon Mac의 카카오톡 앱 DB를 직접 읽어 로컬 아카이브·BM25 인덱스·EmbeddingGemma 벡터 인덱스를 구축합니다. 설치는 Homebrew 또는 Cargo로 간단하며, 초기 설정 후 터미널에서 katok search 명령으로 즉시 사용 가능합니다. 의존성으로 Python 서버나 외부 없이 모든 처리가 로컬에서 일어나므로 프라이버시가 보장됩니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • 과거 카카오톡 대화 중 특정 정보(계약서, 회의록, 계좌번호)를 빠르게 찾아야 할 때
  • 의미가 비슷한 대화를 검색하되 서버에 데이터를 올리고 싶지 않을 때
  • Vercel Agent나 Codex 같은 AI 에이전트가 사용자의 카카오톡 맥락을 참고해야 할 때

핵심 기능

keyword·BM25·semantic 세 가지 검색 모드EmbeddingGemma 로컬 벡터 임베딩(Python 서버 불필요)SQLCipher 복호화 및 메시지 정규화, parent window 기반 chunk 분할

대안 대비 차별점

Python 종속성 없이 순수 Rust로 macOS SQLCipher DB를 직접 읽으며, 로컬 EmbeddingGemma 벡터 검색으로 외부 API 호출 없이 의미론적 검색을 제공합니다.

食べた人たち

実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。

試食評 · 使った人のひとこと

まだ試食評がありません。使ってみたら、最初のひとことをどうぞ。

ほかのリポジトリの試食評を見る →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

준비물

  • Apple Silicon Mac
  • macOS 카카오톡 앱
  • 터미널 앱의 전체 디스크 접근 권한

すぐ動かしてみるRust (cargo)

ギット飯がリポジトリの構成を確認して組み立てた実行コマンドです。ターミナルに貼り付ければ、取得から実行までまとめて進みます。

git clone --depth 1 https://github.com/NomaDamas/katok.git &&
cd katok &&
cargo run

コードは自分の環境で動きます — はじめて見るリポジトリなら、中身にひととおり目を通してから実行するのがおすすめです。

README가 안내하는 자세한 단계 보기
  1. Homebrew로 설치합니다.
brew tap NomaDamas/katok https://github.com/NomaDamas/katok.git
brew install katok

또는 Cargo로 설치합니다.

cargo install katok
  1. 터미널에 전체 디스크 접근 권한을 부여합니다.
katok permissions macos

System Settings가 열리면 사용 중인 Terminal/iTerm/Codex 또는 katok 실행 파일을 Full Disk Access에 추가하세요.

  1. 설정을 진단합니다.
katok doctor --json
  1. 카카오톡 DB를 동기화합니다.
katok sync --source macos --json
  1. 벡터 인덱스를 구축합니다.
katok index --json
  1. 검색을 실행합니다.
katok search keyword "계약서" --json
katok search bm25 "지난주 미팅 자료" --json
katok search semantic "최근에 논의한 세금 신고 일정" --json

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try NomaDamas/katok

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

254+2 / 7일

使いやすさ · まねしやすいか

まねしやすいサンプル評点 44/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2026 年に作成

「데이터·크롤링」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/NomaDamas/katok.svg)](https://www.gitbap.com/r/NomaDamas/katok)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る