A native macOS launcher for applications, calculations, unit and currency conversions, emoji, notes, English → Japanese translation, and light/dark system theme switching.

Build and install

Requires macOS 14 or later and a Swift 6 toolchain (Xcode 16 or later).

make run     # Build and launch .build/Conjure.app.
make build   # Build without launching.
make install # Install to /Applications/Conjure.app.
make test    # Run the test suite.

For a user-only installation:

make install INSTALL_DIR="$HOME/Applications"

Quit the installed copy before reinstalling. Installation does not request administrator privileges. Builds are ad-hoc signed by default and are not notarized for distribution. Ad-hoc signing ties Accessibility permission to a build's code hash: rebuilding and reinstalling can invalidate an existing grant even while Conjure remains enabled in System Settings.

To preserve permission across rebuilds, use the same code-signing certificate and app location every time:

security find-identity -v -p codesigning
make install CODE_SIGN_IDENTITY="<certificate SHA-1 from the list>"

Pass the same CODE_SIGN_IDENTITY to make build and make run too. If no identity is available, create a local certificate in Keychain Access → Certificate Assistant → Create a Certificate…, choosing Self Signed Root and Code Signing, or use an Apple-issued development certificate. Keep that certificate and its private key; recreating it changes the signing identity. After switching from ad-hoc signing, re-add Conjure to Accessibility once.

To work on the project, open Package.swift in Xcode. Run the bundled app for its application identity and metadata; make run restarts the development bundle so rebuilt code takes effect.

Getting started

Open Conjure, type an application name, and press Return to launch it or bring its running instance forward. Search supports partial names and initials, such as gc for Google Chrome. Favorites and frequently used entries rank higher among equally good matches.

Favorited launcher entries show a small star before their Application or Command label.

Launcher results and the emoji grid start below the top fade; scrolling moves content naturally through it.

Conjure searches the system and user Applications folders. Hover over a result to see its path; duplicate names show their locations. Drag the launcher background to reposition it; its position is remembered.

Conjure runs without a Dock icon. Dismissing the launcher leaves it running; reopen it from Finder or use your configured global shortcut.

The launcher, emoji picker, notes, and translation tool open immediately without window animations or content fades, including from global shortcuts. Shortcut destinations are prepared before the window appears. Settings is constructed only when needed, not before the launcher appears.

Controls

Action	Control
Select a result	Up/Down or Control-K/Control-J
Open a result or copy a calculated answer	Return or double-click
Open actions for the selected entry	Command-K
Open one of the first nine results	Hold Command until numbers appear, then press 1–9
Close the open actions, provider, language, or note picker, otherwise dismiss the launcher	Escape
Dismiss the launcher, including the current Command and pickers	Command-W
Browse notes / open the translation provider picker	Command-P (in Notes / Translate)
Create a note	Command-N (in Notes, including while a popup is open)
Go back without dismissing	Back chevron
Open Settings	Command-comma
Quit	Command-Q

Right-click the launcher background for Settings and Quit. Actions include favorites, resetting usage ranking, revealing applications in Finder, quitting them, and uninstalling them.

Action and selection popups paint a popup-sized background using the launcher window’s gradient coordinates, keeping the glows continuous without showing the results underneath. Each opening rebuilds the complete native view and layer tree, rather than resizing a retained presentation between the footer and header. Callbacks and selection behavior stay in the controller. Layout finishes before the opening fade, including when switching popup types.

The launcher, emoji picker, Notes, and Translate share ActionPill for footer styling, alignment, spacing, and keyboard indicators: primary action first, then Actions with separate Command and K keycaps. Notes uses Browse Notes with Command-P for its primary action so Return remains available for editing; the other tools use Return. Controllers supply the buttons and retain their targets, enabled state, and popup behavior.

The header’s trailing edge is constrained to the footer’s trailing edge. The translation provider pill and footer pill therefore share the same 8-point right inset and 36-point height.

In Settings, choose a Global shortcut destination: Applications, Conjure Emoji, Conjure Notes, Conjure Translate, or Toggle System Theme. Choose Record Shortcut… and press a combination containing Command, Option, or Control. For example, select Conjure Emoji and record Command-Shift-Space to open the emoji picker directly. Clear disables only the selected destination's shortcut. No shortcuts are assigned by default; existing launcher bindings are preserved.

The Applications shortcut always targets the application launcher, not the last-used tool. View commands open their selected tool directly. Action-only shortcuts, such as Toggle System Theme, execute in the background without opening the launcher, taking focus, clearing a search, or closing an existing tool. Pressing a tool shortcut while its destination is already frontmost dismisses Conjure; switching view destinations opens a fresh view. Active confirmations and uninstall operations are not interrupted. All global shortcuts pause while recording and resume afterward. Conjure rejects shortcuts already assigned to another destination or used by its own menus and navigation.

