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