[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81788":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":10,"pushedAt":10,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":13,"lastSyncTime":27,"discoverSource":28},81788,"fff-gpui","th0jensen\u002Ffff-gpui","th0jensen","UI harness for fff made in GPUI. System-wide file finder that integrates well with the Zed editor.","",null,"Rust",61,2,1,0,3,17,9,54.63,false,"master",true,[],"2026-06-12 04:01:35","# fff-gpui\n\nA fast, keyboard-driven file finder for macOS built on [GPUI](https:\u002F\u002Fgithub.com\u002Fzed-industries\u002Fzed\u002Ftree\u002Fmain\u002Fcrates\u002Fgpui) — the same UI framework that powers [Zed](https:\u002F\u002Fzed.dev). It runs as a system-wide overlay you can summon instantly with a keybind, and integrates seamlessly into Zed as a custom task.\n\nUnder the hood it uses [fff](https:\u002F\u002Fcrates.io\u002Fcrates\u002Ffff-search) for fuzzy file search and grep, with frecency-based ranking so the files you actually use rise to the top.\n\n\u003Cimg width=\"1072\" height=\"633\" alt=\"Screenshot 2026-05-05 at 4 49 11 PM\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdec3811f-2de0-4bd3-b90b-812d9c36d124\" \u002F>\n\n## Features\n\n- Fuzzy file search and grep across your project\n- Frecency ranking — frequently and recently opened files are prioritised\n- Syntax-highlighted file preview\n- Global keybind support for system-wide access\n- Deep Zed integration via custom tasks — works across all projects\n\n\u003Cdetails>\n\u003Csummary>\n\u003Ch2>Installation\u003C\u002Fh2>\n\u003C\u002Fsummary>\n\n### Homebrew (recommended)\n\nApple Silicon and Intel supported\n```sh\nbrew tap th0jensen\u002Ffff-gpui\nbrew install fff-gpui\nbrew services start fff-gpui\n```\n\n### Build from source\n\n**Requirements:**\n- macOS (Apple Silicon and Intel)\n- Latest stable Rust via [rustup](https:\u002F\u002Frustup.rs)\n- Xcode Command Line Tools (`xcode-select --install`)\n- CMake ([required by wasmtime](https:\u002F\u002Fdocs.rs\u002Fwasmtime-c-api-impl\u002Flatest\u002Fwasmtime_c_api\u002F))\n- Zig 0.16.0 ([required by zlob](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fzlob))\n\nTo compile without Zig, disable zlob in `Cargo.toml`. This will lead to slightly slower performance, but it's not required for the app to work.\n\n```toml\n+ fff-search = \"0.6\"\n+ fff-query-parser = \"0.6\"\n- fff-search = { version = \"0.6\", features = [\"zlob\"] }\n- fff-query-parser = { version = \"0.6\", features = [\"zlob\"] }\n```\n\n```sh\ngit clone https:\u002F\u002Fgithub.com\u002Fth0jensen\u002Ffff-gpui\ncd fff-gpui\ncargo build --release\n```\n\nThe binary will be at `target\u002Frelease\u002Ffff-gpui`. You can move it anywhere on your `$PATH` or reference it directly in your config.\n\nHaving trouble building? Check Zed's [macOS troubleshooting guide](https:\u002F\u002Fzed.dev\u002Fdocs\u002Fdevelopment\u002Fmacos#troubleshooting) — the build requirements are the same.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\n\u003Ch2>Configuration\u003C\u002Fh2>\n\u003C\u002Fsummary>\n\nSet options in `~\u002F.config\u002Ffff-gpui\u002Fconfig.toml`:\n\n```toml\neditor = \"\u002Fusr\u002Flocal\u002Fbin\u002Fzed\" # run `which $EDITOR` in your shell to find this path\nsync_zed_settings = true\nglobal_keybind = \"hyper+f\"\nbase_dir = \"~\u002FDeveloper\" # sets the default base_dir when launching from global keybind\nexclude_dirs = [\n    \"Library\",\n    \"node_modules\"\n]\nwindow_width = 960.0\nwindow_height = 520.0\npicker_pane_width = 430.0\n\n[font]\nui_family = \".SystemUIFont\"\nbuffer_family = \"UbuntuMono Nerd Font\"\nui_size = 16.0\nbuffer_size = 15.0\n\n[theme]\nname = \"One Dark\"\n```\n\n`editor` is a fallback for the resident Homebrew service, which does not inherit your shell environment. If `EDITOR` or `VISUAL` is present in the current process, those still win, so custom tasks and other integrations can keep overriding it naturally.\n\nWhen `sync_zed_settings` is enabled, fff-gpui reads Zed's `settings.json` and mirrors the UI font, buffer font, font sizes, light\u002Fdark theme selection, and theme colors — from the bundled Zed themes plus any installed or local Zed theme.\n\nExplicit config values still win, so you can keep Zed sync enabled and override just the theme, fonts, sizes, or specific colors when needed. In practice, `[theme].name` overrides Zed's chosen theme, and `[font]` overrides the synced font families and sizes.\n\nFor `global_keybind`, `hyper` is accepted as a shorthand for `shift+control+alt+super`.\n\n`exclude_dirs` takes an array of directory paths. Relative entries are resolved from the current base path, so `[\"Library\"]` excludes that directory anywhere under the opened scope. We do not currently support wildcard globbing here. In practice, plain directory names are enough for the system-wide picker use case this option targets, and they keep the config predictable.\n\nZed themes are discovered from the bundled theme set, your local Zed installation, and extension themes under `~\u002FLibrary\u002FApplication Support\u002FZed\u002Fextensions\u002Finstalled\u002F`.\n\n### Themes\n\nfff-gpui comes bundled with the same themes as Zed. These are the valid options:\n\n|       | Ayu        | Gruvbox            | One      |\n|-------|------------|--------------------|----------|\n| Dark  | Ayu Dark, Ayu Mirage | Gruvbox Dark, Gruvbox Dark Hard, Gruvbox Dark Soft | One Dark |\n| Light | Ayu Light  | Gruvbox Light, Gruvbox Light Hard, Gruvbox Light Soft | One Light |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\n\u003Ch2>Running\u003C\u002Fh2>\n\u003C\u002Fsummary>\n\nLaunch fff-gpui once to start it as a background service with your global keybind:\n\n```sh\nfff-gpui\n```\n\nIf installed via Homebrew, `brew services start fff-gpui` handles this and re-launches it at login automatically.\n\n\nLaunch fff-gpui with the `--open \u003Cpath>` flag if you don't want the daemon running:\n\n```sh\nfff-gpui --open \u003Cpath>\n```\n\nThe daemon has a memory footprint of ~150mb idle and ~400mb when actively searching. Most of the reported usage in tools like btop is macOS page reservation and will be reclaimed under memory pressure. Report issues if you experience sustained growth beyond these baselines.\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\n\u003Ch2>Zed integration\u003C\u002Fh2>\n\u003C\u002Fsummary>\n\nThis is the recommended way to use fff-gpui within a project. Add the following to your Zed config files and replace `\u002Fpath\u002Fto\u002Ffff-gpui` with the actual path to your binary.\n\n**`~\u002F.config\u002Fzed\u002Ftasks.json`**\n```json\n[\n  {\n    \"label\": \"fff-gpui: Files\",\n    \"command\": \"\u002Fpath\u002Fto\u002Ffff-gpui --open .\",\n    \"env\": { \"EDITOR\": \"zed\" },\n    \"use_new_terminal\": false,\n    \"allow_concurrent_runs\": false,\n    \"reveal\": \"never\",\n    \"reveal_target\": \"dock\",\n    \"hide\": \"always\",\n    \"shell\": \"system\",\n    \"show_summary\": false,\n    \"show_command\": false,\n    \"save\": \"none\"\n  },\n  {\n    \"label\": \"fff-gpui: Grep\",\n    \"command\": \"\u002Fpath\u002Fto\u002Ffff-gpui --open . --grep\",\n    \"env\": { \"EDITOR\": \"zed\" },\n    \"use_new_terminal\": false,\n    \"allow_concurrent_runs\": false,\n    \"reveal\": \"never\",\n    \"reveal_target\": \"dock\",\n    \"hide\": \"always\",\n    \"shell\": \"system\",\n    \"show_summary\": false,\n    \"show_command\": false,\n    \"save\": \"none\"\n  }\n]\n```\n\n**`~\u002F.config\u002Fzed\u002Fkeymap.json`**\n```json\n{\n  \"context\": \"Workspace\",\n  \"bindings\": {\n    \"cmd-k cmd-p\": [\"task::Spawn\", { \"task_name\": \"fff-gpui: Files\" }],\n    \"cmd-k cmd-f\": [\"task::Spawn\", { \"task_name\": \"fff-gpui: Grep\" }]\n  }\n}\n```\n\n\nThis opens fff-gpui scoped to the current project root. `cmd-k cmd-p` launches in file-search mode, `cmd-k cmd-f` launches directly in grep mode. Selected files open in Zed; with grep, the editor jumps to the matched line.\n\u003C\u002Fdetails>\n\n## License\n\nMIT\n","fff-gpui 是一个基于 GPUI 框架构建的快速键盘驱动文件查找工具，专为 macOS 设计。它使用 fff 进行模糊文件搜索和 grep，并通过频率和最近访问时间对结果进行排序，确保常用文件优先显示。此外，该工具支持语法高亮预览、全局快捷键绑定以及与 Zed 编辑器的深度集成。适用于需要高效文件管理和快速访问代码库的开发者，尤其是在多项目环境中工作时更为实用。","2026-06-11 04:06:43","CREATED_QUERY"]