Cancelling recording, changing destination, or leaving the recorder restores saved shortcuts. If a replacement cannot be registered, the previous saved binding is retained; any failure to restore a shortcut is reported in Settings.

For Command-Space, select Applications and choose Use ⌘Space. If it conflicts with Spotlight, Input Sources, or another app, change that binding in System Settings first. Conjure never changes macOS shortcuts for you. Shortcuts work while Conjure is running; they do not start a quit app or require Accessibility permission.

Conjure lets macOS decide whether a global shortcut can be registered, rather than rejecting it solely because it appears in the system shortcut table. A registered shortcut can still compete with system behavior; if it does, change the conflicting system shortcut or choose another binding.

Install Conjure in /Applications, then enable Launch at login in Settings to start it in the background. If macOS requires approval, use Open Login Items Settings… to grant it.

Calculator and conversions

Type an expression into search and press Return to copy the answer. Arithmetic and unit conversions work offline.

(12 + 8) * 3
sqrt(144)
20% off 80
10ft in m
32 f to c
1 GiB to MiB
100 USD to DKK
0.5 BTC to ETH

Arithmetic supports powers (^), percentages, remainder (% or mod), scientific notation, pi/π, e, and the functions sqrt, abs, round, floor, ceil, sin, cos, tan, log, and ln. Trigonometric arguments are radians; log is base ten.

Convert length, mass, temperature, volume, duration, speed, area, and data with <amount> <unit> to <unit>; in and as also work. Data units distinguish bits (b) from bytes (B), and decimal (KB) from binary (KiB). Culinary volumes use US customary measures.

Currency and crypto conversions require internet access and use currency-api. These are daily rates, not live market prices; the snapshot date is shown with the answer. Treat them as estimates, not trading or payment quotes. Fetch failures show an error rather than silently using old rates; change the query to retry.

Rates are shared across queries and refreshed on the next currency query after the local day changes. While refreshing, a cached answer remains copyable and is labeled stale. Leaving the query or dismissing the launcher does not cancel that shared refresh.

ConjureKit.CurrencyCalculation owns this lifetime policy; the launcher renders its result. Its checks use an injected clock and scripted rate fetches.

Emoji picker

Search for Conjure Emoji, identified by its centered 🤔 icon, and open it. Browse the grid or search by name, keyword, :shortcode:, or emoji. Use the category menu to filter results or show Recently Used. Your last 30 selections are saved locally. Favorites appear first, followed by recent selections when browsing All Emoji.

Square 64-point emoji tiles use compact 1-point grid spacing and show the same subtle rounded border used elsewhere in Conjure only when selected or hovered; the selected tile retains its accent fill.

Use the arrow keys or Control-H/J/K/L to navigate left/down/up/right; the grid scrolls to keep the selected emoji visible. Return, clicking an emoji, or Copy and Paste copies it, dismisses Conjure, and tries to paste into the app that was focused when the launcher opened. Automatic pasting requires System Settings → Privacy & Security → Accessibility → Conjure; macOS prompts if permission is missing. After granting it, select an emoji again. If permission is denied, the previous app is unavailable, or focus cannot be restored promptly, the emoji stays copied for manual Command-V. The Back chevron returns to the launcher and restores your search.

If macOS keeps prompting despite an enabled Accessibility entry, quit Conjure, remove its stale entry with the minus button, add the exact app you launch (normally /Applications/Conjure.app), enable it, then reopen Conjure and retry. Avoid switching between installed and .build copies. For permission that survives rebuilds, configure certificate signing as described above. Copy Emoji followed by manual Command-V works without this permission.

Open Actions with Command-K for Copy and Paste (default), Copy Emoji (copy only, no Accessibility permission needed), Favorite, or Remove Favorite. Favorites are saved locally and grouped ahead of other emoji, with a small extra spacing break when browsing without a search. There are no star badges.

With Actions open, Escape or the Back chevron closes Actions first. Another Escape dismisses the launcher; another Back returns to Applications and restores your search. Command-W always dismisses the entire launcher, including the current Command and its Actions. Switching destinations also removes the previous Command's Actions completely. Copy and Copy and Paste dismiss the launcher without an intermediate Back step.

The picker works offline with 1,870 emoji from gemoji v4.1.0. Its MIT license is included in the application.

System theme

