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