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