Skip to content

Releases

v0.4.0

Choose a tag to compare

@csanfilippo csanfilippo released this 06 Nov 00:13

Changed

  • Every spotlight_query and search result now carries truncated, which is false when paths holds every match. A client that tests whether the key exists, instead of its value, has to be updated.

v0.3.0

Choose a tag to compare

@csanfilippo csanfilippo released this 06 Nov 00:02

Added

  • spotlight_query and search results carry truncated: true when more matches exist than paths holds, so a client can raise limit or narrow the search. A result with every match has no truncated key.

v0.2.1

Choose a tag to compare

@csanfilippo csanfilippo released this 03 Nov 23:56

Fixed

  • As many concurrent tool calls as the Mac has CPUs, or more, no longer hang the server with no reply: Spotlight queries now run one at a time.

v0.2.0

Choose a tag to compare

@csanfilippo csanfilippo released this 02 Nov 23:47

Added

  • oxus --version prints oxus <version> on stdout and exits without starting a server, so a binary installed from the release zip can report its version.

Changed

  • oxus rejects any arguments other than a lone --version: it prints usage: oxus [--version] on stderr and exits with status 64, instead of ignoring them and starting the server. A client configuration that passes arguments to oxus must drop them.

v0.1.0

Choose a tag to compare

@csanfilippo csanfilippo released this 02 Nov 22:43

Added

  • spotlight_query tool: runs a raw Spotlight query and returns the paths of matching files, in Spotlight's order.
  • search tool: finds files by name_contains (ignoring case and diacritics), kind (image, movie, audio, pdf, folder, application) and folder (an absolute path, ~, or a path starting with ~/), or any combination of them, without Spotlight query syntax.
  • Both tools take an optional limit, default 25, capped at 100.
  • Both tools return {"paths": [...]} as structured content, described by an outputSchema, and as JSON in a single text block.
  • A search folder that does not exist, is a file, is a package, or cannot be read returns an error result naming the path and the fix, instead of an empty list.
  • A search folder denied by macOS privacy protection names the Privacy & Security setting to change, and one lacking read permission says so.
  • A search whose folder contains ~/Downloads, ~/Documents or ~/Desktop, a search without a folder, and every spotlight_query list in unreadableFolders those of the three folders macOS privacy protection denies, each with the setting to change, since Spotlight silently leaves out their files.