Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 28 additions & 3 deletions docs/ai/ai-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,30 @@ dot_cursor/modify_cli-config.json
`selectedModel` keys from the script to make the model machine-local.
- **Verify:** `chezmoi diff ~/.cursor/cli-config.json` is empty once applied;
the status line previews via `echo '<sample-json>' | ~/.cursor/statusline.sh`.
- **Hooks:** `~/.cursor/hooks.json` + `hooks/run-shellcheck.sh` are managed as
plain files (shellcheck `afterFileEdit` only). Machine-injected hooks (e.g.
Adrafinil) are not in the repo and will be replaced on apply until re-injected.
- **MCP:** `~/.cursor/mcp.json` is **not** managed — MCP endpoints are
machine/context-specific.

## Cursor IDE User Preferences

Portable Cursor IDE prefs live under macOS Application Support and are managed:

```
Library/Application Support/Cursor/User/settings.json → theme, composer, update track
Library/Application Support/Cursor/User/keybindings.json → cmd+i → composerMode.agent
```

Caches, History, globalStorage, and extension VSIX trees under that User folder
are not managed.

## Zed

- **Source:** `dot_config/zed/settings.json` → **target:** `~/.config/zed/settings.json`
(vim mode, fonts, theme, cursor agent_servers).
- **Cask:** `zed` (and `cursor`) are declared in `dot_Brewfile.tmpl` for non-headless
machines.

## Ownership Boundary

Expand All @@ -163,11 +187,12 @@ cannot delete ignored paths, one-time cleanup of stale `~/.agents/skills/*` is d

## What Is Not Managed

- **IDE settings** (themes, keybindings) live outside the home dotfiles
(e.g. macOS `~/Library/Application Support/Cursor/User/`) and are configured per machine.
- **Cursor MCP config** (`~/.cursor/mcp.json`) — machine/context-specific endpoints.
- **VS Code / other IDE Application Support** beyond the Cursor User
settings/keybindings above (and Zed under `~/.config/zed/`).
- **Per-tool settings** removed in the AI-native overhaul (Claude `settings.json`,
Codex `config.toml`/`rules`) are not restored here. The **Cursor CLI** status line
and portable prefs *are* now managed — see [Cursor CLI Configuration](#cursor-cli-configuration).
and portable prefs *are* managed — see [Cursor CLI Configuration](#cursor-cli-configuration).
- **Ephemeral/sensitive runtime state** under `~/.cursor`, `~/.claude`, `~/.codex`
(auth, caches, history, project state) is not in the repo — the Cursor
`modify_` script preserves it on the machine but never commits it.
Expand Down
2 changes: 2 additions & 0 deletions dot_Brewfile.tmpl
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,9 @@ brew "shellcheck"
{{- if not .headless }}
# 'brew install --cask'
cask "claude-code"
cask "cursor"
cask "visual-studio-code"
cask "zed"
cask "rectangle"
cask "font-fira-code-nerd-font"
cask "displaylink"
Expand Down
28 changes: 28 additions & 0 deletions dot_config/zed/private_settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
// Zed settings
//
// For information on how to configure Zed, see the Zed
// documentation: https://zed.dev/docs/configuring-zed
//
// To see all of Zed's default settings without changing your
// custom settings, run `zed: open default settings` from the
// command palette (cmd-shift-p / ctrl-shift-p)
{
"minimap": {
"show": "always"
},
"agent_servers": {
"cursor": {
"type": "registry"
}
},
"base_keymap": "VSCode",
"cli_default_open_behavior": "new_window",
"vim_mode": true,
"ui_font_size": 16,
"buffer_font_size": 15,
"theme": {
"mode": "system",
"light": "One Light",
"dark": "One Dark",
},
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
// Place your key bindings in this file to override the defaults
[
{
"key": "cmd+i",
"command": "composerMode.agent"
}
]
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"workbench.iconTheme": "Cursor Dark Icons",
"application.shellEnvironmentResolutionTimeout": 120,
"workbench.colorTheme": "Monokai Pro (Filter Octagon)",
"window.autoDetectColorScheme": false,
"cursor.composer.showEmptyStateTips": false,
"cursor.composer.conversationDensity": "detailed",
"cursor.general.reduceTransparency": true,
"cursor.composer.usageSummaryDisplay": "always",
"update.releaseTrack": "dev"
}