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