Update Config

Update Config

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)

Runtime Preference Groups

theme: { presetId: "nord" },
dictation: { selectedDeviceId: "usb-mic" },
ai: {
  selectedAgentChatAgentId: "codex-agent_chat",
  selectedModelId: "gpt-5.4",
},
windowManagement: { snapMode: "expanded" },

MCP Servers

Use the top-level mcp key in config.ts for external MCP servers shared by scripts and Agent Chat.

mcp: {
  enabled: true,
  servers: {
    github: {
      transport: "stdio",
      command: "npx",
      args: ["-y", "@modelcontextprotocol/server-github"],
    },
  },
},

For MCP-specific workflows, use the mcp skill.

Common Mistakes

• Putting skills at the workspace root instead of in ~/.scriptkit/plugins/scriptkit/skills/
• Editing ~/.scriptkit/config.ts instead of ~/.scriptkit/config.ts
• Using command/control instead of meta/ctrl
• Editing theme.json when you meant to change theme.presetId in config.ts

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.