# Update Config

> Update Script Kit configuration files — hotkeys, theme, layout, dictation, Claude Code, and workspace settings.

- Skill: `johnlindquist/update-config` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add johnlindquist/update-config`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnlindquist/update-config/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnlindquist (https://skillmd.com/u/johnlindquist)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/johnlindquist/update-config

---


# Update Config

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

## Files That Matter

| File | Purpose | Reload |
|------|---------|--------|
| `~/.scriptkit/plugins/scriptkit/skills/` | Agent-readable skills | Read from Script Kit plugin |
| `~/.scriptkit/config.ts` | Full config: hotkeys, built-ins, runtime preferences, Claude Code | Auto-reloads |
| `~/.scriptkit/theme.json` | Theme colors | Auto-reloads |

## What Goes Where

| Setting | File | Key |
|---------|------|-----|
| Launcher hotkey | `config.ts` | `hotkey` |
| AI/Logs/Dictation shortcuts | `config.ts` | `aiHotkey`, `logsHotkey`, `dictationHotkey` |
| Dictation microphone | `config.ts` | `dictation.selectedDeviceId` |
| Theme preset | `config.ts` | `theme.presetId` |
| Agent Chat defaults | `config.ts` | `ai.selectedAgentChatAgentId`, `ai.selectedModelId` |
| Snap mode | `config.ts` | `windowManagement.snapMode` |
| External MCP servers | `config.ts` | `mcp` |
| Theme colors | `theme.json` | `colors.*` |
| Claude Code | `config.ts` | `claudeCode` |

## 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)

```typescript
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)

```typescript
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

```typescript
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.

```typescript
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.