Search for Toggle System Theme, identified by its centered 🌗 icon (try theme or system), and press Return to switch macOS from light to dark appearance or back. Selecting it in the launcher dismisses Conjure on success. Its global shortcut runs in the background without presenting a window or changing the current launcher view. You can favorite it or assign a shortcut in Settings; existing theme keybindings and favorites survive the rename.

The first use may ask permission to control System Events. Allow it under System Settings → Privacy & Security → Automation → Conjure. If permission is denied or macOS reports an error, Conjure shows the failure in the visible launcher or a standalone alert when the launcher is hidden. Conjure's own launcher keeps its existing dark styling.

Commands explicitly declare Application.Command.presentsView. The shared dispatcher routes action-only commands before any launcher presentation; new commands must choose their behavior in the exhaustive metadata switch. Command IDs remain independent of display names so renaming does not reset saved shortcuts, favorites, or usage.

Notes

Search for Conjure Notes, identified by its centered 📔 icon, or assign it a global shortcut in Settings. The title uses full-contrast text. The footer action pill offers Browse Notes (Command-P) and Actions (Command-K). Browse Notes opens Conjure’s styled, scrollable searchable picker, shared with translation language selection—not a native menu. Fuzzy-search note titles, then select with Up/Down, Control-J/K, and Return or by clicking a note. A checkmark marks the current note, which is selected and scrolled into view on opening. Reopening Notes restores the last selection. Each note’s first nonempty line becomes its picker title; duplicate titles remain independently selectable.

Actions opens the same searchable popup style used throughout Conjure, with Browse Notes (Command-P) and New Note (Command-N). Command-N creates a note while the editor or either popup is focused. Command-P toggles Browse Notes even while its footer pill is covered. Escape, Back, or clicking outside closes an open popup and returns focus to the editor without leaving Notes; another Escape dismisses the launcher. Control-J/K navigates only while a popup is open, preserving normal editor commands when it is closed.

Edit Markdown directly: headings, bold, italic, lists, links, inline code, and fenced code blocks are highlighted while the source remains visible, except for list markers rendered as inline tokens. Bullet (-, *, +), numbered (1., 1)), and native checkbox markers share a marker column, so item text aligns at the same nesting depth even with long numbers; wrapped lines align with the item text, not the marker. Paste images or drag image files into the editor to embed them locally; no file-picker button is needed. Return continues lists at the same indentation, incrementing numbers and resetting task checkboxes. On an empty item, Return exits one nesting level; repeat to leave the list entirely. Nesting has no fixed depth limit. Prose and fenced code retain ordinary newlines. Command-Z undoes edits; Command-Shift-Z redoes them. Undo history is cleared when switching notes so edits cannot spill into another note.

Checkbox conversion waits for a space or tab after the closing bracket: type - [ ] , - [] , or - [x] . A closing bracket alone remains literal, so typing directly after it does not briefly create and then remove a checkbox. Both [] and [ ] mean unchecked; toggling a compact [] task on produces [x], and toggling it off produces [ ].

List markers are atomic inline tokens, including nested bullets and numbers; task markers such as - [ ] and - [x] use native checkboxes. Indentation and following whitespace remain editable source text without changing the aligned body column; selecting a token selects the whole marker, with no hidden source characters. Click a checkbox to toggle completion without moving the selection. Backspace immediately after a token expands its original marker and deletes its final character; forward Delete immediately before it expands the marker and deletes its first character. Each edit is one Undo step. Removing an item's preceding newline after prose makes its marker literal inline text; joining onto an empty or indentation-only line keeps a valid list token. Saved notes and copied text retain the original Markdown spelling, numbers, case, and spacing, alongside embedded images; alignment formatting is display-only. Thematic breaks and list syntax inside fenced code or ordinary prose stay literal.

Unordered markers display as •; numbered markers display their original number and delimiter, right-aligned before the item text. The stored and copied Markdown retains the original bullet spelling.

Fenced code uses HighlighterSwift (Highlight.js) for language-aware token colors. Add a language after the opening backticks or tildes, for example py, python, swift, js, or json. Unlabeled fences use automatic detection; unknown languages remain plain monospace. Highlighting runs entirely offline.

Notes autosave locally as RTFD packages, including embedded images, under ~/Library/Application Support/Conjure/Notes. No account, network access, or cloud sync is involved. Save failures appear below the editor and prevent switching, closing, or quitting until saving succeeds, preserving the unsaved buffer. The Back chevron restores the launcher search when no popup is open. Command-W dismisses Conjure, including any open popup; leaving Notes or switching destinations removes its popup completely.

Translation

