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