Configuration

Where the files live#

The app creates its configuration on first launch at:

~/Library/Application Support/com.expressionloss.CursorClaw/conf/

That folder contains:

conf/
  conf.toml
  commandSequences.toml
  mouseControlKeyLayout.toml
  shortcuts.toml
  inputModeNanoFlavorShortcuts.toml

Which file controls what#

File	What it stores
`conf.toml`	General behavior and mode preferences: layout, gestures, mouse, grid, and input behavior
`commandSequences.toml`	Command sequences for commands and trigger keys
`shortcuts.toml`	Keyboard shortcuts for app activation, commands, and triggers
`inputModeNanoFlavorShortcuts.toml`	Keyboard shortcuts for Input Mode Nano actions
`mouseControlKeyLayout.toml`	Mouse Control key bindings

Move the conf folder to sync it#

You can relocate the configuration directory, which is how you share one setup across machines:

Open Settings → General.
Find the configuration location section.
Click Select Config Directory.
Choose a new folder, for example one inside iCloud Drive.

With the folder in iCloud Drive, your configuration syncs across devices signed in to the same Apple ID. After any change, reload configurations from Settings or restart the app.

Per-app configuration#

App-specific configuration is an Unlocked feature, described in Plans and Licensing. It lets one app see different command sequences and shortcuts than the rest of the system, which is useful when an editor or terminal already claims the keys you want.

Create a folder named after the app's bundle identifier inside conf. This one applies while TextEdit is frontmost:

conf/
  commandSequences.toml
  shortcuts.toml
  inputModeNanoFlavorShortcuts.toml
  com.apple.TextEdit/
    commandSequences.toml
    shortcuts.toml
    inputModeNanoFlavorShortcuts.toml
    override.toml

Only those three files support per-app overrides. conf.toml and mouseControlKeyLayout.toml stay shared across every app.

Merge or replace#

By default each app-specific file merges with its shared counterpart. Add an override.toml to control that per file type:

commandSequences = "override"
shortcuts = "replace"
inputModeNanoFlavorShortcuts = "override"

override keeps the shared configuration and replaces only the entries present in the app-specific file.
replace ignores the shared file entirely for that configuration type.

To find an app's bundle identifier, select any of its elements in Element Menu Mode and choose Copy App Bundle Identifier.

Next#

Command Reference for identifiers to bind
Choosing a Usage Style
Guides index