Configuration & Workspace Settings

Manage files under ~/.scriptkit that control launcher behavior, hotkeys, dictation, theming, and Tab AI.

Files That Matter

What Goes Where

Hotkey Format

Use KeyboardEvent.code values. Valid modifiers: meta, ctrl, alt, shift.

Common keys: Semicolon, Space, Enter, KeyK, KeyL, KeyD, Digit1.

Do not use command/control — use meta/ctrl.

UI Settings (config.ts)

editor: "code",
padding: { top: 8, left: 12, right: 12 },
editorFontSize: 16,
terminalFontSize: 14,
uiScale: 1.0,
builtIns: {
  clipboardHistory: true,
  appLauncher: true,
  windowSwitcher: true,
},

Command Overrides (config.ts)

commands: {
  "script/my-workflow": {
    shortcut: { modifiers: ["meta", "shift"], key: "KeyW" }
  },
  "builtin/app-launcher": { hidden: true },
  "builtin/empty-trash": { confirmationRequired: true }
}

Command deeplinks: scriptkit://commands/{id}

Auxiliary Hotkeys

• notesHotkey — no default; set explicitly
• aiHotkey — defaults to Cmd+Shift+Space when enabled
• logsHotkey — defaults to Cmd+Shift+L when enabled
• dictationHotkey — no default; set explicitly
• All have *Enabled boolean (default true)

Common Mistakes

• Putting skills/ under kit/ instead of at ~/.scriptkit/skills/
• Editing ~/.scriptkit/config.ts instead of ~/.scriptkit/kit/config.ts
• Using command/control instead of meta/ctrl
• Putting microphone selection in config.ts instead of settings.json

References

See references/config-examples.md for full config.ts example, theme file format, frecency settings, watcher config, layout defaults, and Claude Code provider options.