Install
quarry ships as a signed macOS app, and builds from source with Bun and Cargo. There is no Windows or Linux build yet.
Requirements
| Thing | Why |
|---|---|
| macOS | the shell is Tauri 2, and alphas ship as universal builds |
| Xcode CLT | clang, clang-format and lldb-dap come from xcrun |
| Rust (rustup) | the backend compiles with Cargo, and rustfmt formats Rust |
| Bun | the frontend, scripts and tests |
| CMake and Ninja | optional, for C/C++ projects that use them |
Install the optional pair with Homebrew: brew install cmake ninja.
Run from source
git clone https://github.com/JeffreyJYZ/quarry.git
cd quarry
bun install
bun run tauri devbun run tauri dev builds the Rust side, starts Vite, and opens the app window. bun run dev alone
starts only the browser UI, which is useful for layout work but has no project access.
A release build is bun run tauri build; it produces quarry.app and a dmg under
src-tauri/target/release/bundle/.
Take a signed alpha
Every alpha is a universal macOS build with an updater manifest:
- releases: github.com/JeffreyJYZ/quarry/releases
- the app checks for a newer alpha at launch and offers Update now
Check what was found
quarry never bundles a toolchain. It looks on PATH first, then in /opt/homebrew/bin,
/usr/local/bin and ~/.cargo/bin, and asks xcrun for anything Apple ships. A GUI launch inherits
launchd's short PATH, which is why the extra directories and xcrun are probed at all.
Settings shows which tools were found and which are missing. A formatter that is absent is named
when it matters, rather than failing silently: formatting a TOML file without taplo says
no formatter for .toml: install taplo-cli.
Next
Open a project and let quarry detect what it is.