1{
2 // The name of the Zed theme to use for the UI.
3 //
4 // `mode` is one of:
5 // - "system": Use the theme that corresponds to the system's appearance
6 // - "light": Use the theme indicated by the "light" field
7 // - "dark": Use the theme indicated by the "dark" field
8 "theme": {
9 "mode": "system",
10 "light": "One Light",
11 "dark": "One Dark"
12 },
13 "icon_theme": "Zed (Default)",
14 // The name of a base set of key bindings to use.
15 // This setting can take six values, each named after another
16 // text editor:
17 //
18 // 1. "VSCode"
19 // 2. "Atom"
20 // 3. "JetBrains"
21 // 4. "None"
22 // 5. "SublimeText"
23 // 6. "TextMate"
24 "base_keymap": "VSCode",
25 // Features that can be globally enabled or disabled
26 "features": {
27 // Which edit prediction provider to use.
28 "edit_prediction_provider": "zed"
29 },
30 // The name of a font to use for rendering text in the editor
31 "buffer_font_family": "Zed Plex Mono",
32 // Set the buffer text's font fallbacks, this will be merged with
33 // the platform's default fallbacks.
34 "buffer_font_fallbacks": null,
35 // The OpenType features to enable for text in the editor.
36 "buffer_font_features": {
37 // Disable ligatures:
38 // "calt": false
39 },
40 // The default font size for text in the editor
41 "buffer_font_size": 15,
42 // The weight of the editor font in standard CSS units from 100 to 900.
43 "buffer_font_weight": 400,
44 // Set the buffer's line height.
45 // May take 3 values:
46 // 1. Use a line height that's comfortable for reading (1.618)
47 // "buffer_line_height": "comfortable"
48 // 2. Use a standard line height, (1.3)
49 // "buffer_line_height": "standard",
50 // 3. Use a custom line height
51 // "buffer_line_height": {
52 // "custom": 2
53 // },
54 "buffer_line_height": "comfortable",
55 // The name of a font to use for rendering text in the UI
56 // You can set this to ".SystemUIFont" to use the system font
57 "ui_font_family": "Zed Plex Sans",
58 // Set the UI's font fallbacks, this will be merged with the platform's
59 // default font fallbacks.
60 "ui_font_fallbacks": null,
61 // The OpenType features to enable for text in the UI
62 "ui_font_features": {
63 // Disable ligatures:
64 "calt": false
65 },
66 // The weight of the UI font in standard CSS units from 100 to 900.
67 "ui_font_weight": 400,
68 // The default font size for text in the UI
69 "ui_font_size": 16,
70 // The default font size for text in the agent panel
71 "agent_font_size": 16,
72 // How much to fade out unused code.
73 "unnecessary_code_fade": 0.3,
74 // Active pane styling settings.
75 "active_pane_modifiers": {
76 // The factor to grow the active pane by. Defaults to 1.0
77 // which gives the same size as all other panes.
78 "magnification": 1.0,
79 // Inset border size of the active pane, in pixels.
80 "border_size": 0.0,
81 // Opacity of the inactive panes. 0 means transparent, 1 means opaque.
82 // Values are clamped to the [0.0, 1.0] range.
83 "inactive_opacity": 1.0
84 },
85 // Layout mode of the bottom dock. Defaults to "contained"
86 "bottom_dock_layout": "contained",
87 // The direction that you want to split panes horizontally. Defaults to "up"
88 "pane_split_direction_horizontal": "up",
89 // The direction that you want to split panes horizontally. Defaults to "left"
90 "pane_split_direction_vertical": "left",
91 // Centered layout related settings.
92 "centered_layout": {
93 // The relative width of the left padding of the central pane from the
94 // workspace when the centered layout is used.
95 "left_padding": 0.2,
96 // The relative width of the right padding of the central pane from the
97 // workspace when the centered layout is used.
98 "right_padding": 0.2
99 },
100 // All settings related to the image viewer.
101 "image_viewer": {
102 // The unit for image file sizes.
103 // By default we're setting it to binary.
104 // The second option is decimal.
105 "unit": "binary"
106 },
107 // The key to use for adding multiple cursors
108 // Currently "alt" or "cmd_or_ctrl" (also aliased as
109 // "cmd" and "ctrl") are supported.
110 "multi_cursor_modifier": "alt",
111 // Whether to enable vim modes and key bindings.
112 "vim_mode": false,
113 // Whether to show the informational hover box when moving the mouse
114 // over symbols in the editor.
115 "hover_popover_enabled": true,
116 // Time to wait in milliseconds before showing the informational hover box.
117 "hover_popover_delay": 300,
118 // Whether to confirm before quitting Zed.
119 "confirm_quit": false,
120 // Whether to restore last closed project when fresh Zed instance is opened.
121 "restore_on_startup": "last_session",
122 // Whether to attempt to restore previous file's state when opening it again.
123 // The state is stored per pane.
124 // When disabled, defaults are applied instead of the state restoration.
125 //
126 // E.g. for editors, selections, folds and scroll positions are restored, if the same file is closed and, later, opened again in the same pane.
127 // When disabled, a single selection in the very beginning of the file, zero scroll position and no folds state is used as a default.
128 //
129 // Default: true
130 "restore_on_file_reopen": true,
131 // Size of the drop target in the editor.
132 "drop_target_size": 0.2,
133 // Whether the window should be closed when using 'close active item' on a window with no tabs.
134 // May take 3 values:
135 // 1. Use the current platform's convention
136 // "when_closing_with_no_tabs": "platform_default"
137 // 2. Always close the window:
138 // "when_closing_with_no_tabs": "close_window",
139 // 3. Never close the window
140 // "when_closing_with_no_tabs": "keep_window_open",
141 "when_closing_with_no_tabs": "platform_default",
142 // What to do when the last window is closed.
143 // May take 2 values:
144 // 1. Use the current platform's convention
145 // "on_last_window_closed": "platform_default"
146 // 2. Always quit the application
147 // "on_last_window_closed": "quit_app",
148 "on_last_window_closed": "platform_default",
149 // Whether to use the system provided dialogs for Open and Save As.
150 // When set to false, Zed will use the built-in keyboard-first pickers.
151 "use_system_path_prompts": true,
152 // Whether to use the system provided dialogs for prompts, such as confirmation
153 // prompts.
154 // When set to false, Zed will use its built-in prompts. Note that on Linux,
155 // this option is ignored and Zed will always use the built-in prompts.
156 "use_system_prompts": true,
157 // Whether the cursor blinks in the editor.
158 "cursor_blink": true,
159 // Cursor shape for the default editor.
160 // 1. A vertical bar
161 // "bar"
162 // 2. A block that surrounds the following character
163 // "block"
164 // 3. An underline / underscore that runs along the following character
165 // "underline"
166 // 4. A box drawn around the following character
167 // "hollow"
168 //
169 // Default: not set, defaults to "bar"
170 "cursor_shape": null,
171 // Determines when the mouse cursor should be hidden in an editor or input box.
172 //
173 // 1. Never hide the mouse cursor:
174 // "never"
175 // 2. Hide only when typing:
176 // "on_typing"
177 // 3. Hide on both typing and cursor movement:
178 // "on_typing_and_movement"
179 "hide_mouse": "on_typing_and_movement",
180 // Determines how snippets are sorted relative to other completion items.
181 //
182 // 1. Place snippets at the top of the completion list:
183 // "top"
184 // 2. Place snippets normally without any preference:
185 // "inline"
186 // 3. Place snippets at the bottom of the completion list:
187 // "bottom"
188 "snippet_sort_order": "inline",
189 // How to highlight the current line in the editor.
190 //
191 // 1. Don't highlight the current line:
192 // "none"
193 // 2. Highlight the gutter area:
194 // "gutter"
195 // 3. Highlight the editor area:
196 // "line"
197 // 4. Highlight the full line (default):
198 // "all"
199 "current_line_highlight": "all",
200 // Whether to highlight all occurrences of the selected text in an editor.
201 "selection_highlight": true,
202 // The debounce delay before querying highlights from the language
203 // server based on the current cursor location.
204 "lsp_highlight_debounce": 75,
205 // Whether to pop the completions menu while typing in an editor without
206 // explicitly requesting it.
207 "show_completions_on_input": true,
208 // Whether to display inline and alongside documentation for items in the
209 // completions menu
210 "show_completion_documentation": true,
211 // Show method signatures in the editor, when inside parentheses.
212 "auto_signature_help": false,
213 // Whether to show the signature help after completion or a bracket pair inserted.
214 // If `auto_signature_help` is enabled, this setting will be treated as enabled also.
215 "show_signature_help_after_edits": false,
216 // What to do when go to definition yields no results.
217 //
218 // 1. Do nothing: `none`
219 // 2. Find references for the same symbol: `find_all_references` (default)
220 "go_to_definition_fallback": "find_all_references",
221 // Which level to use to filter out diagnostics displayed in the editor.
222 //
223 // Affects the editor rendering only, and does not interrupt
224 // the functionality of diagnostics fetching and project diagnostics editor.
225 // Which files containing diagnostic errors/warnings to mark in the tabs.
226 // Diagnostics are only shown when file icons are also active.
227 // This setting only works when can take the following three values:
228 //
229 // Which diagnostic indicators to show in the scrollbar, their level should be more or equal to the specified severity level.
230 // Possible values:
231 // - "off" — no diagnostics are allowed
232 // - "error"
233 // - "warning"
234 // - "info"
235 // - "hint"
236 // - null — allow all diagnostics (default)
237 "diagnostics_max_severity": null,
238 // Whether to show wrap guides (vertical rulers) in the editor.
239 // Setting this to true will show a guide at the 'preferred_line_length' value
240 // if 'soft_wrap' is set to 'preferred_line_length', and will show any
241 // additional guides as specified by the 'wrap_guides' setting.
242 "show_wrap_guides": true,
243 // Character counts at which to show wrap guides in the editor.
244 "wrap_guides": [],
245 // Hide the values of in variables from visual display in private files
246 "redact_private_values": false,
247 // The default number of lines to expand excerpts in the multibuffer by.
248 "expand_excerpt_lines": 5,
249 // Globs to match against file paths to determine if a file is private.
250 "private_files": ["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/secrets.yml"],
251 // Whether to use additional LSP queries to format (and amend) the code after
252 // every "trigger" symbol input, defined by LSP server capabilities.
253 "use_on_type_format": true,
254 // Whether to automatically add matching closing characters when typing
255 // opening parenthesis, bracket, brace, single or double quote characters.
256 // For example, when you type (, Zed will add a closing ) at the correct position.
257 "use_autoclose": true,
258 // Whether to automatically surround selected text when typing opening parenthesis,
259 // bracket, brace, single or double quote characters.
260 // For example, when you select text and type (, Zed will surround the text with ().
261 "use_auto_surround": true,
262 // Whether indentation of pasted content should be adjusted based on the context.
263 "auto_indent_on_paste": true,
264 // Controls how the editor handles the autoclosed characters.
265 // When set to `false`(default), skipping over and auto-removing of the closing characters
266 // happen only for auto-inserted characters.
267 // Otherwise(when `true`), the closing characters are always skipped over and auto-removed
268 // no matter how they were inserted.
269 "always_treat_brackets_as_autoclosed": false,
270 // Controls where the `editor::Rewrap` action is allowed in the current language scope.
271 //
272 // This setting can take three values:
273 //
274 // 1. Only allow rewrapping in comments:
275 // "in_comments"
276 // 2. Only allow rewrapping in the current selection(s):
277 // "in_selections"
278 // 3. Allow rewrapping anywhere:
279 // "anywhere"
280 //
281 // When using values other than `in_comments`, it is possible for the rewrapping to produce code
282 // that is syntactically invalid. Keep this in mind when selecting which behavior you would like
283 // to use.
284 //
285 // Note: This setting has no effect in Vim mode, as rewrap is already allowed everywhere.
286 "allow_rewrap": "in_comments",
287 // Controls whether edit predictions are shown immediately (true)
288 // or manually by triggering `editor::ShowEditPrediction` (false).
289 "show_edit_predictions": true,
290 // Controls whether edit predictions are shown in a given language scope.
291 // Example: ["string", "comment"]
292 "edit_predictions_disabled_in": [],
293 // Whether to show tabs and spaces in the editor.
294 // This setting can take four values:
295 //
296 // 1. Draw tabs and spaces only for the selected text (default):
297 // "selection"
298 // 2. Do not draw any tabs or spaces:
299 // "none"
300 // 3. Draw all invisible symbols:
301 // "all"
302 // 4. Draw whitespaces at boundaries only:
303 // "boundary"
304 // For a whitespace to be on a boundary, any of the following conditions need to be met:
305 // - It is a tab
306 // - It is adjacent to an edge (start or end)
307 // - It is adjacent to a whitespace (left or right)
308 "show_whitespaces": "selection",
309 // Settings related to calls in Zed
310 "calls": {
311 // Join calls with the microphone live by default
312 "mute_on_join": false,
313 // Share your project when you are the first to join a channel
314 "share_on_join": false
315 },
316 // Toolbar related settings
317 "toolbar": {
318 // Whether to show breadcrumbs.
319 "breadcrumbs": true,
320 // Whether to show quick action buttons.
321 "quick_actions": true,
322 // Whether to show the Selections menu in the editor toolbar.
323 "selections_menu": true,
324 // Whether to show agent review buttons in the editor toolbar.
325 "agent_review": true,
326 // Whether to show code action buttons in the editor toolbar.
327 "code_actions": true
328 },
329 // Titlebar related settings
330 "title_bar": {
331 // Whether to show the branch icon beside branch switcher in the titlebar.
332 "show_branch_icon": false,
333 // Whether to show the branch name button in the titlebar.
334 "show_branch_name": true,
335 // Whether to show the project host and name in the titlebar.
336 "show_project_items": true,
337 // Whether to show onboarding banners in the titlebar.
338 "show_onboarding_banner": true,
339 // Whether to show user picture in the titlebar.
340 "show_user_picture": true,
341 // Whether to show the sign in button in the titlebar.
342 "show_sign_in": true
343 },
344 // Scrollbar related settings
345 "scrollbar": {
346 // When to show the scrollbar in the editor.
347 // This setting can take four values:
348 //
349 // 1. Show the scrollbar if there's important information or
350 // follow the system's configured behavior (default):
351 // "auto"
352 // 2. Match the system's configured behavior:
353 // "system"
354 // 3. Always show the scrollbar:
355 // "always"
356 // 4. Never show the scrollbar:
357 // "never"
358 "show": "auto",
359 // Whether to show cursor positions in the scrollbar.
360 "cursors": true,
361 // Whether to show git diff indicators in the scrollbar.
362 "git_diff": true,
363 // Whether to show buffer search results in the scrollbar.
364 "search_results": true,
365 // Whether to show selected text occurrences in the scrollbar.
366 "selected_text": true,
367 // Whether to show selected symbol occurrences in the scrollbar.
368 "selected_symbol": true,
369 // Which diagnostic indicators to show in the scrollbar:
370 // - "none" or false: do not show diagnostics
371 // - "error": show only errors
372 // - "warning": show only errors and warnings
373 // - "information": show only errors, warnings, and information
374 // - "all" or true: show all diagnostics
375 "diagnostics": "all",
376 // Forcefully enable or disable the scrollbar for each axis
377 "axes": {
378 // When false, forcefully disables the horizontal scrollbar. Otherwise, obey other settings.
379 "horizontal": true,
380 // When false, forcefully disables the vertical scrollbar. Otherwise, obey other settings.
381 "vertical": true
382 }
383 },
384 // Minimap related settings
385 "minimap": {
386 // When to show the minimap in the editor.
387 // This setting can take three values:
388 // 1. Show the minimap if the editor's scrollbar is visible:
389 // "auto"
390 // 2. Always show the minimap:
391 // "always"
392 // 3. Never show the minimap:
393 // "never" (default)
394 "show": "never",
395 // When to show the minimap thumb.
396 // This setting can take two values:
397 // 1. Show the minimap thumb if the mouse is over the minimap:
398 // "hover"
399 // 2. Always show the minimap thumb:
400 // "always" (default)
401 "thumb": "always",
402 // How the minimap thumb border should look.
403 // This setting can take five values:
404 // 1. Display a border on all sides of the thumb:
405 // "thumb_border": "full"
406 // 2. Display a border on all sides except the left side of the thumb:
407 // "thumb_border": "left_open" (default)
408 // 3. Display a border on all sides except the right side of the thumb:
409 // "thumb_border": "right_open"
410 // 4. Display a border only on the left side of the thumb:
411 // "thumb_border": "left_only"
412 // 5. Display the thumb without any border:
413 // "thumb_border": "none"
414 "thumb_border": "left_open",
415 // How to highlight the current line in the minimap.
416 // This setting can take the following values:
417 //
418 // 1. `null` to inherit the editor `current_line_highlight` setting (default)
419 // 2. "line" or "all" to highlight the current line in the minimap.
420 // 3. "gutter" or "none" to not highlight the current line in the minimap.
421 "current_line_highlight": null
422 },
423 // Enable middle-click paste on Linux.
424 "middle_click_paste": true,
425 // What to do when multibuffer is double clicked in some of its excerpts
426 // (parts of singleton buffers).
427 // May take 2 values:
428 // 1. Behave as a regular buffer and select the whole word (default).
429 // "double_click_in_multibuffer": "select"
430 // 2. Open the excerpt clicked as a new buffer in the new tab.
431 // "double_click_in_multibuffer": "open",
432 // For the case of "open", regular selection behavior can be achieved by holding `alt` when double clicking.
433 "double_click_in_multibuffer": "select",
434 "gutter": {
435 // Whether to show line numbers in the gutter.
436 "line_numbers": true,
437 // Whether to show runnables buttons in the gutter.
438 "runnables": true,
439 // Whether to show breakpoints in the gutter.
440 "breakpoints": true,
441 // Whether to show fold buttons in the gutter.
442 "folds": true
443 },
444 "indent_guides": {
445 // Whether to show indent guides in the editor.
446 "enabled": true,
447 // The width of the indent guides in pixels, between 1 and 10.
448 "line_width": 1,
449 // The width of the active indent guide in pixels, between 1 and 10.
450 "active_line_width": 1,
451 // Determines how indent guides are colored.
452 // This setting can take the following three values:
453 //
454 // 1. "disabled"
455 // 2. "fixed"
456 // 3. "indent_aware"
457 "coloring": "fixed",
458 // Determines how indent guide backgrounds are colored.
459 // This setting can take the following two values:
460 //
461 // 1. "disabled"
462 // 2. "indent_aware"
463 "background_coloring": "disabled"
464 },
465 // Whether the editor will scroll beyond the last line.
466 "scroll_beyond_last_line": "one_page",
467 // The number of lines to keep above/below the cursor when scrolling.
468 "vertical_scroll_margin": 3,
469 // Whether to scroll when clicking near the edge of the visible text area.
470 "autoscroll_on_clicks": false,
471 // The number of characters to keep on either side when scrolling with the mouse
472 "horizontal_scroll_margin": 5,
473 // Scroll sensitivity multiplier. This multiplier is applied
474 // to both the horizontal and vertical delta values while scrolling.
475 "scroll_sensitivity": 1.0,
476 "relative_line_numbers": false,
477 // If 'search_wrap' is disabled, search result do not wrap around the end of the file.
478 "search_wrap": true,
479 // Search options to enable by default when opening new project and buffer searches.
480 "search": {
481 // Whether to show the project search button in the status bar.
482 "button": true,
483 "whole_word": false,
484 "case_sensitive": false,
485 "include_ignored": false,
486 "regex": false
487 },
488 // When to populate a new search's query based on the text under the cursor.
489 // This setting can take the following three values:
490 //
491 // 1. Always populate the search query with the word under the cursor (default).
492 // "always"
493 // 2. Only populate the search query when there is text selected
494 // "selection"
495 // 3. Never populate the search query
496 // "never"
497 "seed_search_query_from_cursor": "always",
498 // When enabled, automatically adjusts search case sensitivity based on your query.
499 // If your search query contains any uppercase letters, the search becomes case-sensitive;
500 // if it contains only lowercase letters, the search becomes case-insensitive.
501 "use_smartcase_search": false,
502 // Inlay hint related settings
503 "inlay_hints": {
504 // Global switch to toggle hints on and off, switched off by default.
505 "enabled": false,
506 // Toggle certain types of hints on and off, all switched on by default.
507 "show_type_hints": true,
508 "show_parameter_hints": true,
509 // Corresponds to null/None LSP hint type value.
510 "show_other_hints": true,
511 // Whether to show a background for inlay hints.
512 //
513 // If set to `true`, the background will use the `hint.background` color from the current theme.
514 "show_background": false,
515 // Time to wait after editing the buffer, before requesting the hints,
516 // set to 0 to disable debouncing.
517 "edit_debounce_ms": 700,
518 // Time to wait after scrolling the buffer, before requesting the hints,
519 // set to 0 to disable debouncing.
520 "scroll_debounce_ms": 50,
521 // A set of modifiers which, when pressed, will toggle the visibility of inlay hints.
522 // If the set if empty or not all the modifiers specified are pressed, inlay hints will not be toggled.
523 "toggle_on_modifiers_press": {
524 "control": false,
525 "shift": false,
526 "alt": false,
527 "platform": false,
528 "function": false
529 }
530 },
531 "project_panel": {
532 // Whether to show the project panel button in the status bar
533 "button": true,
534 // Whether to hide the gitignore entries in the project panel.
535 "hide_gitignore": false,
536 // Default width of the project panel.
537 "default_width": 240,
538 // Where to dock the project panel. Can be 'left' or 'right'.
539 "dock": "left",
540 // Spacing between worktree entries in the project panel. Can be 'comfortable' or 'standard'.
541 "entry_spacing": "comfortable",
542 // Whether to show file icons in the project panel.
543 "file_icons": true,
544 // Whether to show folder icons or chevrons for directories in the project panel.
545 "folder_icons": true,
546 // Whether to show the git status in the project panel.
547 "git_status": true,
548 // Amount of indentation for nested items.
549 "indent_size": 20,
550 // Whether to reveal it in the project panel automatically,
551 // when a corresponding project entry becomes active.
552 // Gitignored entries are never auto revealed.
553 "auto_reveal_entries": true,
554 // Whether to fold directories automatically and show compact folders
555 // (e.g. "a/b/c" ) when a directory has only one subdirectory inside.
556 "auto_fold_dirs": true,
557 // Scrollbar-related settings
558 "scrollbar": {
559 // When to show the scrollbar in the project panel.
560 // This setting can take five values:
561 //
562 // 1. null (default): Inherit editor settings
563 // 2. Show the scrollbar if there's important information or
564 // follow the system's configured behavior (default):
565 // "auto"
566 // 3. Match the system's configured behavior:
567 // "system"
568 // 4. Always show the scrollbar:
569 // "always"
570 // 5. Never show the scrollbar:
571 // "never"
572 "show": null
573 },
574 // Which files containing diagnostic errors/warnings to mark in the project panel.
575 // This setting can take the following three values:
576 //
577 // 1. Do not mark any files:
578 // "off"
579 // 2. Only mark files with errors:
580 // "errors"
581 // 3. Mark files with errors and warnings:
582 // "all"
583 "show_diagnostics": "all",
584 // Settings related to indent guides in the project panel.
585 "indent_guides": {
586 // When to show indent guides in the project panel.
587 // This setting can take two values:
588 //
589 // 1. Always show indent guides:
590 // "always"
591 // 2. Never show indent guides:
592 // "never"
593 "show": "always"
594 }
595 },
596 "outline_panel": {
597 // Whether to show the outline panel button in the status bar
598 "button": true,
599 // Default width of the outline panel.
600 "default_width": 300,
601 // Where to dock the outline panel. Can be 'left' or 'right'.
602 "dock": "left",
603 // Whether to show file icons in the outline panel.
604 "file_icons": true,
605 // Whether to show folder icons or chevrons for directories in the outline panel.
606 "folder_icons": true,
607 // Whether to show the git status in the outline panel.
608 "git_status": true,
609 // Amount of indentation for nested items.
610 "indent_size": 20,
611 // Whether to reveal it in the outline panel automatically,
612 // when a corresponding outline entry becomes active.
613 // Gitignored entries are never auto revealed.
614 "auto_reveal_entries": true,
615 // Whether to fold directories automatically
616 // when a directory has only one directory inside.
617 "auto_fold_dirs": true,
618 // Settings related to indent guides in the outline panel.
619 "indent_guides": {
620 // When to show indent guides in the outline panel.
621 // This setting can take two values:
622 //
623 // 1. Always show indent guides:
624 // "always"
625 // 2. Never show indent guides:
626 // "never"
627 "show": "always"
628 },
629 // Scrollbar-related settings
630 "scrollbar": {
631 // When to show the scrollbar in the project panel.
632 // This setting can take five values:
633 //
634 // 1. null (default): Inherit editor settings
635 // 2. Show the scrollbar if there's important information or
636 // follow the system's configured behavior (default):
637 // "auto"
638 // 3. Match the system's configured behavior:
639 // "system"
640 // 4. Always show the scrollbar:
641 // "always"
642 // 5. Never show the scrollbar:
643 // "never"
644 "show": null
645 }
646 },
647 "collaboration_panel": {
648 // Whether to show the collaboration panel button in the status bar.
649 "button": true,
650 // Where to dock the collaboration panel. Can be 'left' or 'right'.
651 "dock": "left",
652 // Default width of the collaboration panel.
653 "default_width": 240
654 },
655 "chat_panel": {
656 // When to show the chat panel button in the status bar.
657 // Can be 'never', 'always', or 'when_in_call',
658 // or a boolean (interpreted as 'never'/'always').
659 "button": "when_in_call",
660 // Where to the chat panel. Can be 'left' or 'right'.
661 "dock": "right",
662 // Default width of the chat panel.
663 "default_width": 240
664 },
665 "git_panel": {
666 // Whether to show the git panel button in the status bar.
667 "button": true,
668 // Where to show the git panel. Can be 'left' or 'right'.
669 "dock": "left",
670 // Default width of the git panel.
671 "default_width": 360,
672 // Style of the git status indicator in the panel.
673 //
674 // Default: icon
675 "status_style": "icon",
676 // What branch name to use if init.defaultBranch
677 // is not set
678 //
679 // Default: main
680 "fallback_branch_name": "main",
681 // Whether to sort entries in the panel by path
682 // or by status (the default).
683 //
684 // Default: false
685 "sort_by_path": false,
686 "scrollbar": {
687 // When to show the scrollbar in the git panel.
688 //
689 // Default: inherits editor scrollbar settings
690 "show": null
691 }
692 },
693 "message_editor": {
694 // Whether to automatically replace emoji shortcodes with emoji characters.
695 // For example: typing `:wave:` gets replaced with `👋`.
696 "auto_replace_emoji_shortcode": true
697 },
698 "notification_panel": {
699 // Whether to show the notification panel button in the status bar.
700 "button": true,
701 // Where to dock the notification panel. Can be 'left' or 'right'.
702 "dock": "right",
703 // Default width of the notification panel.
704 "default_width": 380
705 },
706 "agent": {
707 // Version of this setting.
708 "version": "2",
709 // Whether the agent is enabled.
710 "enabled": true,
711 /// What completion mode to start new threads in, if available. Can be 'normal' or 'max'.
712 "preferred_completion_mode": "normal",
713 // Whether to show the agent panel button in the status bar.
714 "button": true,
715 // Where to dock the agent panel. Can be 'left', 'right' or 'bottom'.
716 "dock": "right",
717 // Default width when the agent panel is docked to the left or right.
718 "default_width": 640,
719 // Default height when the agent panel is docked to the bottom.
720 "default_height": 320,
721 // The default model to use when creating new threads.
722 "default_model": {
723 // The provider to use.
724 "provider": "zed.dev",
725 // The model to use.
726 "model": "claude-3-7-sonnet-latest"
727 },
728 // The model to use when applying edits from the agent.
729 "editor_model": {
730 // The provider to use.
731 "provider": "zed.dev",
732 // The model to use.
733 "model": "claude-3-7-sonnet-latest"
734 },
735 // Additional parameters for language model requests. When making a request to a model, parameters will be taken
736 // from the last entry in this list that matches the model's provider and name. In each entry, both provider
737 // and model are optional, so that you can specify parameters for either one.
738 "model_parameters": [
739 // To set parameters for all requests to OpenAI models:
740 // {
741 // "provider": "openai",
742 // "temperature": 0.5
743 // }
744 //
745 // To set parameters for all requests in general:
746 // {
747 // "temperature": 0
748 // }
749 //
750 // To set parameters for a specific provider and model:
751 // {
752 // "provider": "zed.dev",
753 // "model": "claude-3-7-sonnet-latest",
754 // "temperature": 1.0
755 // }
756 ],
757 // When enabled, the agent can run potentially destructive actions without asking for your confirmation.
758 "always_allow_tool_actions": false,
759 // When enabled, the agent will stream edits.
760 "stream_edits": false,
761 // When enabled, agent edits will be displayed in single-file editors for review
762 "single_file_review": true,
763 // When enabled, show voting thumbs for feedback on agent edits.
764 "enable_feedback": true,
765 "default_profile": "write",
766 "profiles": {
767 "write": {
768 "name": "Write",
769 "enable_all_context_servers": true,
770 "tools": {
771 "copy_path": true,
772 "create_directory": true,
773 "create_file": true,
774 "delete_path": true,
775 "diagnostics": true,
776 "edit_file": true,
777 "fetch": true,
778 "list_directory": true,
779 "move_path": true,
780 "now": true,
781 "find_path": true,
782 "read_file": true,
783 "grep": true,
784 "terminal": true,
785 "thinking": true,
786 "web_search": true
787 }
788 },
789 "ask": {
790 "name": "Ask",
791 // We don't know which of the context server tools are safe for the "Ask" profile, so we don't enable them by default.
792 // "enable_all_context_servers": true,
793 "tools": {
794 "contents": true,
795 "diagnostics": true,
796 "fetch": true,
797 "list_directory": true,
798 "now": true,
799 "find_path": true,
800 "read_file": true,
801 "open": true,
802 "grep": true,
803 "thinking": true,
804 "web_search": true
805 }
806 },
807 "minimal": {
808 "name": "Minimal",
809 "enable_all_context_servers": false,
810 "tools": {}
811 }
812 },
813 // Where to show notifications when the agent has either completed
814 // its response, or else needs confirmation before it can run a
815 // tool action.
816 // "primary_screen" - Show the notification only on your primary screen (default)
817 // "all_screens" - Show these notifications on all screens
818 // "never" - Never show these notifications
819 "notify_when_agent_waiting": "primary_screen"
820 },
821 // The settings for slash commands.
822 "slash_commands": {
823 // Settings for the `/docs` slash command.
824 "docs": {
825 // Whether `/docs` is enabled.
826 "enabled": false
827 },
828 // Settings for the `/project` slash command.
829 "project": {
830 // Whether `/project` is enabled.
831 "enabled": false
832 }
833 },
834 // Whether the screen sharing icon is shown in the os status bar.
835 "show_call_status_icon": true,
836 // Whether to use language servers to provide code intelligence.
837 "enable_language_server": true,
838 // Whether to perform linked edits of associated ranges, if the language server supports it.
839 // For example, when editing opening <html> tag, the contents of the closing </html> tag will be edited as well.
840 "linked_edits": true,
841 // The list of language servers to use (or disable) for all languages.
842 //
843 // This is typically customized on a per-language basis.
844 "language_servers": ["..."],
845 // When to automatically save edited buffers. This setting can
846 // take four values.
847 //
848 // 1. Never automatically save:
849 // "autosave": "off",
850 // 2. Save when changing focus away from the Zed window:
851 // "autosave": "on_window_change",
852 // 3. Save when changing focus away from a specific buffer:
853 // "autosave": "on_focus_change",
854 // 4. Save when idle for a certain amount of time:
855 // "autosave": { "after_delay": {"milliseconds": 500} },
856 "autosave": "off",
857 // Maximum number of tabs per pane. Unset for unlimited.
858 "max_tabs": null,
859 // Settings related to the editor's tab bar.
860 "tab_bar": {
861 // Whether or not to show the tab bar in the editor
862 "show": true,
863 // Whether or not to show the navigation history buttons.
864 "show_nav_history_buttons": true,
865 // Whether or not to show the tab bar buttons.
866 "show_tab_bar_buttons": true
867 },
868 // Settings related to the editor's tabs
869 "tabs": {
870 // Show git status colors in the editor tabs.
871 "git_status": false,
872 // Position of the close button on the editor tabs.
873 // One of: ["right", "left", "hidden"]
874 "close_position": "right",
875 // Whether to show the file icon for a tab.
876 "file_icons": false,
877 // Controls the appearance behavior of the tab's close button.
878 //
879 // 1. Show it just upon hovering the tab. (default)
880 // "hover"
881 // 2. Show it persistently.
882 // "always"
883 // 3. Never show it, even if hovering it.
884 // "hidden"
885 "show_close_button": "hover",
886 // What to do after closing the current tab.
887 //
888 // 1. Activate the tab that was open previously (default)
889 // "history"
890 // 2. Activate the right neighbour tab if present
891 // "neighbour"
892 // 3. Activate the left neighbour tab if present
893 // "left_neighbour"
894 "activate_on_close": "history",
895 // Which files containing diagnostic errors/warnings to mark in the tabs.
896 // Diagnostics are only shown when file icons are also active.
897 // This setting only works when can take the following three values:
898 //
899 // 1. Do not mark any files:
900 // "off"
901 // 2. Only mark files with errors:
902 // "errors"
903 // 3. Mark files with errors and warnings:
904 // "all"
905 "show_diagnostics": "off"
906 },
907 // Settings related to preview tabs.
908 "preview_tabs": {
909 // Whether preview tabs should be enabled.
910 // Preview tabs allow you to open files in preview mode, where they close automatically
911 // when you switch to another file unless you explicitly pin them.
912 // This is useful for quickly viewing files without cluttering your workspace.
913 "enabled": true,
914 // Whether to open tabs in preview mode when selected from the file finder.
915 "enable_preview_from_file_finder": false,
916 // Whether a preview tab gets replaced when code navigation is used to navigate away from the tab.
917 "enable_preview_from_code_navigation": false
918 },
919 // Settings related to the file finder.
920 "file_finder": {
921 // Whether to show file icons in the file finder.
922 "file_icons": true,
923 // Determines how much space the file finder can take up in relation to the available window width.
924 // There are 5 possible width values:
925 //
926 // 1. Small: This value is essentially a fixed width.
927 // "modal_max_width": "small"
928 // 2. Medium:
929 // "modal_max_width": "medium"
930 // 3. Large:
931 // "modal_max_width": "large"
932 // 4. Extra Large:
933 // "modal_max_width": "xlarge"
934 // 5. Fullscreen: This value removes any horizontal padding, as it consumes the whole viewport width.
935 // "modal_max_width": "full"
936 //
937 // Default: small
938 "modal_max_width": "small",
939 // Determines whether the file finder should skip focus for the active file in search results.
940 // There are 2 possible values:
941 //
942 // 1. true: When searching for files, if the currently active file appears as the first result,
943 // auto-focus will skip it and focus the second result instead.
944 // "skip_focus_for_active_in_search": true
945 //
946 // 2. false: When searching for files, the first result will always receive focus,
947 // even if it's the currently active file.
948 // "skip_focus_for_active_in_search": false
949 //
950 // Default: true
951 "skip_focus_for_active_in_search": true
952 },
953 // Whether or not to remove any trailing whitespace from lines of a buffer
954 // before saving it.
955 "remove_trailing_whitespace_on_save": true,
956 // Whether to start a new line with a comment when a previous line is a comment as well.
957 "extend_comment_on_newline": true,
958 // Removes any lines containing only whitespace at the end of the file and
959 // ensures just one newline at the end.
960 "ensure_final_newline_on_save": true,
961 // Whether or not to perform a buffer format before saving
962 //
963 // Keep in mind, if the autosave with delay is enabled, format_on_save will be ignored
964 "format_on_save": "on",
965 // How to perform a buffer format. This setting can take 4 values:
966 //
967 // 1. Format code using the current language server:
968 // "formatter": "language_server"
969 // 2. Format code using an external command:
970 // "formatter": {
971 // "external": {
972 // "command": "prettier",
973 // "arguments": ["--stdin-filepath", "{buffer_path}"]
974 // }
975 // }
976 // 3. Format code using Zed's Prettier integration:
977 // "formatter": "prettier"
978 // 4. Default. Format files using Zed's Prettier integration (if applicable),
979 // or falling back to formatting via language server:
980 // "formatter": "auto"
981 "formatter": "auto",
982 // How to soft-wrap long lines of text.
983 // Possible values:
984 //
985 // 1. Prefer a single line generally, unless an overly long line is encountered.
986 // "soft_wrap": "none",
987 // "soft_wrap": "prefer_line", // (deprecated, same as "none")
988 // 2. Soft wrap lines that overflow the editor.
989 // "soft_wrap": "editor_width",
990 // 3. Soft wrap lines at the preferred line length.
991 // "soft_wrap": "preferred_line_length",
992 // 4. Soft wrap lines at the preferred line length or the editor width (whichever is smaller).
993 // "soft_wrap": "bounded",
994 "soft_wrap": "none",
995 // The column at which to soft-wrap lines, for buffers where soft-wrap
996 // is enabled.
997 "preferred_line_length": 80,
998 // Whether to indent lines using tab characters, as opposed to multiple
999 // spaces.
1000 "hard_tabs": false,
1001 // How many columns a tab should occupy.
1002 "tab_size": 4,
1003 // What debuggers are preferred by default for all languages.
1004 "debuggers": [],
1005 // Control what info is collected by Zed.
1006 "telemetry": {
1007 // Send debug info like crash reports.
1008 "diagnostics": true,
1009 // Send anonymized usage data like what languages you're using Zed with.
1010 "metrics": true
1011 },
1012 // Automatically update Zed. This setting may be ignored on Linux if
1013 // installed through a package manager.
1014 "auto_update": true,
1015 // Diagnostics configuration.
1016 "diagnostics": {
1017 // Whether to show the project diagnostics button in the status bar.
1018 "button": true,
1019 // Whether to show warnings or not by default.
1020 "include_warnings": true,
1021 // Settings for inline diagnostics
1022 "inline": {
1023 // Whether to show diagnostics inline or not
1024 "enabled": false,
1025 // The delay in milliseconds to show inline diagnostics after the
1026 // last diagnostic update.
1027 "update_debounce_ms": 150,
1028 // The amount of padding between the end of the source line and the start
1029 // of the inline diagnostic in units of em widths.
1030 "padding": 4,
1031 // The minimum column to display inline diagnostics. This setting can be
1032 // used to horizontally align inline diagnostics at some column. Lines
1033 // longer than this value will still push diagnostics further to the right.
1034 "min_column": 0,
1035 // The minimum severity of the diagnostics to show inline.
1036 // Inherits editor's diagnostics' max severity settings when `null`.
1037 "max_severity": null
1038 },
1039 "cargo": {
1040 // When enabled, Zed disables rust-analyzer's check on save and starts to query
1041 // Cargo diagnostics separately.
1042 "fetch_cargo_diagnostics": false
1043 }
1044 },
1045 // Files or globs of files that will be excluded by Zed entirely. They will be skipped during file
1046 // scans, file searches, and not be displayed in the project file tree. Takes precedence over `file_scan_inclusions`.
1047 "file_scan_exclusions": [
1048 "**/.git",
1049 "**/.svn",
1050 "**/.hg",
1051 "**/.jj",
1052 "**/CVS",
1053 "**/.DS_Store",
1054 "**/Thumbs.db",
1055 "**/.classpath",
1056 "**/.settings"
1057 ],
1058 // Files or globs of files that will be included by Zed, even when ignored by git. This is useful
1059 // for files that are not tracked by git, but are still important to your project. Note that globs
1060 // that are overly broad can slow down Zed's file scanning. `file_scan_exclusions` takes
1061 // precedence over these inclusions.
1062 "file_scan_inclusions": [".env*"],
1063 // Git gutter behavior configuration.
1064 "git": {
1065 // Control whether the git gutter is shown. May take 2 values:
1066 // 1. Show the gutter
1067 // "git_gutter": "tracked_files"
1068 // 2. Hide the gutter
1069 // "git_gutter": "hide"
1070 "git_gutter": "tracked_files",
1071 // Control whether the git blame information is shown inline,
1072 // in the currently focused line.
1073 "inline_blame": {
1074 "enabled": true
1075 // Sets a delay after which the inline blame information is shown.
1076 // Delay is restarted with every cursor movement.
1077 // "delay_ms": 600
1078 //
1079 // Whether or not to display the git commit summary on the same line.
1080 // "show_commit_summary": false
1081 //
1082 // The minimum column number to show the inline blame information at
1083 // "min_column": 0
1084 },
1085 // How git hunks are displayed visually in the editor.
1086 // This setting can take two values:
1087 //
1088 // 1. Show unstaged hunks filled and staged hunks hollow:
1089 // "hunk_style": "staged_hollow"
1090 // 2. Show unstaged hunks hollow and staged hunks filled:
1091 // "hunk_style": "unstaged_hollow"
1092 "hunk_style": "staged_hollow"
1093 },
1094 // The list of custom Git hosting providers.
1095 "git_hosting_providers": [
1096 // {
1097 // "provider": "github",
1098 // "name": "BigCorp GitHub",
1099 // "base_url": "https://code.big-corp.com"
1100 // }
1101 ],
1102 // Configuration for how direnv configuration should be loaded. May take 2 values:
1103 // 1. Load direnv configuration using `direnv export json` directly.
1104 // "load_direnv": "direct"
1105 // 2. Load direnv configuration through the shell hook, works for POSIX shells and fish.
1106 // "load_direnv": "shell_hook"
1107 "load_direnv": "direct",
1108 "edit_predictions": {
1109 // A list of globs representing files that edit predictions should be disabled for.
1110 // There's a sensible default list of globs already included.
1111 // Any addition to this list will be merged with the default list.
1112 // Globs are matched relative to the worktree root,
1113 // except when starting with a slash (/) or equivalent in Windows.
1114 "disabled_globs": ["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/.dev.vars", "**/secrets.yml"],
1115 // When to show edit predictions previews in buffer.
1116 // This setting takes two possible values:
1117 // 1. Display predictions inline when there are no language server completions available.
1118 // "mode": "eager"
1119 // 2. Display predictions inline only when holding a modifier key (alt by default).
1120 // "mode": "subtle"
1121 "mode": "eager",
1122 // Whether edit predictions are enabled when editing text threads.
1123 // This setting has no effect if globally disabled.
1124 "enabled_in_text_threads": true
1125 },
1126 // Settings specific to journaling
1127 "journal": {
1128 // The path of the directory where journal entries are stored
1129 "path": "~",
1130 // What format to display the hours in
1131 // May take 2 values:
1132 // 1. hour12
1133 // 2. hour24
1134 "hour_format": "hour12"
1135 },
1136 // Settings specific to the terminal
1137 "terminal": {
1138 // What shell to use when opening a terminal. May take 3 values:
1139 // 1. Use the system's default terminal configuration in /etc/passwd
1140 // "shell": "system"
1141 // 2. A program:
1142 // "shell": {
1143 // "program": "sh"
1144 // }
1145 // 3. A program with arguments:
1146 // "shell": {
1147 // "with_arguments": {
1148 // "program": "/bin/bash",
1149 // "args": ["--login"]
1150 // }
1151 // }
1152 "shell": "system",
1153 // Where to dock terminals panel. Can be `left`, `right`, `bottom`.
1154 "dock": "bottom",
1155 // Default width when the terminal is docked to the left or right.
1156 "default_width": 640,
1157 // Default height when the terminal is docked to the bottom.
1158 "default_height": 320,
1159 // What working directory to use when launching the terminal.
1160 // May take 4 values:
1161 // 1. Use the current file's project directory. Will Fallback to the
1162 // first project directory strategy if unsuccessful
1163 // "working_directory": "current_project_directory"
1164 // 2. Use the first project in this workspace's directory
1165 // "working_directory": "first_project_directory"
1166 // 3. Always use this platform's home directory (if we can find it)
1167 // "working_directory": "always_home"
1168 // 4. Always use a specific directory. This value will be shell expanded.
1169 // If this path is not a valid directory the terminal will default to
1170 // this platform's home directory (if we can find it)
1171 // "working_directory": {
1172 // "always": {
1173 // "directory": "~/zed/projects/"
1174 // }
1175 // }
1176 "working_directory": "current_project_directory",
1177 // Set the cursor blinking behavior in the terminal.
1178 // May take 3 values:
1179 // 1. Never blink the cursor, ignoring the terminal mode
1180 // "blinking": "off",
1181 // 2. Default the cursor blink to off, but allow the terminal to
1182 // set blinking
1183 // "blinking": "terminal_controlled",
1184 // 3. Always blink the cursor, ignoring the terminal mode
1185 // "blinking": "on",
1186 "blinking": "terminal_controlled",
1187 // Default cursor shape for the terminal.
1188 // 1. A block that surrounds the following character
1189 // "block"
1190 // 2. A vertical bar
1191 // "bar"
1192 // 3. An underline / underscore that runs along the following character
1193 // "underline"
1194 // 4. A box drawn around the following character
1195 // "hollow"
1196 //
1197 // Default: not set, defaults to "block"
1198 "cursor_shape": null,
1199 // Set whether Alternate Scroll mode (code: ?1007) is active by default.
1200 // Alternate Scroll mode converts mouse scroll events into up / down key
1201 // presses when in the alternate screen (e.g. when running applications
1202 // like vim or less). The terminal can still set and unset this mode.
1203 // May take 2 values:
1204 // 1. Default alternate scroll mode to on
1205 // "alternate_scroll": "on",
1206 // 2. Default alternate scroll mode to off
1207 // "alternate_scroll": "off",
1208 "alternate_scroll": "on",
1209 // Set whether the option key behaves as the meta key.
1210 // May take 2 values:
1211 // 1. Rely on default platform handling of option key, on macOS
1212 // this means generating certain unicode characters
1213 // "option_as_meta": false,
1214 // 2. Make the option keys behave as a 'meta' key, e.g. for emacs
1215 // "option_as_meta": true,
1216 "option_as_meta": false,
1217 // Whether or not selecting text in the terminal will automatically
1218 // copy to the system clipboard.
1219 "copy_on_select": false,
1220 // Whether to show the terminal button in the status bar
1221 "button": true,
1222 // Any key-value pairs added to this list will be added to the terminal's
1223 // environment. Use `:` to separate multiple values.
1224 "env": {
1225 // "KEY": "value1:value2"
1226 },
1227 // Set the terminal's line height.
1228 // May take 3 values:
1229 // 1. Use a line height that's comfortable for reading, 1.618
1230 // "line_height": "comfortable"
1231 // 2. Use a standard line height, 1.3. This option is useful for TUIs,
1232 // particularly if they use box characters
1233 // "line_height": "standard",
1234 // 3. Use a custom line height.
1235 // "line_height": {
1236 // "custom": 2
1237 // },
1238 "line_height": "comfortable",
1239 // Activate the python virtual environment, if one is found, in the
1240 // terminal's working directory (as resolved by the working_directory
1241 // setting). Set this to "off" to disable this behavior.
1242 "detect_venv": {
1243 "on": {
1244 // Default directories to search for virtual environments, relative
1245 // to the current working directory. We recommend overriding this
1246 // in your project's settings, rather than globally.
1247 "directories": [".env", "env", ".venv", "venv"],
1248 // Can also be `csh`, `fish`, `nushell` and `power_shell`
1249 "activate_script": "default"
1250 }
1251 },
1252 "toolbar": {
1253 // Whether to display the terminal title in its toolbar's breadcrumbs.
1254 // Only shown if the terminal title is not empty.
1255 //
1256 // The shell running in the terminal needs to be configured to emit the title.
1257 // Example: `echo -e "\e]2;New Title\007";`
1258 "breadcrumbs": true
1259 },
1260 // Scrollbar-related settings
1261 "scrollbar": {
1262 // When to show the scrollbar in the terminal.
1263 // This setting can take five values:
1264 //
1265 // 1. null (default): Inherit editor settings
1266 // 2. Show the scrollbar if there's important information or
1267 // follow the system's configured behavior (default):
1268 // "auto"
1269 // 3. Match the system's configured behavior:
1270 // "system"
1271 // 4. Always show the scrollbar:
1272 // "always"
1273 // 5. Never show the scrollbar:
1274 // "never"
1275 "show": null
1276 }
1277 // Set the terminal's font size. If this option is not included,
1278 // the terminal will default to matching the buffer's font size.
1279 // "font_size": 15,
1280 // Set the terminal's font family. If this option is not included,
1281 // the terminal will default to matching the buffer's font family.
1282 // "font_family": "Zed Plex Mono",
1283 // Set the terminal's font fallbacks. If this option is not included,
1284 // the terminal will default to matching the buffer's font fallbacks.
1285 // This will be merged with the platform's default font fallbacks
1286 // "font_fallbacks": ["FiraCode Nerd Fonts"],
1287 // Sets the maximum number of lines in the terminal's scrollback buffer.
1288 // Default: 10_000, maximum: 100_000 (all bigger values set will be treated as 100_000), 0 disables the scrolling.
1289 // Existing terminals will not pick up this change until they are recreated.
1290 // "max_scroll_history_lines": 10000,
1291 },
1292 "code_actions_on_format": {},
1293 // Settings related to running tasks.
1294 "tasks": {
1295 "variables": {},
1296 "enabled": true
1297 },
1298 // An object whose keys are language names, and whose values
1299 // are arrays of filenames or extensions of files that should
1300 // use those languages.
1301 //
1302 // For example, to treat files like `foo.notjs` as JavaScript,
1303 // and `Embargo.lock` as TOML:
1304 //
1305 // {
1306 // "JavaScript": ["notjs"],
1307 // "TOML": ["Embargo.lock"]
1308 // }
1309 //
1310 "file_types": {
1311 "JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json", "**/.vscode/**/*.json"],
1312 "Shell Script": [".env.*"]
1313 },
1314 // Settings for which version of Node.js and NPM to use when installing
1315 // language servers and Copilot.
1316 //
1317 // Note: changing this setting currently requires restarting Zed.
1318 "node": {
1319 // By default, Zed will look for `node` and `npm` on your `$PATH`, and use the
1320 // existing executables if their version is recent enough. Set this to `true`
1321 // to prevent this, and force Zed to always download and install its own
1322 // version of Node.
1323 "ignore_system_version": false,
1324 // You can also specify alternative paths to Node and NPM. If you specify
1325 // `path`, but not `npm_path`, Zed will assume that `npm` is located at
1326 // `${path}/../npm`.
1327 "path": null,
1328 "npm_path": null
1329 },
1330 // The extensions that Zed should automatically install on startup.
1331 //
1332 // If you don't want any of these extensions, add this field to your settings
1333 // and change the value to `false`.
1334 "auto_install_extensions": {
1335 "html": true
1336 },
1337 // Controls how completions are processed for this language.
1338 "completions": {
1339 // Controls how words are completed.
1340 // For large documents, not all words may be fetched for completion.
1341 //
1342 // May take 3 values:
1343 // 1. "enabled"
1344 // Always fetch document's words for completions along with LSP completions.
1345 // 2. "fallback"
1346 // Only if LSP response errors or times out, use document's words to show completions.
1347 // 3. "disabled"
1348 // Never fetch or complete document's words for completions.
1349 // (Word-based completions can still be queried via a separate action)
1350 //
1351 // Default: fallback
1352 "words": "fallback",
1353 // Whether to fetch LSP completions or not.
1354 //
1355 // Default: true
1356 "lsp": true,
1357 // When fetching LSP completions, determines how long to wait for a response of a particular server.
1358 // When set to 0, waits indefinitely.
1359 //
1360 // Default: 0
1361 "lsp_fetch_timeout_ms": 0,
1362 // Controls what range to replace when accepting LSP completions.
1363 //
1364 // When LSP servers give an `InsertReplaceEdit` completion, they provides two ranges: `insert` and `replace`. Usually, `insert`
1365 // contains the word prefix before your cursor and `replace` contains the whole word.
1366 //
1367 // Effectively, this setting just changes whether Zed will use the received range for `insert` or `replace`, so the results may
1368 // differ depending on the underlying LSP server.
1369 //
1370 // Possible values:
1371 // 1. "insert"
1372 // Replaces text before the cursor, using the `insert` range described in the LSP specification.
1373 // 2. "replace"
1374 // Replaces text before and after the cursor, using the `replace` range described in the LSP specification.
1375 // 3. "replace_subsequence"
1376 // Behaves like `"replace"` if the text that would be replaced is a subsequence of the completion text,
1377 // and like `"insert"` otherwise.
1378 // 4. "replace_suffix"
1379 // Behaves like `"replace"` if the text after the cursor is a suffix of the completion, and like
1380 // `"insert"` otherwise.
1381 "lsp_insert_mode": "replace_suffix"
1382 },
1383 // Different settings for specific languages.
1384 "languages": {
1385 "Astro": {
1386 "language_servers": ["astro-language-server", "..."],
1387 "prettier": {
1388 "allowed": true,
1389 "plugins": ["prettier-plugin-astro"]
1390 }
1391 },
1392 "Blade": {
1393 "prettier": {
1394 "allowed": true
1395 }
1396 },
1397 "C": {
1398 "format_on_save": "off",
1399 "use_on_type_format": false,
1400 "prettier": {
1401 "allowed": false
1402 }
1403 },
1404 "C++": {
1405 "format_on_save": "off",
1406 "use_on_type_format": false,
1407 "prettier": {
1408 "allowed": false
1409 }
1410 },
1411 "CSS": {
1412 "prettier": {
1413 "allowed": true
1414 }
1415 },
1416 "Dart": {
1417 "tab_size": 2
1418 },
1419 "Diff": {
1420 "show_edit_predictions": false,
1421 "remove_trailing_whitespace_on_save": false,
1422 "ensure_final_newline_on_save": false
1423 },
1424 "Elixir": {
1425 "language_servers": ["elixir-ls", "!next-ls", "!lexical", "..."]
1426 },
1427 "Elm": {
1428 "tab_size": 4
1429 },
1430 "Erlang": {
1431 "language_servers": ["erlang-ls", "!elp", "..."]
1432 },
1433 "Git Commit": {
1434 "allow_rewrap": "anywhere"
1435 },
1436 "Go": {
1437 "code_actions_on_format": {
1438 "source.organizeImports": true
1439 }
1440 },
1441 "GraphQL": {
1442 "prettier": {
1443 "allowed": true
1444 }
1445 },
1446 "HEEX": {
1447 "language_servers": ["elixir-ls", "!next-ls", "!lexical", "..."]
1448 },
1449 "HTML": {
1450 "prettier": {
1451 "allowed": true
1452 }
1453 },
1454 "Java": {
1455 "prettier": {
1456 "allowed": true,
1457 "plugins": ["prettier-plugin-java"]
1458 }
1459 },
1460 "JavaScript": {
1461 "language_servers": ["!typescript-language-server", "vtsls", "..."],
1462 "prettier": {
1463 "allowed": true
1464 }
1465 },
1466 "JSON": {
1467 "prettier": {
1468 "allowed": true
1469 }
1470 },
1471 "JSONC": {
1472 "prettier": {
1473 "allowed": true
1474 }
1475 },
1476 "LaTeX": {
1477 "format_on_save": "on",
1478 "formatter": "language_server",
1479 "language_servers": ["texlab", "..."],
1480 "prettier": {
1481 "allowed": false
1482 }
1483 },
1484 "Markdown": {
1485 "format_on_save": "off",
1486 "use_on_type_format": false,
1487 "allow_rewrap": "anywhere",
1488 "soft_wrap": "editor_width",
1489 "prettier": {
1490 "allowed": true
1491 }
1492 },
1493 "PHP": {
1494 "language_servers": ["phpactor", "!intelephense", "..."],
1495 "prettier": {
1496 "allowed": true,
1497 "plugins": ["@prettier/plugin-php"],
1498 "parser": "php"
1499 }
1500 },
1501 "Plain Text": {
1502 "allow_rewrap": "anywhere"
1503 },
1504 "Ruby": {
1505 "language_servers": ["solargraph", "!ruby-lsp", "!rubocop", "..."]
1506 },
1507 "SCSS": {
1508 "prettier": {
1509 "allowed": true
1510 }
1511 },
1512 "SQL": {
1513 "prettier": {
1514 "allowed": true,
1515 "plugins": ["prettier-plugin-sql"]
1516 }
1517 },
1518 "Starlark": {
1519 "language_servers": ["starpls", "!buck2-lsp", "..."]
1520 },
1521 "Svelte": {
1522 "language_servers": ["svelte-language-server", "..."],
1523 "prettier": {
1524 "allowed": true,
1525 "plugins": ["prettier-plugin-svelte"]
1526 }
1527 },
1528 "TSX": {
1529 "language_servers": ["!typescript-language-server", "vtsls", "..."],
1530 "prettier": {
1531 "allowed": true
1532 }
1533 },
1534 "Twig": {
1535 "prettier": {
1536 "allowed": true
1537 }
1538 },
1539 "TypeScript": {
1540 "language_servers": ["!typescript-language-server", "vtsls", "..."],
1541 "prettier": {
1542 "allowed": true
1543 }
1544 },
1545 "Vue.js": {
1546 "language_servers": ["vue-language-server", "..."],
1547 "prettier": {
1548 "allowed": true
1549 }
1550 },
1551 "XML": {
1552 "prettier": {
1553 "allowed": true,
1554 "plugins": ["@prettier/plugin-xml"]
1555 }
1556 },
1557 "YAML": {
1558 "prettier": {
1559 "allowed": true
1560 }
1561 },
1562 "Zig": {
1563 "language_servers": ["zls", "..."]
1564 }
1565 },
1566 // Different settings for specific language models.
1567 "language_models": {
1568 "anthropic": {
1569 "version": "1",
1570 "api_url": "https://api.anthropic.com"
1571 },
1572 "google": {
1573 "api_url": "https://generativelanguage.googleapis.com"
1574 },
1575 "ollama": {
1576 "api_url": "http://localhost:11434"
1577 },
1578 "openai": {
1579 "version": "1",
1580 "api_url": "https://api.openai.com/v1"
1581 },
1582 "lmstudio": {
1583 "api_url": "http://localhost:1234/api/v0"
1584 },
1585 "deepseek": {
1586 "api_url": "https://api.deepseek.com"
1587 },
1588 "mistral": {
1589 "api_url": "https://api.mistral.ai/v1"
1590 }
1591 },
1592 // Zed's Prettier integration settings.
1593 // Allows to enable/disable formatting with Prettier
1594 // and configure default Prettier, used when no project-level Prettier installation is found.
1595 "prettier": {
1596 // // Whether to consider prettier formatter or not when attempting to format a file.
1597 // "allowed": false,
1598 //
1599 // // Use regular Prettier json configuration.
1600 // // If Prettier is allowed, Zed will use this for its Prettier instance for any applicable file, if
1601 // // the project has no other Prettier installed.
1602 // "plugins": [],
1603 //
1604 // // Use regular Prettier json configuration.
1605 // // If Prettier is allowed, Zed will use this for its Prettier instance for any applicable file, if
1606 // // the project has no other Prettier installed.
1607 // "trailingComma": "es5",
1608 // "tabWidth": 4,
1609 // "semi": false,
1610 // "singleQuote": true
1611 },
1612 // Settings for auto-closing of JSX tags.
1613 "jsx_tag_auto_close": {
1614 "enabled": true
1615 },
1616 // LSP Specific settings.
1617 "lsp": {
1618 // Specify the LSP name as a key here.
1619 // "rust-analyzer": {
1620 // // A special flag for rust-analyzer integration, to use server-provided tasks
1621 // enable_lsp_tasks": true,
1622 // // These initialization options are merged into Zed's defaults
1623 // "initialization_options": {
1624 // "check": {
1625 // "command": "clippy" // rust-analyzer.check.command (default: "check")
1626 // }
1627 // }
1628 // }
1629 },
1630 // Jupyter settings
1631 "jupyter": {
1632 "enabled": true
1633 // Specify the language name as the key and the kernel name as the value.
1634 // "kernel_selections": {
1635 // "python": "conda-base"
1636 // "typescript": "deno"
1637 // }
1638 },
1639 // Vim settings
1640 "vim": {
1641 "default_mode": "normal",
1642 "toggle_relative_line_numbers": false,
1643 "use_system_clipboard": "always",
1644 "use_multiline_find": false,
1645 "use_smartcase_find": false,
1646 "highlight_on_yank_duration": 200,
1647 "custom_digraphs": {},
1648 // Cursor shape for the each mode.
1649 // Specify the mode as the key and the shape as the value.
1650 // The mode can be one of the following: "normal", "replace", "insert", "visual".
1651 // The shape can be one of the following: "block", "bar", "underline", "hollow".
1652 "cursor_shape": {}
1653 },
1654 // The server to connect to. If the environment variable
1655 // ZED_SERVER_URL is set, it will override this setting.
1656 "server_url": "https://zed.dev",
1657 // Settings overrides to use when using Zed Preview.
1658 // Mostly useful for developers who are managing multiple instances of Zed.
1659 "preview": {
1660 // "theme": "Andromeda"
1661 },
1662 // Settings overrides to use when using Zed Nightly.
1663 // Mostly useful for developers who are managing multiple instances of Zed.
1664 "nightly": {
1665 // "theme": "Andromeda"
1666 },
1667 // Settings overrides to use when using Zed Stable.
1668 // Mostly useful for developers who are managing multiple instances of Zed.
1669 "stable": {
1670 // "theme": "Andromeda"
1671 },
1672 // Settings overrides to use when using Zed Dev.
1673 // Mostly useful for developers who are managing multiple instances of Zed.
1674 "dev": {
1675 // "theme": "Andromeda"
1676 },
1677 // Whether to show full labels in line indicator or short ones
1678 //
1679 // Values:
1680 // - `short`: "2 s, 15 l, 32 c"
1681 // - `long`: "2 selections, 15 lines, 32 characters"
1682 // Default: long
1683 "line_indicator_format": "long",
1684 // Set a proxy to use. The proxy protocol is specified by the URI scheme.
1685 //
1686 // Supported URI scheme: `http`, `https`, `socks4`, `socks4a`, `socks5`,
1687 // `socks5h`. `http` will be used when no scheme is specified.
1688 //
1689 // By default no proxy will be used, or Zed will try get proxy settings from
1690 // environment variables.
1691 //
1692 // Examples:
1693 // - "proxy": "socks5h://localhost:10808"
1694 // - "proxy": "http://127.0.0.1:10809"
1695 "proxy": null,
1696 // Set to configure aliases for the command palette.
1697 // When typing a query which is a key of this object, the value will be used instead.
1698 //
1699 // Examples:
1700 // {
1701 // "W": "workspace::Save"
1702 // }
1703 "command_aliases": {},
1704 // ssh_connections is an array of ssh connections.
1705 // You can configure these from `project: Open Remote` in the command palette.
1706 // Zed's ssh support will pull configuration from your ~/.ssh too.
1707 // Examples:
1708 // [
1709 // {
1710 // "host": "example-box",
1711 // // "port": 22, "username": "test", "args": ["-i", "/home/user/.ssh/id_rsa"]
1712 // "projects": [
1713 // {
1714 // "paths": ["/home/user/code/zed"]
1715 // }
1716 // ]
1717 // }
1718 // ]
1719 "ssh_connections": [],
1720 // Whether to read ~/.ssh/config for ssh connection sources.
1721 "read_ssh_config": true,
1722 // Configures context servers for use by the agent.
1723 "context_servers": {},
1724 "debugger": {
1725 "stepping_granularity": "line",
1726 "save_breakpoints": true,
1727 "button": true
1728 }
1729}