Skip to content

cmake and full Xcode.app seem to be undocumented requirements for bun run dev #334

Description

@andrewholzbach

Problem Statement

CONTRIBUTING.md's Prerequisites section only lists Bun, Rust, and macOS. Following it on a clean machine (Command Line Tools installed, but not the full Xcode.app, and no cmake), bun run dev fails for either missing tool.

WIthout the full xcode app:
❯ bun run dev ... ensure-llama-server: Metal toolchain missing; downloading (one-time, ~700MB)... xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance ensure-llama-server: xcodebuild -downloadComponent MetalToolchain exited 1 error: script "engine:ensure" exited with code 1

WIthout cmake
❯ bun run dev ... ensure-llama-server: cmake failed to start: Executable not found in $PATH: "cmake" error: script "engine:ensure" exited with code 1

Only after installing both Xcode.app and cmake did bun run dev get past this step. Neither is mentioned in the Prerequisites section yet. Is this expected/known? If so, might be worth adding both to CONTRIBUTING.md's Prerequisites list for any new contributers.

Separately, unrelated but hit around the same time: on first bun run dev, the Accessibility/Screen Recording permission prompts didn't seem to apply to when I enabled them for the Thuki app. I had to grant permission to my terminal app instead(the one actually running the dev build). It might be a one-line tip near the existing Accessibility note in CONTRIBUTING.md, so people aren't confused why the dev build isn't changing when permissions are given.

Proposed Solution

Add cmake and xcode app to the prerequisites section and a note about the accessibility/screen recording prompts for contributers to CONTRIBUTING.md.

Alternatives Considered

No response

Additional Context

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions