Repository navigation
Releases
RepoFind v0.2.1
A fix for the first-run model download, which could sit at 0% for a long time when huggingface.co was slow.
Fixed
- Slow downloads move to the other host. With the download source on Auto, RepoFind now tries huggingface.co and hf-mirror.com side by side and starts with whichever answers faster. If the speed then stays under 200 KB/s for 8 seconds, or the connection drops, it moves to the other host and continues from where it stopped instead of starting over. If both are slow, it stays on the faster one rather than switching back and forth.
- Downloaded models are checked.
model.onnxmust match its published SHA-256 andtokenizer.jsonmust be valid JSON before a model is used. A damaged file is deleted and the app asks you to download again. - The progress line says more. It shows the download speed, notes when it switched host ("switched to hf-mirror.com"), and shows a short "Checking…" step at the end.
Nothing else changed since v0.2.0. Indexes and downloaded models from v0.2.0 keep working; no rebuild is needed.
Downloads
| Platform | File | Needs | Tested |
|---|---|---|---|
| macOS, Apple silicon | RepoFind-0.2.1-macos-arm64.zip |
macOS 14+ | CI, plus a local build of the same code |
| macOS, Intel | RepoFind-0.2.1-macos-x86_64.zip |
macOS 14+ | CI only |
| Linux x86_64 | RepoFind-0.2.1-linux-x86_64.tar.gz |
glibc 2.39+, GTK 4.14+, WebKitGTK 6.0 (Ubuntu 24.04 or later) | CI only |
| Linux arm64 | RepoFind-0.2.1-linux-arm64.tar.gz |
same as above | CI only |
| Windows x86_64 | RepoFind-0.2.1-windows-x86_64.zip |
Windows 10 1809+ | CI only |
How the switching was tested: against two local stand-in hosts, one of which slows to 20 KB/s after the first megabyte. The download moved to the other host mid-file and the joined file passed the SHA-256 check. A real download from huggingface.co with resume also passed. The Intel Mac build still has no local models.
Each file has a .sha256 next to it. Install as for v0.2.0: on macOS, clear the quarantine flag once with xattr -dr com.apple.quarantine /Applications/RepoFind.app.
修复第一次下载模型的问题:huggingface.co 很慢时,下载可能长时间卡在 0%。
修复
- 下载慢了会换源:下载源选「自动」时,会同时试 huggingface.co 和 hf-mirror.com,哪个响应快先用哪个。下载途中如果连续 8 秒低于 200 KB/s,或者断线,会换到另一个源,从已下好的部分接着下,不用从头再来。两个源都慢时,留在快一点的那个上,不来回切换。
- 下完会校验:
model.onnx要和官方公布的 SHA-256 一致,tokenizer.json必须是合法的 JSON,通过后才会使用。文件损坏会被删掉,并提示重新下载。 - 进度信息更详细:显示下载速度;换了源会注明「已切换到 hf-mirror.com」;最后有一步「正在校验」。
除此之外和 v0.2.0 相同。v0.2.0 的索引和已下载的模型都能继续用,不需要重建索引。
换源的测试方式:在本机起两个替身下载源,其中一个下到 1 MB 后限速到 20 KB/s。下载中途切到了另一个源,前后两段拼起来的文件通过了 SHA-256 校验。从 huggingface.co 真实下载和续传也测过。Intel Mac 版仍然没有本地模型。
安装方式和 v0.2.0 相同;macOS 上需要执行一次 xattr -dr com.apple.quarantine /Applications/RepoFind.app。
RepoFind v0.2.0
Semantic search now works without any API key: RepoFind ships with a local embedding model that runs inside the app. There is also a new Atlas page that sorts your repos by topic, language and recency.
What's new
- Local embedding models. The default,
multilingual-e5-small(135 MB), downloads the first time you build the index. After that, search works offline and nothing leaves your machine. You can also downloadbge-small-zh-v1.5,multilingual-e5-baseorbge-m3in Settings, switch between them, or delete them. Downloads resume after an interruption and fall back to hf-mirror.com when huggingface.co can't be reached. - Three embedding sources. Pick a local model, a server already running on your machine (LM Studio, llama.cpp, Ollama), or any OpenAI-compatible API. If you configured an API in v0.1.x, the app keeps using it.
- Atlas, now the first page. It counts your repos by topic, language, last touched, local commits, source host and owner. Click any count to filter; search then runs only within the filtered repos. A radar view puts each repo in a sector by topic, farther from the centre the longer since you last touched it.
- Open in Finder / Terminal. Every result can be opened in Finder (File Explorer or the file manager on other systems) or in a terminal. On macOS you can choose Terminal, iTerm, Ghostty, Warp and others in Settings.
- Faster. Rebuilding the index only re-embeds repos whose text changed. Topics are worked out once, when you scan. On 328 repos, opening the Atlas went from about 740 ms to under 30 ms, and result lists are virtualized.
- Richer index. It now reads each repo's description, keywords and dependencies from its manifest (package.json, Cargo.toml, pyproject.toml, go.mod, pom.xml and others), its top-level files, and how many commits you made locally.
- Clearer empty states. If search finds nothing because there is no index yet, the app says so and offers Build index now.
Downloads
| Platform | File | Needs | Tested |
|---|---|---|---|
| macOS, Apple silicon | RepoFind-0.2.0-macos-arm64.zip |
macOS 14+ | CI, plus a local build of the same code run by hand |
| macOS, Intel | RepoFind-0.2.0-macos-x86_64.zip |
macOS 14+ | CI only |
| Linux x86_64 | RepoFind-0.2.0-linux-x86_64.tar.gz |
glibc 2.39+, GTK 4.14+, WebKitGTK 6.0 (Ubuntu 24.04 or later) | CI only |
| Linux arm64 | RepoFind-0.2.0-linux-arm64.tar.gz |
same as above | CI only |
| Windows x86_64 | RepoFind-0.2.0-windows-x86_64.zip |
Windows 10 1809+ | CI only |
"CI only" means the type check and headless tests pass and the package builds on that platform; nobody has opened the app there yet. On Apple silicon, downloading the default model, indexing and semantic search were run by hand on real repos. The Open in Finder / Open in Terminal buttons are covered by tests but have not been clicked on any real machine yet.
The Intel Mac build has no local models, because ONNX Runtime ships no prebuilt library for it. Use a local service or an external API there; Settings says so.
Each file has a .sha256 next to it.
Upgrading from v0.1.x
- Your scan roots and API settings carry over.
- Rebuild the index once. Older indexes lack descriptions and topics, and older vectors don't record what text they were made from, so the first rebuild embeds everything again.
- v0.1.x can't read vectors written by v0.2.0. If you go back, that version falls back to lexical search until you rebuild with it.
Install
- macOS: unzip, then move
RepoFind.appto Applications. The build is ad hoc signed and not notarized, so clear the quarantine flag once:xattr -dr com.apple.quarantine /Applications/RepoFind.app - Linux: extract the archive and run the
RepoFindexecutable inside it. - Windows: unzip and run
RepoFind.exe. It is not code signed, so SmartScreen warns on first launch ("More info" → "Run anyway").
现在不配 API key 也能语义搜索了:RepoFind 内置了在应用里运行的本地 embedding 模型。另外新增了「总览」页,按主题、语言和最近变动给仓库分类。
新功能
- 本地 embedding 模型:默认模型
multilingual-e5-small(135 MB)在第一次建索引时自动下载,之后离线也能搜,数据不出本机。设置里还可以下载bge-small-zh-v1.5、multilingual-e5-base、bge-m3,随时切换或删除。下载中断能续传,连不上 huggingface.co 时会自动改用 hf-mirror.com。 - 三种向量来源:可以选本地模型、本机已经在跑的服务(LM Studio、llama.cpp、Ollama),或任意 OpenAI 兼容接口。v0.1.x 里配过 API 的,升级后继续沿用。
- 总览页,现在是首页:按主题、语言、最近变动、本机提交、来源、归属统计仓库。点任意一项就筛选,之后的搜索只在筛出来的仓库里进行。雷达图里每个仓库是一个点:所在扇区是主题,离圆心越远说明越久没动过。
- 用 Finder 或终端打开:每条结果都能在 Finder(其他系统上是资源管理器或文件管理器)里打开,也能在终端里打开。macOS 上可以在设置里选 Terminal、iTerm、Ghostty、Warp 等。
- 更快:重建索引时,只有文本变了的仓库才重新生成向量;主题在扫描时算一次。在 328 个仓库上,打开总览从约 740 ms 降到 30 ms 以内,结果列表也改成了虚拟列表。
- 索引内容更丰富:会读 manifest(package.json、Cargo.toml、pyproject.toml、go.mod、pom.xml 等)里的简介、关键词和依赖,以及仓库根目录的文件,并统计本机提交次数。
- 空状态说得更清楚:还没建索引就搜索时,应用会直接说明原因,并给出「立即建索引」按钮。
测试情况
表里标 "CI only" 的平台,只保证类型检查、无头测试和打包在该平台通过,还没有人实际打开过。Apple 芯片上用真实仓库手动跑过:下载默认模型、建索引、语义搜索。「在 Finder / 终端中打开」两个按钮有测试覆盖,但还没在任何真机上实际点过。
Intel Mac 版不带本地模型,因为 ONNX Runtime 没有提供它的预编译库。在 Intel Mac 上请改用本地服务或外部 API,设置页里会有提示。
从 v0.1.x 升级
- 扫描目录和 API 配置都会保留。
- 升级后需要重建一次索引:旧索引缺简介和主题,旧向量也没记录生成时用的文本,所以第一次重建会重新生成全部向量。
- v0.1.x 读不了 v0.2.0 写的向量。如果退回旧版,搜索会退回词法检索,用旧版重建一次索引才能恢复。
安装
macOS 解压后拖进「应用程序」,并执行一次 xattr -dr com.apple.quarantine /Applications/RepoFind.app;Linux 解压后运行目录里的 RepoFind(需要 glibc 2.39+、GTK 4.14+、WebKitGTK 6.0);Windows 解压后运行 RepoFind.exe(没有签名,SmartScreen 会提示,点「更多信息 → 仍要运行」)。
RepoFind v0.1.1
Same app as v0.1.0, now packaged for more platforms, with an app icon.
| Platform | File | Needs | Tested |
|---|---|---|---|
| macOS, Apple silicon | RepoFind-0.1.1-macos-arm64.zip |
macOS 14+ | CI, plus a local build of the same code launched by hand |
| macOS, Intel | RepoFind-0.1.1-macos-x86_64.zip |
macOS 14+ | CI only |
| Linux x86_64 | RepoFind-0.1.1-linux-x86_64.tar.gz |
glibc 2.39+, GTK 4.14+ (Ubuntu 24.04 or later) | CI only |
| Linux arm64 | RepoFind-0.1.1-linux-arm64.tar.gz |
glibc 2.39+, GTK 4.14+ | CI only |
| Windows x86_64 | RepoFind-0.1.1-windows-x86_64.zip |
Windows 10 1809+ | CI only |
"CI only" means the type check and headless tests pass on that platform and the package builds there — nobody has opened the app on it yet. That is why this is a pre-release. If you try one, an issue saying whether scanning works would be very welcome.
Each file has a .sha256 next to it.
Install
- macOS: unzip, move
RepoFind.appto Applications. The build is ad hoc signed and not notarized; clear the quarantine flag once:xattr -dr com.apple.quarantine /Applications/RepoFind.app - Linux:
tar xzf RepoFind-0.1.1-linux-x86_64.tar.gz, then run theRepoFindexecutable inside the extracted directory - Windows: unzip and run
RepoFind.exe. It is not code signed, so SmartScreen warns on first launch ("More info" → "Run anyway")
Then open Settings, set your scan roots and embedding endpoint, and press SCAN + INDEX.
Changes since v0.1.0
- App icon
- Builds for Intel Macs, Linux and Windows, produced by a release workflow
- Backslash paths are accepted in scan roots
和 v0.1.0 是同一个应用,新增了应用图标和更多平台的安装包(见上表)。
标注 "CI only" 的平台只保证类型检查、无头测试和打包在该平台通过,还没有人在上面实际打开过应用,所以这一版标为 pre-release。如果你试了,欢迎提 issue 说一下扫描是否正常。
安装:macOS 解压后拖进"应用程序",并执行一次 xattr -dr com.apple.quarantine /Applications/RepoFind.app;Linux 解压后运行目录里的 RepoFind(需要 glibc 2.39+、GTK 4.14+);Windows 解压后运行 RepoFind.exe(未签名,SmartScreen 会提示,点"更多信息 → 仍要运行")。
RepoFind v0.1.0
First release of RepoFind: search your local git repos in plain language, entirely on your machine apart from the embedding API you choose.
Highlights
- Hybrid ranking:
0.6 × semantic + 0.4 × lexical (TF-IDF), English / Chinese / mixed queries - Any OpenAI-compatible embeddings endpoint, configured in Settings; lexical-only mode needs no API key and makes no requests
- Reads branch, remote and last commit straight from
.git— no git process - Index and vectors persisted in the app data directory
- English and Chinese UI
Install (macOS, Apple silicon, macOS 14+)
-
Download
RepoFind-0.1.0-macos-arm64.zip, unzip, moveRepoFind.appto Applications. -
The build is ad hoc signed and not notarized, so macOS blocks the first launch. Clear the quarantine flag once:
xattr -dr com.apple.quarantine /Applications/RepoFind.app
-
Open Settings, set your scan roots and embedding endpoint, press SCAN + INDEX.
Intel Macs, Windows and Linux: run from source with the nsh CLI — see the README.
Known limits
- Scan roots must be inside your home directory
- Rescans are full, not incremental
- The API key is stored in plain text in the app's on-device storage
RepoFind 首个版本:用自然语言搜索本地 git 仓库。除了你自己配置的 embedding 接口,一切都在本机完成。
安装(macOS,Apple 芯片,macOS 14+):下载 RepoFind-0.1.0-macos-arm64.zip,解压后把 RepoFind.app 拖进"应用程序"。安装包没有公证,首次打开前执行一次 xattr -dr com.apple.quarantine /Applications/RepoFind.app。然后在 Settings 里填扫描目录和 embedding 接口,点 SCAN + INDEX。
已知限制:扫描目录必须在主目录之下;每次都是全量重扫;API Key 明文存在本机。
SHA-256: 067b479f17a9114cb089c0a81d458455f9938fc90069cdbe3c04457031226a12