Search for Conjure Translate, identified by its centered 🌏 icon, and open it. With empty or whitespace-only source text, Return or Swap languages reverses the source and target without submitting a request. MyMemory translates the text in one step: press Return or click Translate to submit. Typing alone never sends text.

With OpenAI · gpt-6-luna, enter the text first, then press Return or Add context. The original text stays visible while the search bar becomes a second input for the situation: where you encountered it, who said it to whom, or the intended tone. Press Return or Translate to send both inputs. Context is optional; Return with blank context translates without it, rather than swapping languages. OpenAI returns the translation first, followed by a one- or two-sentence explanation in the target language. Context helps resolve meaning, tone, and register; if the text conflicts with the situation, the explanation flags the mismatch instead of silently changing the meaning. Nothing is sent when advancing to the context step.

The translation uses 20-point primary text; OpenAI's explanation below the blank line uses 14-point dimmed secondary text. The original-text preview, translation, and explanation share a left edge.

When the translation is available, the action changes to Copy: press Return or click it to copy the full output (including OpenAI's explanation) and close Conjure. Command-C still copies selected output. Editing the current input clears the result; editing context keeps the original text. The action is disabled while translating.

The footer places the current primary action and its Return keycap before Actions, whose Command and K keys use separate keycaps, matching the launcher.

Press Command-P or click the provider selector to expand a searchable action-style popup from its top edge downwards, hiding the indicator until the popup closes. A checkmark marks the current provider. Use Up/Down and Return or click a provider to select it; Escape, Back, or clicking outside closes the popup. Changing providers clears the previous result without submitting a request. Switching away from OpenAI during the context step restores the original source text; context is not sent to MyMemory.

The footer shows the current language pair (initially English → Japanese). Click it or open Actions with Command-K to change the source language, change the target language, or swap them. Source and target selection use Conjure's themed popup, not a native menu. Fuzzy-search language names (for example, jpns matches Japanese), scroll the full list, and select with Up/Down, Control-J/K, and Return or by clicking a language. A checkmark marks the current language; it is selected and scrolled into view when the picker opens. Escape, Back, Command-K, or clicking outside cancels the picker without changing languages or leaving Translate. Language choices are saved locally and apply to both providers. Changing languages clears the previous result without submitting another request. The input hint and output accessibility label follow the selected pair. Escape closes an open picker first and dismisses the window only when no picker is open. Back closes the picker first, then returns from the context step to editing the original text (discarding context), then returns to the launcher and restores your search. Command-W always dismisses the entire window.

The language picker resizes to complete rows as results are filtered, showing up to six rows before scrolling.

Editing the input, changing languages or providers, saving or forgetting the key in Settings, or leaving Translate cancels the active request; cancelled results are not shown. After a request fails, submit again to retry.

MyMemory: No account or key required. Limits are 500 UTF-8 bytes per request and 5,000 characters per day for anonymous use.
OpenAI: Requires an API key, access to gpt-6-luna, and sufficient API billing. Manage the key in Settings > Conjure Translate: Save Key stores it in macOS Keychain; Forget Key removes it. Translate never saves a key implicitly. Requests disable API response storage, but OpenAI's retention policies still apply.

Translation sends your text—and, with OpenAI, any supplied context—to the selected third-party provider. Avoid sensitive content in either input. There is no automatic fallback between providers. MyMemory never receives your OpenAI key.

Uninstalling applications

Select an application, open Actions → Uninstall application, and review the discovered files. Return toggles the highlighted file's inclusion; Command-Return opens confirmation. Back cancels review and returns to the launcher; Escape dismisses the entire launcher. Closing remains disabled while an uninstall is running, and confirmation sheets retain their own cancellation behavior.

Discovery looks for the application and associated files identified by its bundle IDs. Shared app-group data starts unchecked because other applications may use it. Review selections carefully: discovery is conservative, not a guarantee that every associated file is found. Protected applications and unsafe or inaccessible files cannot be removed. Running applications are asked to quit normally; Conjure does not force-quit them or request administrator privileges.

Selected files move to Trash, never permanent deletion. Finder's Put Back is unavailable for these moves; restore files manually using the original-path mappings retained under ~/Library/Application Support/Conjure/UninstallTransactions/Completed.

Interrupted uninstalls are recovered on startup. If recovery needs attention, Settings offers Retry uninstall recovery… and details of retained files. Keep the reported journal and quarantine paths until recovery is resolved. Recovery can require manual intervention if files are inaccessible, volumes are disconnected, or original paths have been recreated; unresolved recovery blocks new uninstalls.

README.md Unescape Escape

Conjure