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