Browse the handbook

Settings

What each tab of Cleat's settings holds, from appearance and launch at login through search sources, hotkeys and commands, and where every setting is written on disk.

Cleat referenceUpdated

Press ⌘ , in the palette, or type settings.

The window has a sidebar in three groups. Palette holds General, Appearance, Search and Hotkeys; Features holds Features, Assistant, Clipboard, Snippets and Extras; Manage holds Permissions, Commands, Usage and Data & Backups. Every page has a one-line description under its title and, on the right, the one figure worth knowing before you open it: items and size for the clipboard, permissions granted, the model in use, the palette hotkey. The search field at the top filters every control by name, and the footer shows which build you have with a Check for Updates link. On a Force Touch trackpad, switches tap and sliders tick as you drag.

General

Appearance (system, light, dark), launch at login, the four permissions Cleat can use (Accessibility, Calendar, Reminders, Contacts) with a dot each and a button to grant or open the pane, snippet expansion on or off, which assistant answers questions (Apple Intelligence, the built-in model with its download button, or a local server), the default translation language, and the clipboard history count with a button to clear it and a cap on how much is kept.

Which sources the root palette looks at, whether it learns from what you open, how many results come back, the two editable lists behind hidden apps and ignored folders, and the file search threshold. All of it in Search settings.

Hotkeys

Every global key, every window position, the snippets, menu search and dictation keys, and the hotkeys and aliases you attached to rows through ⌘ K.

Extras

The dashboard cards, window gaps and snap cycling, Caps Lock as Hyper, typing sounds, the camera preview, screen time and breaks, the menu bar agenda, privacy mode, and the list of apps you have hidden from results. Each one is explained in Window gaps, Hyper key and typing sounds.

Commands

The commands folder path, the list of commands Cleat found there with their keywords, and buttons to open the folder and reload.

Usage

Settings › Usage is everything Cleat has recorded about how it is used, all of it local. Actions per day with a chart over 7, 30 or 90 days, palette opens, the rows you open most, and the learned queries: what you typed, what it opened and how often, each with a Forget button. Below that, how big each store has grown: clipboard entries against the limit, snippets, quicklinks, commands and today’s screen time, with buttons into Screen Time and the clipboard history. The same page holds Learn from what you open and Forget Usage History, so the switch and the numbers it feeds sit together. Type stats or usage to open it.

Appearance

Light or dark at the top of the page applies to every Cleat window: the palette, settings, What’s New, the tour and the ringing panel. The Midnight and Terminal looks switch to dark and Paper to light; the theme list marks Midnight and Graphite as dark themes and Sand as a light one.

The preview at the top of Settings › Appearance is the palette drawn with your choices, so you see the result before opening it. Looks are five presets: Classic, Midnight, Paper, Terminal and Candy. Under Colour, eleven themes wash the surface, a tint strength slider sets how much, and the accent has twelve choices plus Custom with a colour picker or a hex value. Under Shape and type: Liquid Glass, frosted or solid surface; sharp, rounded or pill corners; the selected row as a fill, an accent bar, an outline or an accent fill; system, rounded, serif or monospaced type; and switches for the ⌘1–⌘9 keycaps and the footer.

Finding a setting

The field at the top of the sidebar filters every labelled control by name: type login, night, tip or selected and the matches list with the page each lives on; click one to open that page. Clear the field to get the section list back.

Updates

Settings › General › Updates has Install updates automatically. Cleat checks once a day either way; on, a new release downloads in the background and installs when Cleat next relaunches, off, it asks first. Off is the default.

Storage

Settings › Usage › Storage shows what the clipboard images, the database and any downloaded model weigh, with Show in Finder for the folder and Manage Model to reach the Assistant page where a download is removed.

Language

Settings › General › Language picks German, Spanish, French or Macedonian, or follows the system. As of 1.0.13 every settings page, the onboarding and every status line in the palette are translated; answers, file names and app names stay as they are.

Files behind the settings

What Where
Commands ~/.config/cleat/commands/
Snippets ~/.config/cleat/snippets.md
Quicklinks ~/.config/cleat/quicklinks.json
Clipboard, usage counts, aliases, hotkeys ~/Library/Application Support/Cleat/cleat.sqlite
Clipboard images ~/Library/Application Support/Cleat/images/
Preferences ~/Library/Preferences/com.gjorge.cleat.plist

Deleting the app and those folders removes every trace.

Housekeeping from the palette

Four rows exist so the settings window is rarely needed: Cleat Settings, Check for Updates, Grant Accessibility Access and Quit Cleat. Type any of them, or settings for the first.

Help from the menu bar

The menu bar icon has User Guide, What’s New…, Report an Issue… (a SnagFrog report form with the version, macOS and Mac model filled in) and a Recent submenu of the last five things you ran. Copy Diagnostics in the palette copies the same details with the last lines of the log, for a bug report.

Size and position

Settings › Appearance sets the text and row size (compact, regular, large), the width, and how far down the screen the palette opens. ⌃N, ⌃P, ⌃J and ⌃K move the selection like the arrow keys.

Configuration in iCloud Drive

Settings › Data & Backups can keep snippets, quicklinks, commands, layouts and the inbox in iCloud Drive › Cleat › config, with a link left at ~/.config/cleat, so another Mac with the same switch uses the same files. Clipboard history and usage stay on each Mac. Turning it off copies everything back.

Features

Settings › Features switches whole areas off: Assistant, Translation, Timers, Tasks, Screen time, Now playing, Developer tools, Window switcher, Calendar and Contacts, Notes, Browser tabs, Recent files and shell, File shelf, Camera, Dictation, Places, 1Password, Snippets, Emoji. Off means no rows, no keyword and no card. The same page lists rows you hid with ⌘K › Hide from Results, which now works on built-in commands and scripts as well as apps, with a Show Again button.

Display and login

Settings › Appearance chooses where the palette opens: the display under the pointer, the display with the active window, or the main display. The welcome tour’s first step now has Open Cleat at login; it is also in Settings › General.

Settings from the palette

Every settings page is a row: type settings to see them all, or settings features, settings hotkeys, settings keywords to open one.

Settings › General › Menu bar can hide the icon for a hotkey-only Cleat. Settings stay reachable through the Cleat Settings command, cleat://settings, or opening Cleat again from Applications.