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