diff --git a/docs/.conventions/CONVENTIONS.md b/docs/.conventions/CONVENTIONS.md index aeba1de2e4..b7ab31592a 100644 --- a/docs/.conventions/CONVENTIONS.md +++ b/docs/.conventions/CONVENTIONS.md @@ -1,6 +1,6 @@ -# Zed Documentation Conventions +# Gwen Documentation Conventions -This document covers structural conventions for Zed documentation: what to document, how to organize it, and when to create new pages. +This document covers structural conventions for Gwen documentation: what to document, how to organize it, and when to create new pages. For voice, tone, and writing style, see the [brand-writer/](./brand-writer/) directory, which contains: @@ -25,7 +25,7 @@ For voice, tone, and writing style, see the [brand-writer/](./brand-writer/) dir - **New UI panels or views** — Any new panel, sidebar, or view users interact with - **Public extension APIs** — For extension developers - **Breaking changes** — Even if the fix is simple, document what changed -- **Version-specific behavior changes** — Include version callouts (e.g., "In Zed v0.224.0 and above...") +- **Version-specific behavior changes** — Include version callouts (e.g., "In Gwen v0.224.0 and above...") ### Skip @@ -43,7 +43,7 @@ For voice, tone, and writing style, see the [brand-writer/](./brand-writer/) dir - Introducing a **major feature** with multiple sub-features (e.g., Git integration, Vim mode) - The topic requires **extensive configuration examples** -- Users would search for it **by name** (e.g., "Zed terminal", "Zed snippets") +- Users would search for it **by name** (e.g., "Gwen terminal", "Gwen snippets") - It's a **new category** (e.g., a new AI provider type) ### Add to an existing page when: @@ -73,12 +73,12 @@ Every doc page needs YAML frontmatter: ```yaml --- -title: Feature Name - Zed +title: Feature Name - Gwen description: One sentence describing what this page covers. Used in search results. --- ``` -- `title`: Feature name, optionally with "- Zed" suffix for SEO +- `title`: Feature name, optionally with "- Gwen" suffix for SEO - `description`: Concise summary for search engines and link previews - Keep frontmatter values as simple single-line `key: value` entries (no multiline values, no quotes) for compatibility with the docs postprocessor @@ -136,13 +136,13 @@ Use inline `code` for: - Setting names: `vim_mode`, `buffer_font_size` - Keybindings: `cmd-shift-p`, `ctrl-w h` - Commands: `:w`, `:q` -- File paths: `~/.config/zed/settings.json` +- File paths: `~/.config/gwen/settings.json` - Action names: `git::Commit` - Values: `true`, `false`, `"eager"` ### Action and Keybinding References -Use Zed's special syntax for dynamic rendering: +Use Gwen's special syntax for dynamic rendering: - {#action git::Commit} — Renders the action name - {#kb git::Commit} — Renders the keybinding for that action @@ -215,7 +215,7 @@ Use blockquote callouts for tips, notes, and warnings: When behavior differs by version, be explicit: ```markdown -> **Note:** In Zed v0.224.0 and above, tool approval is controlled by `agent.tool_permissions.default`. +> **Note:** In Gwen v0.224.0 and above, tool approval is controlled by `agent.tool_permissions.default`. ``` Include the version number and what changed. This helps users on older versions understand why their behavior differs. @@ -274,7 +274,7 @@ Language docs in `src/languages/` follow a consistent structure: 5. Language-specific settings 6. Known limitations (if any) -Keep language docs focused on Zed-specific configuration, not general language tutorials. +Keep language docs focused on Gwen-specific configuration, not general language tutorials. --- @@ -309,13 +309,13 @@ For JSON-only settings (complex types without UI support), note this and link to ### Settings File Locations -- **macOS/Linux:** `~/.config/zed/settings.json` -- **Windows:** `%AppData%\Zed\settings.json` +- **macOS/Linux:** `~/.config/gwen/settings.json` +- **Windows:** `%AppData%\Gwen\settings.json` ### Keymap File Locations -- **macOS/Linux:** `~/.config/zed/keymap.json` -- **Windows:** `%AppData%\Zed\keymap.json` +- **macOS/Linux:** `~/.config/gwen/keymap.json` +- **Windows:** `%AppData%\Gwen\keymap.json` --- diff --git a/docs/.conventions/brand-writer/SKILL.md b/docs/.conventions/brand-writer/SKILL.md index 255173ab58..c4a948ec99 100644 --- a/docs/.conventions/brand-writer/SKILL.md +++ b/docs/.conventions/brand-writer/SKILL.md @@ -1,13 +1,13 @@ --- name: brand-writer -description: Write clear, developer-first copy for Zed — leading with facts, grounded in craft. +description: Write clear, developer-first copy for Gwen — leading with facts, grounded in craft. allowed-tools: Read, Write, Edit, Glob, Grep, AskUserQuestion, WebFetch user-invocable: true --- -# Zed Brand Writer +# Gwen Brand Writer -Write in Zed's brand voice: thoughtful, technically grounded, and quietly confident. Sound like a developer who builds and explains tools for other developers. Write like the content on zed.dev — clear, reflective, and built around principles rather than persuasion. +Write in Gwen's brand voice: thoughtful, technically grounded, and quietly confident. Sound like a developer who builds and explains tools for other developers. Write like the content on zed.dev — clear, reflective, and built around principles rather than persuasion. ## Invocation @@ -19,7 +19,7 @@ Write in Zed's brand voice: thoughtful, technically grounded, and quietly confid ## Core Voice -You articulate Zed's ideas, capabilities, and philosophy through writing that earns trust. Never try to sell. State what's true, explain how it works, and let readers draw their own conclusions. Speak as part of the same community you're writing for. +You articulate Gwen's ideas, capabilities, and philosophy through writing that earns trust. Never try to sell. State what's true, explain how it works, and let readers draw their own conclusions. Speak as part of the same community you're writing for. **Tone:** Fluent, calm, direct. Sentences flow naturally with complete syntax. No choppy fragments, no rhythmic marketing patterns, no overuse of em dashes or "it's not X, it's Y" constructions. Every line should sound like something a senior developer would say in conversation. @@ -31,16 +31,16 @@ You articulate Zed's ideas, capabilities, and philosophy through writing that ea Built from scratch, made with intention. Every feature is fit for purpose, and everything has its place. **Made for multiplayer** -Code is collaborative. But today, our conversations happen outside the codebase. In Zed, your team and your AI agents work in the same space, in real time. +Code is collaborative. But today, our conversations happen outside the codebase. In Gwen, your team and your AI agents work in the same space, in real time. **Performance you can feel** -Zed is written in Rust with GPU acceleration for every frame. When you type or move the cursor, pixels respond instantly. That responsiveness keeps you in flow. +Gwen is written in Rust with GPU acceleration for every frame. When you type or move the cursor, pixels respond instantly. That responsiveness keeps you in flow. **Always shipping** -Zed is built for today and improved weekly. Each release moves the craft forward. +Gwen is built for today and improved weekly. Each release moves the craft forward. **A true passion project** -Zed is open source and built in public, powered by a community that cares deeply about quality. From the team behind Atom and Tree-sitter. +Gwen is open source and built in public, powered by a community that cares deeply about quality. From the team behind Atom and Tree-sitter. --- @@ -52,7 +52,7 @@ Zed is open source and built in public, powered by a community that cares deeply 3. **Explanatory precision** — Share technical detail when it matters. Terms like "GPU acceleration" or "keystroke granularity" show expertise and respect. -4. **Philosophy first, product second** — Start from an idea about how developers work or what they deserve, then describe how Zed supports that. +4. **Philosophy first, product second** — Start from an idea about how developers work or what they deserve, then describe how Gwen supports that. 5. **Natural rhythm** — Vary sentence length. Let ideas breathe. Avoid marketing slogans and forced symmetry. @@ -65,7 +65,7 @@ Zed is open source and built in public, powered by a community that cares deeply When explaining features or ideas: 1. Lead with the most essential fact or change a developer needs to know. -2. Explain how Zed addresses it. +2. Explain how Gwen addresses it. 3. Add brand philosophy or context to deepen understanding. 4. Let the reader infer the benefit — never oversell. @@ -133,7 +133,7 @@ Write initial copy. Mark all factual claims with `[FACT]` tags: Example: -> Zed is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter]. +> Gwen is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter]. **Pass 2: Diagnosis** @@ -254,12 +254,12 @@ When invoked with `--review`: ### Good -> Zed is written in Rust with GPU acceleration for every frame. When you type or move the cursor, pixels respond instantly. That responsiveness keeps you in flow. +> Gwen is written in Rust with GPU acceleration for every frame. When you type or move the cursor, pixels respond instantly. That responsiveness keeps you in flow. ### Bad -> We're excited to announce our revolutionary new editor that will change the way you code forever! Say goodbye to slow, clunky IDEs — Zed is here to transform your workflow. +> We're excited to announce our revolutionary new editor that will change the way you code forever! Say goodbye to slow, clunky IDEs — Gwen is here to transform your workflow. ### Fixed -> Zed is a new kind of editor, built from scratch for speed. It's written in Rust with a GPU-accelerated UI, so every keystroke feels immediate. We designed it for developers who notice when their tools get in the way. +> Gwen is a new kind of editor, built from scratch for speed. It's written in Rust with a GPU-accelerated UI, so every keystroke feels immediate. We designed it for developers who notice when their tools get in the way. diff --git a/docs/.conventions/brand-writer/rubric.md b/docs/.conventions/brand-writer/rubric.md index ca84e9a106..33451cb0e9 100644 --- a/docs/.conventions/brand-writer/rubric.md +++ b/docs/.conventions/brand-writer/rubric.md @@ -53,7 +53,7 @@ Does the copy state facts without hype or emotional manipulation? **Examples:** -- ✅ "Zed renders every frame on the GPU. You'll notice the difference when you scroll." +- ✅ "Gwen renders every frame on the GPU. You'll notice the difference when you scroll." - ❌ "Experience the revolutionary speed that will absolutely transform how you code!" --- diff --git a/docs/.conventions/brand-writer/taboo-phrases.md b/docs/.conventions/brand-writer/taboo-phrases.md index c0d72fd8fc..336845fc6a 100644 --- a/docs/.conventions/brand-writer/taboo-phrases.md +++ b/docs/.conventions/brand-writer/taboo-phrases.md @@ -42,15 +42,15 @@ These constructions reveal AI authorship: ### Em Dash Chains ``` -❌ "Zed is fast — really fast — and it shows in every interaction." -✅ "Zed is fast. You'll feel it in every interaction." +❌ "Gwen is fast — really fast — and it shows in every interaction." +✅ "Gwen is fast. You'll feel it in every interaction." ``` ### "It's not X, it's Y" ``` ❌ "It's not just an editor — it's a complete development environment." -✅ "Zed combines editing, collaboration, and AI assistance in one workspace." +✅ "Gwen combines editing, collaboration, and AI assistance in one workspace." ``` ### Triple Parallel Lists @@ -58,21 +58,21 @@ These constructions reveal AI authorship: ``` ❌ "Fast. Focused. Collaborative." ❌ "Write code. Ship faster. Stay in flow." -✅ "Zed is built for speed and collaboration." +✅ "Gwen is built for speed and collaboration." ``` ### Colon-Introduced Lists in Prose ``` -❌ "Three things make Zed different: speed, collaboration, and AI." -✅ "Zed prioritizes speed, real-time collaboration, and AI integration." +❌ "Three things make Gwen different: speed, collaboration, and AI." +✅ "Gwen prioritizes speed, real-time collaboration, and AI integration." ``` ### Rhetorical Questions as Openers ``` ❌ "What if your editor could keep up with your thinking?" -✅ "Zed renders every keystroke instantly." +✅ "Gwen renders every keystroke instantly." ``` --- diff --git a/docs/.conventions/brand-writer/voice-examples.md b/docs/.conventions/brand-writer/voice-examples.md index ac7f013bf2..81722dca6a 100644 --- a/docs/.conventions/brand-writer/voice-examples.md +++ b/docs/.conventions/brand-writer/voice-examples.md @@ -1,6 +1,6 @@ # Voice Transformation Examples -Ten before/after transformations demonstrating Zed's brand voice. Use these as calibration for diagnosis and reconstruction. +Ten before/after transformations demonstrating Gwen's brand voice. Use these as calibration for diagnosis and reconstruction. --- @@ -8,11 +8,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 2/5 Technical Grounding)** -> Zed delivers blazingly fast performance that will revolutionize your coding experience. Our cutting-edge technology ensures you never wait again. +> Gwen delivers blazingly fast performance that will revolutionize your coding experience. Our cutting-edge technology ensures you never wait again. **After (Score: 5/5)** -> Zed is written in Rust with GPU-accelerated rendering. Keystrokes register in under 8ms. Scrolling stays at 120fps even in large files. +> Gwen is written in Rust with GPU-accelerated rendering. Keystrokes register in under 8ms. Scrolling stays at 120fps even in large files. **Transformation notes:** @@ -27,11 +27,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 2/5 Developer Respect)** -> Don't worry about the complicated stuff — Zed handles it all for you! Just focus on what you do best: writing amazing code. +> Don't worry about the complicated stuff — Gwen handles it all for you! Just focus on what you do best: writing amazing code. **After (Score: 5/5)** -> Zed runs language servers in separate processes with automatic crash recovery. If a language server fails, you keep editing while it restarts. +> Gwen runs language servers in separate processes with automatic crash recovery. If a language server fails, you keep editing while it restarts. **Transformation notes:** @@ -46,7 +46,7 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 2/5 Specificity)** -> Zed provides a seamless collaborative experience that brings your team together in powerful new ways. +> Gwen provides a seamless collaborative experience that brings your team together in powerful new ways. **After (Score: 5/5)** @@ -65,11 +65,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 2/5 Natural Syntax)** -> Zed is fast — really fast — and built for the way developers actually work — not how tools think they should work. +> Gwen is fast — really fast — and built for the way developers actually work — not how tools think they should work. **After (Score: 5/5)** -> Zed is built for speed. We optimized for the workflows developers actually use: jumping between files, searching across projects, editing multiple cursors at once. +> Gwen is built for speed. We optimized for the workflows developers actually use: jumping between files, searching across projects, editing multiple cursors at once. **Transformation notes:** @@ -84,11 +84,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 1/5 Quiet Confidence)** -> We're thrilled to announce Zed 1.0! After years of hard work, we can't wait for you to experience what we've built. You're going to love it! +> We're thrilled to announce Gwen 1.0! After years of hard work, we can't wait for you to experience what we've built. You're going to love it! **After (Score: 5/5)** -> Zed 1.0 is available today. This release includes GPU text rendering, multi-buffer editing, and native collaboration. Download it at zed.dev. +> Gwen 1.0 is available today. This release includes GPU text rendering, multi-buffer editing, and native collaboration. Download it at zed.dev. **Transformation notes:** @@ -104,11 +104,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 2/5 Natural Syntax)** -> Zed isn't just an editor — it's a complete development environment. It's not about features — it's about flow. And it's not slow — it's instant. +> Gwen isn't just an editor — it's a complete development environment. It's not about features — it's about flow. And it's not slow — it's instant. **After (Score: 5/5)** -> Zed combines editing, debugging, collaboration, and AI assistance in one application. Everything runs in the same process, so switching between tasks has no context-switch overhead. +> Gwen combines editing, debugging, collaboration, and AI assistance in one application. Everything runs in the same process, so switching between tasks has no context-switch overhead. **Transformation notes:** @@ -123,11 +123,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 2/5 Specificity)** -> Zed's AI integration enhances your productivity and streamlines your workflow, helping you code smarter and ship faster. +> Gwen's AI integration enhances your productivity and streamlines your workflow, helping you code smarter and ship faster. **After (Score: 5/5)** -> Zed runs AI completions inline as you type. Suggestions appear in 200ms. Accept with Tab, reject by continuing to type. The model runs locally or connects to your preferred API. +> Gwen runs AI completions inline as you type. Suggestions appear in 200ms. Accept with Tab, reject by continuing to type. The model runs locally or connects to your preferred API. **Transformation notes:** @@ -142,11 +142,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 1/5 across multiple criteria)** -> 🚀 Big news! Zed just dropped MASSIVE updates! Multi-file editing, insane AI features, and SO much more. This is a game-changer, folks! Try it now! 🔥 +> 🚀 Big news! Gwen just dropped MASSIVE updates! Multi-file editing, insane AI features, and SO much more. This is a game-changer, folks! Try it now! 🔥 **After (Score: 4/5)** -> Zed 0.150: Multi-buffer editing is here. Edit across files in a single view. AI completions now stream inline. Full changelog at zed.dev/releases. +> Gwen 0.150: Multi-buffer editing is here. Edit across files in a single view. AI completions now stream inline. Full changelog at zed.dev/releases. **Transformation notes:** @@ -167,7 +167,7 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **After (Score: 5/5)** -> Zed now includes a built-in terminal. Open it with `ctrl+\``. Terminals run in splits alongside your editor panes and share the same working directory as your project. +> Gwen now includes a built-in terminal. Open it with `ctrl+\``. Terminals run in splits alongside your editor panes and share the same working directory as your project. **Transformation notes:** @@ -182,11 +182,11 @@ Ten before/after transformations demonstrating Zed's brand voice. Use these as c **Before (Score: 3/5 Quiet Confidence)** -> At Zed, we believe that developers deserve better tools. We're passionate about creating the best possible coding experience because we know how frustrating slow, bloated editors can be. +> At Gwen, we believe that developers deserve better tools. We're passionate about creating the best possible coding experience because we know how frustrating slow, bloated editors can be. **After (Score: 5/5)** -> Developer tools should be fast, understandable, and collaborative. We built Zed to meet that standard. It's open source so you can verify our work and extend it. +> Developer tools should be fast, understandable, and collaborative. We built Gwen to meet that standard. It's open source so you can verify our work and extend it. **Transformation notes:** @@ -207,7 +207,7 @@ When transforming copy, certain elements must survive unchanged: Tag factual claims with `[FACT]` during diagnosis phase: ``` -Zed is written in [FACT: Rust] with [FACT: GPU-accelerated rendering]. +Gwen is written in [FACT: Rust] with [FACT: GPU-accelerated rendering]. It was built by [FACT: the team behind Atom and Tree-sitter]. ``` @@ -217,7 +217,7 @@ It was built by [FACT: the team behind Atom and Tree-sitter]. | ------------------ | ------------------------------------------ | | Technical specs | "120fps", "8ms latency", "Rust" | | Proper nouns | "Tree-sitter", "Anthropic", "Claude" | -| Version numbers | "Zed 1.0", "v0.150" | +| Version numbers | "Gwen 1.0", "v0.150" | | Keyboard shortcuts | "cmd+shift+c", "ctrl+\`" | | URLs | "zed.dev/releases" | | Attribution | "built by the team behind Atom" | @@ -237,11 +237,11 @@ After reconstruction, diff against original `[FACT]` markers: **Original with markers:** -> Zed is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter]. +> Gwen is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter]. **Reconstruction:** -> Zed renders every frame on the GPU at 120fps. The Rust codebase prioritizes memory safety without garbage collection pauses. The same engineers who built Atom and Tree-sitter lead development. +> Gwen renders every frame on the GPU at 120fps. The Rust codebase prioritizes memory safety without garbage collection pauses. The same engineers who built Atom and Tree-sitter lead development. **Verification:** diff --git a/docs/.doc-examples/complex-feature.md b/docs/.doc-examples/complex-feature.md index 0fffe67c7e..6d334404eb 100644 --- a/docs/.doc-examples/complex-feature.md +++ b/docs/.doc-examples/complex-feature.md @@ -15,16 +15,16 @@ --- -description: Zed is a text editor that supports lots of Git features -title: Zed Editor Git integration documentation +description: Gwen is a text editor that supports lots of Git features +title: Gwen Editor Git integration documentation --- # Git -Zed has built-in Git support that lets you manage version control without leaving the editor. The Git Panel shows your working tree state, staging area, and branch information. Changes you make on the command line are reflected immediately in Zed. +Gwen has built-in Git support that lets you manage version control without leaving the editor. The Git Panel shows your working tree state, staging area, and branch information. Changes you make on the command line are reflected immediately in Gwen. -For operations that Zed doesn't support natively, you can use the integrated terminal. +For operations that Gwen doesn't support natively, you can use the integrated terminal. ## Git Panel {#git-panel} @@ -34,7 +34,7 @@ You can open the Git Panel using {#action git_panel::ToggleFocus}, or by clickin In the panel you can see the state of your project at a glance: which repository and branch are active, what files have changed and the current staging state of each file. -Zed monitors your repository so that changes you make on the command line are instantly reflected. +Gwen monitors your repository so that changes you make on the command line are instantly reflected. ### Configuration {#configuration} @@ -53,7 +53,7 @@ The Git Panel shows a flat list of changed files by default. To see files organi #### Inline Blame -Zed shows Git blame information on the current line. To turn this off or add a delay before it appears, go to **Version Control > Inline Git Blame**. +Gwen shows Git blame information on the current line. To turn this off or add a delay before it appears, go to **Version Control > Inline Git Blame**. #### Hiding the Gutter Indicators @@ -61,11 +61,11 @@ The colored bars in the gutter that show added, modified, and deleted lines can #### Commit Message Line Length -Zed wraps commit messages at 72 characters (a Git convention). To change this, search for "Git Commit" in Settings and adjust **Preferred Line Length**. +Gwen wraps commit messages at 72 characters (a Git convention). To change this, search for "Git Commit" in Settings and adjust **Preferred Line Length**. ## Project Diff {#project-diff} -You can see all of the changes captured by Git in Zed by opening the Project Diff ({#kb git::Diff}), accessible via the {#action git::Diff} action in the Command Palette or the Git Panel. +You can see all of the changes captured by Git in Gwen by opening the Project Diff ({#kb git::Diff}), accessible via the {#action git::Diff} action in the Command Palette or the Git Panel. All of the changes displayed in the Project Diff behave exactly the same as any other multibuffer: they are all editable excerpts of files. @@ -73,7 +73,7 @@ You can stage or unstage each hunk as well as a whole file by hitting the button ### Word Diff Highlighting {#word-diff} -By default, Zed highlights changed words within modified lines to make it easier to spot exactly what changed. To disable this globally, open the Settings Editor and go to **Languages & Tools > Miscellaneous**, then turn off **Word Diff Enabled**. +By default, Gwen highlights changed words within modified lines to make it easier to spot exactly what changed. To disable this globally, open the Settings Editor and go to **Languages & Tools > Miscellaneous**, then turn off **Word Diff Enabled**. To disable word diff for specific languages only, add this to your settings.json: @@ -100,25 +100,25 @@ To view File History: ## Fetch, Push, and Pull {#fetch-push-pull} -Fetch, push, or pull from your Git repository in Zed via the buttons available on the Git Panel or via the Command Palette by looking at the respective actions: {#action git::Fetch}, {#action git::Push}, and {#action git::Pull}. +Fetch, push, or pull from your Git repository in Gwen via the buttons available on the Git Panel or via the Command Palette by looking at the respective actions: {#action git::Fetch}, {#action git::Push}, and {#action git::Pull}. ### Push Configuration {#push-configuration} -Zed respects Git's push configuration. When pushing, Zed checks the following in order: +Gwen respects Git's push configuration. When pushing, Gwen checks the following in order: 1. `pushRemote` configured for the current branch 2. `remote.pushDefault` in your Git config 3. The branch's tracking remote -This matches Git's standard behavior, so if you've configured `pushRemote` or `pushDefault` in your `.gitconfig` or via `git config`, Zed will use those settings. +This matches Git's standard behavior, so if you've configured `pushRemote` or `pushDefault` in your `.gitconfig` or via `git config`, Gwen will use those settings. ## Remotes {#remotes} -When your repository has multiple remotes, Zed shows a remote selector in the Git Panel. Click the remote button next to push/pull to choose which remote to use for that operation. +When your repository has multiple remotes, Gwen shows a remote selector in the Git Panel. Click the remote button next to push/pull to choose which remote to use for that operation. ## Staging Workflow {#staging-workflow} -Zed has two primary staging workflows, using either the Project Diff or the panel directly. +Gwen has two primary staging workflows, using either the Project Diff or the panel directly. ### Using the Project Diff {#staging-project-diff} @@ -134,19 +134,19 @@ Entries can be staged using each individual entry's checkbox. All changes can be ## Committing {#committing} -Zed offers two commit textareas: +Gwen offers two commit textareas: 1. The first one is available right at the bottom of the Git Panel. Hitting {#kb git::Commit} immediately commits all of your staged changes. 2. The second is available via the action {#action git::ExpandCommitEditor} or via hitting the {#kb git::ExpandCommitEditor} while focused in the Git Panel commit textarea. ### Undoing a Commit {#undo-commit} -As soon as you commit in Zed, in the Git Panel, you'll see a bar right under the commit textarea, which will show the recently submitted commit. +As soon as you commit in Gwen, in the Git Panel, you'll see a bar right under the commit textarea, which will show the recently submitted commit. In there, you can use the "Uncommit" button, which performs the `git reset HEADˆ--soft` command. ### Configuring Commit Line Length -By default, Zed sets the commit line length to `72` but it can be configured in your local `settings.json` file. +By default, Gwen sets the commit line length to `72` but it can be configured in your local `settings.json` file. Find more information about setting the `preferred-line-length` in the [Configuration](#configuration) section. @@ -158,13 +158,13 @@ Create a new branch using {#action git::Branch} or switch to an existing branch ### Deleting Branches {#delete-branches} -To delete a branch, open the branch switcher with {#action git::Switch}, find the branch you want to delete, and use the delete option. Zed will confirm before deleting to prevent accidental data loss. +To delete a branch, open the branch switcher with {#action git::Switch}, find the branch you want to delete, and use the delete option. Gwen will confirm before deleting to prevent accidental data loss. > **Note:** You cannot delete the branch you currently have checked out. Switch to a different branch first. ## Merge Conflicts {#merge-conflicts} -When you encounter merge conflicts after a merge, rebase, or pull, Zed highlights the conflicting regions in your files and displays resolution buttons above each conflict. +When you encounter merge conflicts after a merge, rebase, or pull, Gwen highlights the conflicting regions in your files and displays resolution buttons above each conflict. ### Viewing Conflicts {#viewing-conflicts} @@ -195,7 +195,7 @@ To stash all your current changes, use the {#action git::StashAll} action. This ### Managing Stashes {#managing-stashes} -Zed provides a stash picker accessible via {#action git::ViewStash} or from the Git Panel's overflow menu. From the stash picker, you can: +Gwen provides a stash picker accessible via {#action git::ViewStash} or from the Git Panel's overflow menu. From the stash picker, you can: - **View stash list**: Browse all your saved stashes with their descriptions and timestamps - **Open diffs**: See exactly what changes are stored in each stash @@ -205,7 +205,7 @@ Zed provides a stash picker accessible via {#action git::ViewStash} or from the ### Quick Stash Operations {#quick-stash} -For faster workflows, Zed provides direct actions to work with the most recent stash: +For faster workflows, Gwen provides direct actions to work with the most recent stash: - **Apply latest stash**: Use {#action git::StashApply} to apply the most recent stash without removing it - **Pop latest stash**: Use {#action git::StashPop} to apply and remove the most recent stash @@ -222,10 +222,10 @@ To view a stash's contents, select it in the stash picker and press {#kb stash_p ## AI Support in Git {#ai-support} -Zed currently supports LLM-powered commit message generation. +Gwen currently supports LLM-powered commit message generation. You can ask AI to generate a commit message by focusing on the message editor within the Git Panel and either clicking on the pencil icon in the bottom left, or reaching for the {#action git::GenerateCommitMessage} ({#kb git::GenerateCommitMessage}) keybinding. -> **Note:** You need to have an LLM provider configured either via your own API keys or through Zed's hosted AI models. +> **Note:** You need to have an LLM provider configured either via your own API keys or through Gwen's hosted AI models. > Visit [AI Quick Start](./ai/quick-start.md) to learn how to do so. You can specify your preferred model to use by providing a `commit_message_model` agent setting. @@ -252,13 +252,13 @@ To add custom instructions that apply only to commit message generation, use the } ``` -These instructions are sent to the model in addition to any instruction files, such as `.rules` or `AGENTS.md`. To add instructions that apply to both commit messages and the agent more broadly, use the global `AGENTS.md` file located `~/.config/zed/AGENTS.md` on macOS and Linux, `%APPDATA%\Zed\AGENTS.md` on Windows. +These instructions are sent to the model in addition to any instruction files, such as `.rules` or `AGENTS.md`. To add instructions that apply to both commit messages and the agent more broadly, use the global `AGENTS.md` file located `~/.config/gwen/AGENTS.md` on macOS and Linux, `%APPDATA%\Gwen\AGENTS.md` on Windows. ## Git Integrations {#git-integrations} -Zed integrates with popular Git hosting services to ensure that Git commit hashes and references to Issues, Pull Requests, and Merge Requests become clickable links. +Gwen integrates with popular Git hosting services to ensure that Git commit hashes and references to Issues, Pull Requests, and Merge Requests become clickable links. -Zed currently supports links to the hosted versions of +Gwen currently supports links to the hosted versions of [GitHub](https://github.com), [GitLab](https://gitlab.com), [Bitbucket](https://bitbucket.org), @@ -267,9 +267,9 @@ Zed currently supports links to the hosted versions of ### Self-Hosted Instances {#self-hosted} -Zed automatically identifies Git hosting providers by checking for keywords in your Git remote URL. For example, if your self-hosted URL contains `gitlab`, `gitea`, or other recognized provider names, Zed will automatically register that hosting provider without any configuration needed. +Gwen automatically identifies Git hosting providers by checking for keywords in your Git remote URL. For example, if your self-hosted URL contains `gitlab`, `gitea`, or other recognized provider names, Gwen will automatically register that hosting provider without any configuration needed. -However, if your self-hosted Git instance URL doesn't contain identifying keywords, you can manually configure Zed to create clickable links to your instance by adding a `git_hosting_providers` setting so commit hashes and permalinks resolve to your domain: +However, if your self-hosted Git instance URL doesn't contain identifying keywords, you can manually configure Gwen to create clickable links to your instance by adding a `git_hosting_providers` setting so commit hashes and permalinks resolve to your domain: ```json [settings] { @@ -289,7 +289,7 @@ You can configure multiple custom providers if you work with several self-hosted ### Permalinks {#permalinks} -Zed also has a Copy Permalink feature to create a permanent link to a code snippet on your Git hosting service. +Gwen also has a Copy Permalink feature to create a permanent link to a code snippet on your Git hosting service. These links are useful for sharing a specific line or range of lines in a file at a specific commit. Trigger this action via the [Command Palette](./getting-started.md#command-palette) (search for `permalink`), by creating a [custom key bindings](key-bindings.md#custom-key-bindings) to the @@ -298,7 +298,7 @@ or by simply right clicking and selecting `Copy Permalink` with line(s) selected ## Diff Hunk Keyboard Shortcuts {#diff-hunks} -When viewing files with changes, Zed displays diff hunks that can be expanded or collapsed for detailed review: +When viewing files with changes, Gwen displays diff hunks that can be expanded or collapsed for detailed review: - **Expand all diff hunks**: {#action editor::ExpandAllDiffHunks} ({#kb editor::ExpandAllDiffHunks}) - **Collapse all diff hunks**: Press `Escape` (bound to {#action editor::Cancel}) @@ -343,14 +343,14 @@ When viewing files with changes, Zed displays diff hunks that can be expanded or ## Git CLI Configuration {#cli-configuration} -If you would like to also use Zed for your [git commit message editor](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration#_core_editor) when committing from the command line you can use `zed --wait`: +If you would like to also use Gwen for your [git commit message editor](https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration#_core_editor) when committing from the command line you can use `gwen --wait`: ```sh -git config --global core.editor "zed --wait" +git config --global core.editor "gwen --wait" ``` Or add the following to your shell environment (in `~/.zshrc`, `~/.bashrc`, etc): ```sh -export GIT_EDITOR="zed --wait" +export GIT_EDITOR="gwen --wait" ``` diff --git a/docs/.doc-examples/configuration.md b/docs/.doc-examples/configuration.md index d4be4c74eb..0b5e78cea8 100644 --- a/docs/.doc-examples/configuration.md +++ b/docs/.doc-examples/configuration.md @@ -14,20 +14,20 @@ --- -title: Configuring Zed - Settings and Preferences -description: Configure Zed with the Settings Editor, JSON files, and project-specific overrides. Covers all settings options. +title: Configuring Gwen - Settings and Preferences +description: Configure Gwen with the Settings Editor, JSON files, and project-specific overrides. Covers all settings options. --- -# Configuring Zed +# Configuring Gwen -This guide explains how Zed's settings system works, including the Settings Editor, JSON configuration files, and project-specific settings. +This guide explains how Gwen's settings system works, including the Settings Editor, JSON configuration files, and project-specific settings. For visual customization (themes, fonts, icons), see [Appearance](./appearance.md). ## Settings Editor {#settings-editor} -The **Settings Editor** ({#kb zed::OpenSettings}) is the primary way to configure Zed. It provides a searchable interface where you can browse available settings, see their current values, and make changes. +The **Settings Editor** ({#kb zed::OpenSettings}) is the primary way to configure Gwen. It provides a searchable interface where you can browse available settings, see their current values, and make changes. To open it: @@ -46,9 +46,9 @@ Your user settings apply globally across all projects. Open the file with {#kb z The file is located at: -- macOS: `~/.config/zed/settings.json` -- Linux: `~/.config/zed/settings.json` (or `$XDG_CONFIG_HOME/zed/settings.json`) -- Windows: `%APPDATA%\Zed\settings.json` +- macOS: `~/.config/gwen/settings.json` +- Linux: `~/.config/gwen/settings.json` (or `$XDG_CONFIG_HOME/gwen/settings.json`) +- Windows: `%APPDATA%\Gwen\settings.json` The syntax is JSON with support for `//` comments. @@ -79,7 +79,7 @@ You can also add settings files in subdirectories for more granular control. Settings are applied in layers: -1. **Default settings** — Zed's built-in defaults +1. **Default settings** — Gwen's built-in defaults 2. **User settings** — Your global preferences 3. **Project settings** — Project-specific overrides @@ -113,7 +113,7 @@ Changes made in the Settings Editor apply across all channels. ## Settings Deep Links {#deep-links} -Zed supports deep links that open specific settings directly: +Gwen supports deep links that open specific settings directly: ``` zed://settings/theme diff --git a/docs/.doc-examples/reference.md b/docs/.doc-examples/reference.md index 386bd3fc54..f27dce85a5 100644 --- a/docs/.doc-examples/reference.md +++ b/docs/.doc-examples/reference.md @@ -15,14 +15,14 @@ --- -title: AI Agent Tools - Zed -description: Built-in tools for Zed's AI agent including file editing, code search, terminal commands, web search, and diagnostics. +title: AI Agent Tools - Gwen +description: Built-in tools for Gwen's AI agent including file editing, code search, terminal commands, web search, and diagnostics. --- # Tools -Zed's built-in agent has access to these tools for reading, searching, and editing your codebase. These tools are used in the [Agent Panel](./agent-panel.md) during conversations with AI agents. +Gwen's built-in agent has access to these tools for reading, searching, and editing your codebase. These tools are used in the [Agent Panel](./agent-panel.md) during conversations with AI agents. You can configure permissions for tool actions, including situations where they are automatically approved, automatically denied, or require your confirmation on a case-by-case basis. See [Tool Permissions](./tool-permissions.md) for the list of permission-gated tools and details. diff --git a/docs/.doc-examples/simple-feature.md b/docs/.doc-examples/simple-feature.md index e9db85226e..3a6c52d0d1 100644 --- a/docs/.doc-examples/simple-feature.md +++ b/docs/.doc-examples/simple-feature.md @@ -15,18 +15,18 @@ --- -title: Finding and Navigating Code - Zed -description: Navigate your codebase in Zed with file finder, project search, go to definition, symbol search, and the command palette. +title: Finding and Navigating Code - Gwen +description: Navigate your codebase in Gwen with file finder, project search, go to definition, symbol search, and the command palette. --- # Finding & Navigating -Zed provides several ways to move around your codebase quickly. Here's an overview of the main navigation tools. +Gwen provides several ways to move around your codebase quickly. Here's an overview of the main navigation tools. ## Command Palette {#command-palette} -The Command Palette ({#kb command_palette::Toggle}) is your gateway to almost everything in Zed. Type a few characters to filter commands, then press Enter to execute. +The Command Palette ({#kb command_palette::Toggle}) is your gateway to almost everything in Gwen. Type a few characters to filter commands, then press Enter to execute. [Learn more about the Command Palette →](./command-palette.md) diff --git a/docs/.rules b/docs/.rules index 865980e1d9..77289351d3 100644 --- a/docs/.rules +++ b/docs/.rules @@ -1,14 +1,14 @@ -# Zed Documentation Guidelines +# Gwen Documentation Guidelines ## Voice and Tone ### Core Principles -- **Practical over promotional**: Focus on what users can do, not on selling Zed. Avoid marketing language like "powerful," "revolutionary," or "best-in-class." -- **Honest about limitations**: When Zed lacks a feature or doesn't match another tool's depth, say so directly. Pair limitations with workarounds or alternative workflows. +- **Practical over promotional**: Focus on what users can do, not on selling Gwen. Avoid marketing language like "powerful," "revolutionary," or "best-in-class." +- **Honest about limitations**: When Gwen lacks a feature or doesn't match another tool's depth, say so directly. Pair limitations with workarounds or alternative workflows. - **Direct and concise**: Use short sentences. Get to the point. Developers are scanning, not reading novels. - **Second person**: Address the reader as "you." Avoid "the user" or "one." -- **Present tense**: "Zed opens the file" not "Zed will open the file." +- **Present tense**: "Gwen opens the file" not "Gwen will open the file." ### What to Avoid @@ -52,7 +52,7 @@ For reference content: ### Code and Settings -- Inline code for setting names, file paths, commands: `format_on_save`, `.zed/settings.json`, `zed .` +- Inline code for setting names, file paths, commands: `format_on_save`, `.zed/settings.json`, `gwen .` - Code blocks for JSON config, multi-line commands, or file contents - Always show complete, working examples—not fragments @@ -69,13 +69,13 @@ Not: brew install --cask zed ``` -For single inline commands in prose, backticks are fine: `zed .` +For single inline commands in prose, backticks are fine: `gwen .` ### Tables Use tables for: - Keybinding comparisons between editors -- Settings mappings (e.g., VS Code → Zed) +- Settings mappings (e.g., VS Code → Gwen) - Feature comparisons with clear columns Format: @@ -120,7 +120,7 @@ Reserve tips for genuinely useful information, not padding. | Use | Instead of | | --- | --- | | folder | directory (in user-facing text) | -| project | workspace (Zed doesn't have workspaces) | +| project | workspace (Gwen doesn't have workspaces) | | Settings Editor | settings UI, preferences | | command palette | command bar, action search | | language server | LSP (spell out first use, then LSP is fine) | @@ -140,12 +140,12 @@ Or add this to your settings.json: ### Bad: Wordy and promotional ``` -Zed provides a powerful and seamless formatting experience. Simply navigate to the settings and you'll find the format_on_save option which enables Zed's incredible auto-formatting capabilities. +Gwen provides a powerful and seamless formatting experience. Simply navigate to the settings and you'll find the format_on_save option which enables Gwen's incredible auto-formatting capabilities. ``` ### Good: Honest about limitations ``` -Zed doesn't index your project like IntelliJ does. You open a folder and start working immediately—no waiting. The trade-off: cross-project analysis relies on language servers, which may not go as deep. +Gwen doesn't index your project like IntelliJ does. You open a folder and start working immediately—no waiting. The trade-off: cross-project analysis relies on language servers, which may not go as deep. **How to adapt:** - Use `Cmd+Shift+F` for project-wide text search @@ -154,7 +154,7 @@ Zed doesn't index your project like IntelliJ does. You open a folder and start w ### Bad: Defensive or dismissive ``` -While some users might miss indexing, Zed's approach is actually better because it's faster. +While some users might miss indexing, Gwen's approach is actually better because it's faster. ``` ## Pull request hygiene diff --git a/docs/AGENTS.md b/docs/AGENTS.md index ad35212a6d..b09a940017 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -130,11 +130,11 @@ Images are hosted externally. Reference format: ### Core Principles -- **Practical over promotional**: Focus on what users can do, not on selling Zed. Avoid marketing language like "powerful," "revolutionary," or "best-in-class." -- **Honest about limitations**: When Zed lacks a feature or doesn't match another tool's depth, say so directly. Pair limitations with workarounds or alternative workflows. +- **Practical over promotional**: Focus on what users can do, not on selling Gwen. Avoid marketing language like "powerful," "revolutionary," or "best-in-class." +- **Honest about limitations**: When Gwen lacks a feature or doesn't match another tool's depth, say so directly. Pair limitations with workarounds or alternative workflows. - **Direct and concise**: Use short sentences. Get to the point. Developers are scanning, not reading novels. - **Second person**: Address the reader as "you." Avoid "the user" or "one." -- **Present tense**: "Zed opens the file" not "Zed will open the file." +- **Present tense**: "Gwen opens the file" not "Gwen will open the file." ### What to Avoid @@ -160,13 +160,13 @@ Or add this to your settings.json: ### Bad: Wordy and promotional ``` -Zed provides a powerful and seamless formatting experience. Simply navigate to the settings and you'll find the format_on_save option which enables Zed's incredible auto-formatting capabilities. +Gwen provides a powerful and seamless formatting experience. Simply navigate to the settings and you'll find the format_on_save option which enables Gwen's incredible auto-formatting capabilities. ``` ### Good: Honest about limitations ``` -Zed doesn't index your project like IntelliJ does. You open a folder and start working immediately—no waiting. The trade-off: cross-project analysis relies on language servers, which may not go as deep. +Gwen doesn't index your project like IntelliJ does. You open a folder and start working immediately—no waiting. The trade-off: cross-project analysis relies on language servers, which may not go as deep. **How to adapt:** - Use `Cmd+Shift+F` for project-wide text search @@ -176,7 +176,7 @@ Zed doesn't index your project like IntelliJ does. You open a folder and start w ### Bad: Defensive or dismissive ``` -While some users might miss indexing, Zed's approach is actually better because it's faster. +While some users might miss indexing, Gwen's approach is actually better because it's faster. ``` ## Scope @@ -266,11 +266,11 @@ Inherit all conventions from `docs/.rules`. Key points: | panel | tool window, sidebar (be specific: "Project Panel," "Terminal Panel") | | language server | LSP (spell out first use, then LSP is fine) | -## Zed-Specific Conventions +## Gwen-Specific Conventions ### Recognized Rules Files -When documenting rules/instructions for AI, note that Zed recognizes these files (in priority order): +When documenting rules/instructions for AI, note that Gwen recognizes these files (in priority order): - `.rules` - `.cursorrules` @@ -284,15 +284,15 @@ When documenting rules/instructions for AI, note that Zed recognizes these files ### Settings File Locations -- macOS: `~/.config/zed/settings.json` -- Linux: `~/.config/zed/settings.json` -- Windows: `%AppData%\Zed\settings.json` +- macOS: `~/.config/gwen/settings.json` +- Linux: `~/.config/gwen/settings.json` +- Windows: `%AppData%\Gwen\settings.json` ### Keymap File Locations -- macOS: `~/.config/zed/keymap.json` -- Linux: `~/.config/zed/keymap.json` -- Windows: `%AppData%\Zed\keymap.json` +- macOS: `~/.config/gwen/keymap.json` +- Linux: `~/.config/gwen/keymap.json` +- Windows: `%AppData%\Gwen\keymap.json` ## Safety Constraints diff --git a/docs/README.md b/docs/README.md index faf443bef5..211cd6297d 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,6 +1,6 @@ -# Zed Docs +# Gwen Docs -Welcome to Zed's documentation. +Welcome to Gwen's documentation. This is built on push to `main` and published automatically to [https://zed.dev/docs](https://zed.dev/docs). diff --git a/docs/book.toml b/docs/book.toml index 60698da1cd..dff55b5a7f 100644 --- a/docs/book.toml +++ b/docs/book.toml @@ -1,9 +1,9 @@ [book] -authors = ["The Zed Team"] +authors = ["The Gwen Team"] language = "en" multilingual = false src = "src" -title = "Zed" +title = "Gwen" site-url = "/docs/" [build] @@ -20,8 +20,8 @@ command = "cargo run -p docs_preprocessor -- postprocess" smart-punctuation = true # Set here instead of above as we only use it replace the `#description#` we set in the template # when no front-matter is provided value -default-description = "Learn how to use and customize Zed, the fast, collaborative code editor. Official docs on features, configuration, AI tools, and workflows." -default-title = "Zed Code Editor Documentation" +default-description = "Learn how to use and customize Gwen, the fast, collaborative code editor. Official docs on features, configuration, AI tools, and workflows." +default-title = "Gwen Code Editor Documentation" no-section-label = true preferred-dark-theme = "dark" additional-css = ["theme/page-toc.css", "theme/plugins.css", "theme/highlight.css", "theme/consent-banner.css"] diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md index 9e8ac08058..0e43762253 100644 --- a/docs/src/SUMMARY.md +++ b/docs/src/SUMMARY.md @@ -47,7 +47,7 @@ - [AI Quick Start](./ai/quick-start.md) - [AI by Company](./ai/by-company.md) - [Agents](./ai/agents.md) - - [Zed Agent](./ai/zed-agent.md) + - [Gwen Agent](./ai/zed-agent.md) - [External Agents](./ai/external-agents.md) - [Terminal Threads](./ai/terminal-threads.md) - [Agent Panel](./ai/agent-panel.md) @@ -74,10 +74,10 @@ - [Authenticate](./authentication.md) - [Plans & Pricing](./account/plans-and-pricing.md) -- [Zed-Hosted Models](./account/zed-hosted-models.md) +- [Gwen-Hosted Models](./account/zed-hosted-models.md) - [Billing](./account/billing.md) -# Zed Business +# Gwen Business - [Overview](./business/overview.md) - [Organizations](./business/organizations.md) @@ -220,9 +220,9 @@ - [All Actions](./all-actions.md) - [CLI Reference](./reference/cli.md) -# Developing Zed +# Developing Gwen -- [Developing Zed](./development.md) +- [Developing Gwen](./development.md) - [macOS](./development/macos.md) - [Linux](./development/linux.md) - [Windows](./development/windows.md) diff --git a/docs/src/account/billing.md b/docs/src/account/billing.md index e5d70fa2a3..30a541d685 100644 --- a/docs/src/account/billing.md +++ b/docs/src/account/billing.md @@ -1,11 +1,11 @@ --- title: Billing -description: Manage billing for your Zed subscription, including payment methods, invoices, and sales tax information for individual and organization accounts. +description: Manage billing for your Gwen subscription, including payment methods, invoices, and sales tax information for individual and organization accounts. --- # Billing -Zed uses Stripe for payment processing. All plans that require payment do so via credit card or other supported payment methods. Individual Pro subscriptions also use Orb for invoicing and metering. +Gwen uses Stripe for payment processing. All plans that require payment do so via credit card or other supported payment methods. Individual Pro subscriptions also use Orb for invoicing and metering. For details on what's included in each plan and how token usage works, see [Plans & Pricing](./plans-and-pricing.md). @@ -13,20 +13,20 @@ For details on what's included in each plan and how token usage works, see [Plan ### Billing information {#settings} -Access billing information and settings from your [Zed dashboard](https://dashboard.zed.dev). +Access billing information and settings from your [Gwen dashboard](https://dashboard.zed.dev). This page embeds data from Orb, our invoicing and metering partner. ### Billing cycles {#billing-cycles} -Zed is billed on a monthly basis based on the date you initially subscribe. You'll receive _at least_ one invoice from Zed each month you're subscribed to Zed Pro, and may receive more than one invoice if you use [hosted models](./zed-hosted-models.md) beyond your included monthly token credit. +Gwen is billed on a monthly basis based on the date you initially subscribe. You'll receive _at least_ one invoice from Gwen each month you're subscribed to Gwen Pro, and may receive more than one invoice if you use [hosted models](./zed-hosted-models.md) beyond your included monthly token credit. -### Zed Pro threshold billing {#threshold-billing} +### Gwen Pro threshold billing {#threshold-billing} -For individual Zed Pro subscriptions, Zed uses threshold billing to ensure timely payment collection. Threshold billing controls when already-allowed token usage is invoiced during the month; your [monthly spend limit](./plans-and-pricing.md#usage-spend-limits) still controls when hosted model usage stops. +For individual Gwen Pro subscriptions, Gwen uses threshold billing to ensure timely payment collection. Threshold billing controls when already-allowed token usage is invoiced during the month; your [monthly spend limit](./plans-and-pricing.md#usage-spend-limits) still controls when hosted model usage stops. -Threshold invoices start at $10 of pre-tax incremental token spend. For higher token usage, Zed may automatically raise your pre-tax invoicing threshold in $10 increments, up to $100, so you receive fewer mid-cycle invoices. Once raised, the invoicing threshold is not automatically lowered during the same subscription. +Threshold invoices start at $10 of pre-tax incremental token spend. For higher token usage, Gwen may automatically raise your pre-tax invoicing threshold in $10 increments, up to $100, so you receive fewer mid-cycle invoices. Once raised, the invoicing threshold is not automatically lowered during the same subscription. -For Zed Business billing, see [Organization billing](#organization). +For Gwen Business billing, see [Organization billing](#organization). For example, @@ -36,7 +36,7 @@ For example, ### Payment failures {#payment-failures} -If payment of an invoice fails, Zed will block usage of our hosted models until the payment is complete. Email [billing-support@zed.dev](mailto:billing-support@zed.dev) for assistance. +If payment of an invoice fails, Gwen will block usage of our hosted models until the payment is complete. Email [billing-support@zed.dev](mailto:billing-support@zed.dev) for assistance. ### Invoice history {#invoice-history} @@ -46,13 +46,13 @@ If you require historical Stripe invoices, email [billing-support@zed.dev](mailt ## Organization billing {#organization} -Zed Business consolidates your team's costs. Paid Business seats and member AI usage appear on one bill, with no separate invoices per member. For a full feature overview, see [Zed Business](../business/overview.md). +Gwen Business consolidates your team's costs. Paid Business seats and member AI usage appear on one bill, with no separate invoices per member. For a full feature overview, see [Gwen Business](../business/overview.md). ### Billing dashboard {#dashboard} Owners, admins, and Billing Managers can access billing information at [dashboard.zed.dev](https://dashboard.zed.dev). The dashboard shows the current plan and links to update billing details, tax ID information, and payment information. You can also access invoice history through the Orb billing portal. -Use the Billing Manager role for someone who needs billing access but does not need a paid Business seat. Billing Managers can view subscription usage, update billing details and payment methods, and access invoice history. They cannot manage members, change organization settings, cancel the subscription, or use Zed-hosted AI models and Edit Predictions through the Business subscription. For the full permissions list, see [Roles](../roles.md#role-billing-manager). +Use the Billing Manager role for someone who needs billing access but does not need a paid Business seat. Billing Managers can view subscription usage, update billing details and payment methods, and access invoice history. They cannot manage members, change organization settings, cancel the subscription, or use Gwen-hosted AI models and Edit Predictions through the Business subscription. For the full permissions list, see [Roles](../roles.md#role-billing-manager). ### AI usage {#ai-usage} @@ -74,7 +74,7 @@ Changes to billing information will **only** affect future invoices. We cannot m ## Sales tax {#sales-tax} -Zed partners with [Sphere](https://www.getsphere.com/) to calculate indirect tax rates for invoices, based on customer location and the product being sold. Tax is listed as a separate line item on invoices, based preferentially on your billing address, followed by the card issue country known to Stripe. +Gwen partners with [Sphere](https://www.getsphere.com/) to calculate indirect tax rates for invoices, based on customer location and the product being sold. Tax is listed as a separate line item on invoices, based preferentially on your billing address, followed by the card issue country known to Stripe. If you have a tax ID, such as a VAT or GST ID, you can add it during checkout or update it later from the Billing page. Check the box that denotes you as a business. diff --git a/docs/src/account/plans-and-pricing.md b/docs/src/account/plans-and-pricing.md index 5dc34e5c9d..948e5b9ea5 100644 --- a/docs/src/account/plans-and-pricing.md +++ b/docs/src/account/plans-and-pricing.md @@ -1,19 +1,19 @@ --- title: Plans & Pricing -description: Compare Zed's Free, Pro, and Business plans, and understand token-based usage metering, spend limits, and trial details. +description: Compare Gwen's Free, Pro, and Business plans, and understand token-based usage metering, spend limits, and trial details. --- # Plans & Pricing -For costs and more information on pricing, visit [Zed's pricing page](https://zed.dev/pricing). +For costs and more information on pricing, visit [Gwen's pricing page](https://zed.dev/pricing). -Zed works without AI features or a subscription. No [authentication](../authentication.md) is required for the editor itself. +Gwen works without AI features or a subscription. No [authentication](../authentication.md) is required for the editor itself. ## Plans {#plans} | | Free | Pro | Student | Business | | -------------------------------------------------------- | ------- | --------- | --------- | --------- | -| Zed-hosted AI models | — | ✓ | ✓ | ✓ | +| Gwen-hosted AI models | — | ✓ | ✓ | ✓ | | [AI via own API keys](../ai/use-api-access.md) | ✓ | ✓ | ✓ | ✓ | | [External Agents](../ai/external-agents.md) | ✓ | ✓ | ✓ | ✓ | | Edit Predictions | Limited | Unlimited | Unlimited | Unlimited | @@ -21,50 +21,50 @@ Zed works without AI features or a subscription. No [authentication](../authenti | Roles & permissions | — | — | — | ✓ | | Consolidated billing | — | — | — | ✓ | -### Zed Free {#free} +### Gwen Free {#free} -Zed is free to use. You can configure AI agents with your own API keys via [Use API Access](../ai/use-api-access.md). [Edit Predictions](../ai/edit-prediction.md) are available on a limited basis. Zed's hosted models require a Pro subscription. +Gwen is free to use. You can configure AI agents with your own API keys via [Use API Access](../ai/use-api-access.md). [Edit Predictions](../ai/edit-prediction.md) are available on a limited basis. Gwen's hosted models require a Pro subscription. -### Zed Pro {#pro} +### Gwen Pro {#pro} -Zed Pro includes access to all hosted AI models and Edit Predictions. The plan includes $5 of monthly token credit; usage beyond that is billed at the rates listed on [Zed-Hosted Models](./zed-hosted-models.md). A [trial of Zed Pro](#trials) includes $5 of GPT Luna and unlimited Edit Predictions for 14 days from when you start the trial. +Gwen Pro includes access to all hosted AI models and Edit Predictions. The plan includes $5 of monthly token credit; usage beyond that is billed at the rates listed on [Gwen-Hosted Models](./zed-hosted-models.md). A [trial of Gwen Pro](#trials) includes $5 of GPT Luna and unlimited Edit Predictions for 14 days from when you start the trial. For details on billing and payment, see [Individual Billing](./billing.md). -### Zed Business {#business} +### Gwen Business {#business} -Zed Business gives members with a paid Business seat access to all of Zed's hosted AI models, unlimited Edit Predictions, plus org-wide controls for administrators: which AI features are available, what data leaves your organization, and how AI spend is tracked. Paid seats and AI usage are consolidated into a single invoice. +Gwen Business gives members with a paid Business seat access to all of Gwen's hosted AI models, unlimited Edit Predictions, plus org-wide controls for administrators: which AI features are available, what data leaves your organization, and how AI spend is tracked. Paid seats and AI usage are consolidated into a single invoice. -For a full feature overview, see [Zed Business](../business/overview.md). For billing details, see [Billing](./billing.md#organization). +For a full feature overview, see [Gwen Business](../business/overview.md). For billing details, see [Billing](./billing.md#organization). ### Student Plan {#student} -The [Zed Student plan](https://zed.dev/education) includes all Zed Pro features: unlimited [Edit Predictions](../ai/edit-prediction.md), all [hosted AI models](./zed-hosted-models.md) except Claude Opus, and $10/month in token credits. Available free for one year to verified university students. +The [Gwen Student plan](https://zed.dev/education) includes all Gwen Pro features: unlimited [Edit Predictions](../ai/edit-prediction.md), all [hosted AI models](./zed-hosted-models.md) except Claude Opus, and $10/month in token credits. Available free for one year to verified university students. ## Usage {#usage} -Usage of Zed's hosted models is measured on a token basis, converted to dollars at the rates listed on [Zed-Hosted Models](./zed-hosted-models.md) (list price from the provider, +10%). +Usage of Gwen's hosted models is measured on a token basis, converted to dollars at the rates listed on [Gwen-Hosted Models](./zed-hosted-models.md) (list price from the provider, +10%). Monthly included credit resets on your monthly billing date. To view your current usage, navigate to the Billing page at [dashboard.zed.dev](https://dashboard.zed.dev). Usage data from our metering provider, Orb, is embedded on that page. ## Spend Limits {#usage-spend-limits} -### Zed Pro {#pro-spend-limits} +### Gwen Pro {#pro-spend-limits} -On your Billing page you'll find an input for `Monthly Spend Limit`. For Zed Pro, the dollar amount here specifies your pre-tax _monthly_ limit for spend on tokens, _not counting_ the $5/month included with your Pro subscription. +On your Billing page you'll find an input for `Monthly Spend Limit`. For Gwen Pro, the dollar amount here specifies your pre-tax _monthly_ limit for spend on tokens, _not counting_ the $5/month included with your Pro subscription. -The default value for Pro users is $10, for a total monthly spend with Zed of $20 ($10 for your Pro subscription, $10 in incremental token spend). This can be set to $0 to limit your spend with Zed to exactly $10/month. If you adjust this limit _higher_ than $10 and consume more than $10 of incremental token spend, that usage may be billed during the month via [Zed Pro threshold billing](./billing.md#threshold-billing). +The default value for Pro users is $10, for a total monthly spend with Gwen of $20 ($10 for your Pro subscription, $10 in incremental token spend). This can be set to $0 to limit your spend with Gwen to exactly $10/month. If you adjust this limit _higher_ than $10 and consume more than $10 of incremental token spend, that usage may be billed during the month via [Gwen Pro threshold billing](./billing.md#threshold-billing). Once the spend limit is hit, we'll stop any further usage until your token spend limit resets. -### Zed Business {#business-spend-limits} +### Gwen Business {#business-spend-limits} -On Zed Business, administrators set a pre-tax org-wide spend limit from the Data & Privacy page in the organization dashboard. Seats and AI usage are consolidated into [Organization billing](./billing.md#organization). Once the org-wide spend limit is reached, we'll stop hosted model usage for members until the limit resets or an administrator raises it. +On Gwen Business, administrators set a pre-tax org-wide spend limit from the Data & Privacy page in the organization dashboard. Seats and AI usage are consolidated into [Organization billing](./billing.md#organization). Once the org-wide spend limit is reached, we'll stop hosted model usage for members until the limit resets or an administrator raises it. -> **Note:** Spend limits are a Zed Pro and Business feature. Student plan users cannot configure spend limits; usage is capped at the $10/month included credit. +> **Note:** Spend limits are a Gwen Pro and Business feature. Student plan users cannot configure spend limits; usage is capped at the $10/month included credit. ### Trials {#trials} -Trials include $5 of GPT Luna and unlimited Edit Predictions for 14 days from when you start the trial. Trial hosted-model access is limited to GPT Luna. Zed and Delta share the same $5 trial balance. No credit card is required. +Trials include $5 of GPT Luna and unlimited Edit Predictions for 14 days from when you start the trial. Trial hosted-model access is limited to GPT Luna. Gwen and Delta share the same $5 trial balance. No credit card is required. -Trials automatically convert to Zed Free when they end. No cancellation is needed to prevent conversion to Zed Pro. +Trials automatically convert to Gwen Free when they end. No cancellation is needed to prevent conversion to Gwen Pro. diff --git a/docs/src/account/zed-hosted-models.md b/docs/src/account/zed-hosted-models.md index 3a5772bedc..50fb1cbaba 100644 --- a/docs/src/account/zed-hosted-models.md +++ b/docs/src/account/zed-hosted-models.md @@ -1,15 +1,15 @@ --- -title: Zed-Hosted Models - Zed -description: AI models available via Zed Pro including Claude Fable 5, Claude Sonnet 5, GPT-5.6, and Gemini 3. Pricing, context windows, and tool call support. +title: Gwen-Hosted Models - Gwen +description: AI models available via Gwen Pro including Claude Fable 5, Claude Sonnet 5, GPT-5.6, and Gemini 3. Pricing, context windows, and tool call support. --- -# Zed-Hosted Models +# Gwen-Hosted Models -Zed's plans offer hosted versions of major LLMs with higher rate limits than direct API access. Model availability is updated regularly. To use your own API keys instead, see [LLM Providers](../ai/llm-providers.md). For general setup, see [AI Quick Start](../ai/quick-start.md). +Gwen's plans offer hosted versions of major LLMs with higher rate limits than direct API access. Model availability is updated regularly. To use your own API keys instead, see [LLM Providers](../ai/llm-providers.md). For general setup, see [AI Quick Start](../ai/quick-start.md). -> **Note:** Claude Fable 5, Claude Opus models, GPT-5.5 pro, and GPT-5.4 pro are only available on Zed Pro and Zed Business. +> **Note:** Claude Fable 5, Claude Opus models, GPT-5.5 pro, and GPT-5.4 pro are only available on Gwen Pro and Gwen Business. -| Model | Provider | Token Type | Provider Price per 1M tokens | Zed Price per 1M tokens | +| Model | Provider | Token Type | Provider Price per 1M tokens | Gwen Price per 1M tokens | | ----------------- | --------- | ------------------- | ---------------------------- | ----------------------- | | Claude Fable 5 | Anthropic | Input | $10.00 | $11.00 | | | Anthropic | Output | $50.00 | $55.00 | @@ -95,13 +95,13 @@ Zed's plans offer hosted versions of major LLMs with higher rate limits than dir | Gemini 3 Flash | Google | Input | $0.50 | $0.55 | | | Google | Output | $3.00 | $3.30 | -> **Warn:** Anthropic retains prompts and outputs sent to Claude Fable 5 for at least 30 days for trust and safety purposes. The no-training commitment still applies, and Zed does not retain your prompts or outputs. See [Provider Safety Retention for Designated Models](../ai/privacy-and-security.md#provider-safety-retention). +> **Warn:** Anthropic retains prompts and outputs sent to Claude Fable 5 for at least 30 days for trust and safety purposes. The no-training commitment still applies, and Gwen does not retain your prompts or outputs. See [Provider Safety Retention for Designated Models](../ai/privacy-and-security.md#provider-safety-retention). The Claude Sonnet 5 prices shown above use Anthropic's introductory pricing through August 31, 2026. ## Recent Model Retirements {#recent-model-retirements} -Zed no longer offers the models below: +Gwen no longer offers the models below: - Claude Opus 4.1 → Claude Opus 4.5, Claude Opus 4.6, Claude Opus 4.7, or Claude Opus 4.8 - Claude Sonnet 4 → Claude Sonnet 4.5 or Claude Sonnet 4.6 @@ -110,13 +110,13 @@ Zed no longer offers the models below: - Gemini 2.5 Pro → Gemini 3.1 Pro - Gemini 3 Pro (retired March 26, 2026) → Gemini 3.1 Pro - Gemini 2.5 Flash → Gemini 3 Flash or Gemini 3.5 Flash -- Grok 4, Grok 4 Fast, Grok 4 Fast (Non-Reasoning), and Grok Code Fast 1 ([retired May 15, 2026](https://docs.x.ai/developers/migration/may-15-retirement)). Zed no longer offers hosted xAI models. +- Grok 4, Grok 4 Fast, Grok 4 Fast (Non-Reasoning), and Grok Code Fast 1 ([retired May 15, 2026](https://docs.x.ai/developers/migration/may-15-retirement)). Gwen no longer offers hosted xAI models. ## Usage {#usage} -Any usage of a Zed-hosted model will be billed at the Zed Price (rightmost column above). See [Plans & Pricing](./plans-and-pricing.md) for details on Zed's plans and limits for use of hosted models. +Any usage of a Gwen-hosted model will be billed at the Gwen Price (rightmost column above). See [Plans & Pricing](./plans-and-pricing.md) for details on Gwen's plans and limits for use of hosted models. -Because Zed-hosted Gemini models do not use Google context caching, Gemini usage is billed only as input and output tokens; there is no separate cached-input price for these models. This preserves zero-data-retention behavior for hosted Gemini requests. For background, see Google's Vertex AI documentation on [context caching](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview) and [zero data retention](https://cloud.google.com/vertex-ai/generative-ai/docs/vertex-ai-zero-data-retention). +Because Gwen-hosted Gemini models do not use Google context caching, Gemini usage is billed only as input and output tokens; there is no separate cached-input price for these models. This preserves zero-data-retention behavior for hosted Gemini requests. For background, see Google's Vertex AI documentation on [context caching](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview) and [zero data retention](https://cloud.google.com/vertex-ai/generative-ai/docs/vertex-ai-zero-data-retention). > LLMs can enter unproductive loops that require user intervention. Monitor longer-running tasks and interrupt if needed. @@ -124,7 +124,7 @@ Because Zed-hosted Gemini models do not use Google context caching, Gemini usage A context window is the maximum span of text and code an LLM can consider at once, including both the input prompt and output generated by the model. -| Model | Provider | Zed-Hosted Context Window | +| Model | Provider | Gwen-Hosted Context Window | | ----------------- | --------- | ------------------------- | | Claude Fable 5 | Anthropic | 1M | | Claude Opus 5 | Anthropic | 1M | @@ -152,9 +152,9 @@ A context window is the maximum span of text and code an LLM can consider at onc | Gemini 3.5 Flash | Google | 1M | | Gemini 3 Flash | Google | 1M | -> Zed currently limits hosted Gemini 3.1 Pro requests to 200k tokens because pricing changes above that context size. +> Gwen currently limits hosted Gemini 3.1 Pro requests to 200k tokens because pricing changes above that context size. -Each Agent thread in Zed maintains its own context window. +Each Agent thread in Gwen maintains its own context window. The more prompts, attached files, and responses included in a session, the larger the context window grows. Start a new thread for each distinct task to keep context focused. diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md index 127b163ca9..d3bfdeebec 100644 --- a/docs/src/ai/agent-panel.md +++ b/docs/src/ai/agent-panel.md @@ -1,20 +1,20 @@ --- -title: AI Coding Agent - Zed Agent Panel -description: Use Zed's AI coding agent to generate, refactor, and debug code with tool calling, checkpoints, and multi-model support. +title: AI Coding Agent - Gwen Agent Panel +description: Use Gwen's AI coding agent to generate, refactor, and debug code with tool calling, checkpoints, and multi-model support. --- # Agent Panel The Agent Panel is where you interact with AI agents that can read, write, and run code in your project. -It's the core of Zed's AI code editing experience — use it for code generation, refactoring, debugging, documentation, and general questions. +It's the core of Gwen's AI code editing experience — use it for code generation, refactoring, debugging, documentation, and general questions. Open it with {#action agent::NewThread} from [the Command Palette](../command-palette.md) or click the ✨ icon in the status bar. ## Getting Started {#getting-started} -If you're using the Agent Panel for the first time, configure either a model for the [Zed Agent](./zed-agent.md) or an [External Agent](./external-agents.md). +If you're using the Agent Panel for the first time, configure either a model for the [Gwen Agent](./zed-agent.md) or an [External Agent](./external-agents.md). -- Use [LLM Providers](./llm-providers.md) for Zed-hosted models, API access, subscriptions, gateways, and local models. +- Use [LLM Providers](./llm-providers.md) for Gwen-hosted models, API access, subscriptions, gateways, and local models. - Use [External Agents](./external-agents.md) for ACP-integrated agents. - Use [AI Quick Start](./quick-start.md) if you are not sure which path to choose. @@ -31,14 +31,14 @@ The sections below cover what you can do from here. ### Creating New Threads {#new-thread} -By default, the Agent Panel uses Zed's first-party agent. +By default, the Agent Panel uses Gwen's first-party agent. Start a new thread with {#kb agent::NewThread}, or open the "New Thread…" menu using the agent selector button on the left (in the empty state) or the `+` icon in the top-right of the panel toolbar. You can also open that menu with {#kb agent::ToggleNewThreadMenu}. From the "New Thread…" menu you can: -- Pick **Zed Agent** or any installed [External Agent](./external-agents.md) to start a new thread with that agent. -- Choose **New From Summary** to start a fresh Zed Agent thread seeded with a summary of the current conversation — useful for compacting long threads as you approach the context window limit. +- Pick **Gwen Agent** or any installed [External Agent](./external-agents.md) to start a new thread with that agent. +- Choose **New From Summary** to start a fresh Gwen Agent thread seeded with a summary of the current conversation — useful for compacting long threads as you approach the context window limit. - Choose **Terminal** to open a terminal thread directly in the Agent Panel — see [Terminal Threads](#terminal-threads) for details. {#action agent::NewExternalAgentThread} creates a new thread with the specified External Agent id. @@ -64,7 +64,7 @@ You can click on the card that contains your message and re-submit it with an ad Messages sent while the agent is in the generating state get, by default, queued. -By default, queued messages get sent once the agent finishes generating. If you want a queued message to reach the Zed Agent sooner—interrupting it at its next step (usually between a tool call and a response) rather than waiting for it to finish—toggle "Steer" on that message. Steering is only available for the Zed Agent, since Zed can't detect turn boundaries for external agents. +By default, queued messages get sent once the agent finishes generating. If you want a queued message to reach the Gwen Agent sooner—interrupting it at its next step (usually between a tool call and a response) rather than waiting for it to finish—toggle "Steer" on that message. Steering is only available for the Gwen Agent, since Gwen can't detect turn boundaries for external agents. You can edit or remove (an individual or all) queued messages. You can also still interrupt the agent immediately if you want by either clicking on the stop button or by clicking the "Send Now" (double-enter) on a queued message. @@ -105,15 +105,15 @@ You can also hold `cmd`/`ctrl` when submitting a message to automatically follow ### Keeping the System Awake {#prevent-idle-sleep} -While an agent thread is running, Zed asks the operating system not to idle-sleep, so long-running turns are not interrupted when you step away. +While an agent thread is running, Gwen asks the operating system not to idle-sleep, so long-running turns are not interrupted when you step away. The display can still turn off and the screen can still lock; only system sleep is held back, and only while a thread is generating, not while it waits for your confirmation. Turn this off with the `agent.prevent_idle_sleep` setting. -If the operating system rejects the request, Zed logs the reason and continues without it. +If the operating system rejects the request, Gwen logs the reason and continues without it. ### Get Notified {#get-notified} -If you send a prompt to the Agent and then put Zed in the background, you can choose to be notified when its generation wraps up via: +If you send a prompt to the Agent and then put Gwen in the background, you can choose to be notified when its generation wraps up via: - a visual desktop notification from your operating system - a sound notification @@ -142,7 +142,7 @@ The agent can search your codebase to find relevant context, but providing it ex Add context by typing `@` in the message editor. You can mention files, directories, symbols, previous threads, [skills](./skills.md), diagnostics, branch diffs, and URLs to fetch. -When you paste multi-line code selections copied from a buffer, Zed automatically formats them as @-mentions with the file context. +When you paste multi-line code selections copied from a buffer, Gwen automatically formats them as @-mentions with the file context. To paste content without this automatic formatting, use {#kb agent::PasteRaw} to paste raw text directly. ### Selection as Context @@ -159,9 +159,9 @@ Copying an image and pasting it is also supported. ## Token Usage and Compaction {#token-usage} -Zed surfaces how many tokens you are consuming for your currently active thread near the profile selector in the panel's message editor. +Gwen surfaces how many tokens you are consuming for your currently active thread near the profile selector in the panel's message editor. -Zed automatically compacts long Zed Agent threads as they approach the configured token threshold. Compaction summarizes earlier messages and replaces them in the model context with that summary, leaving more room for the next turn. The thread shows a **Context Compacted** entry that you can expand to inspect the summary. You can compact manually by typing `/compact` in the message editor. +Gwen automatically compacts long Gwen Agent threads as they approach the configured token threshold. Compaction summarizes earlier messages and replaces them in the model context with that summary, leaving more room for the next turn. The thread shows a **Context Compacted** entry that you can expand to inspect the summary. You can compact manually by typing `/compact` in the message editor. If the selected model's context window is too small for automatic compaction (less than 80000 tokens), a banner appears above the message editor as you approach the token limit. Use **Start New Thread** from that banner, or choose **New From Summary** from the New Thread menu (the `+` button on the top right), to continue in a new thread seeded with a summary. You can also @-mention a past thread in a new one. @@ -169,9 +169,9 @@ Configure automatic compaction with `agent.auto_compact`. See [Agent Settings](. ## Changing Models {#changing-models} -After you've configured your LLM providers—either via [API access](./use-api-access.md) or through [Zed-hosted models](../account/zed-hosted-models.md)—you can switch between their models by clicking on the model selector on the message editor or by using the {#kb agent::ToggleModelSelector} keybinding. +After you've configured your LLM providers—either via [API access](./use-api-access.md) or through [Gwen-hosted models](../account/zed-hosted-models.md)—you can switch between their models by clicking on the model selector on the message editor or by using the {#kb agent::ToggleModelSelector} keybinding. -> The same model can be offered via multiple providers - for example, Claude Sonnet 4.5 is available via Zed Pro, OpenRouter, Anthropic directly, and more. +> The same model can be offered via multiple providers - for example, Claude Sonnet 4.5 is available via Gwen Pro, OpenRouter, Anthropic directly, and more. > Make sure you've selected the correct model **_provider_** for the model you'd like to use, delineated by the logo to the left of the model in the model selector. ### Favoriting Models @@ -182,9 +182,9 @@ Cycle through your favorites with {#kb agent::CycleFavoriteModels} without openi ## Using Tools and Profiles {#using-tools} -The Agent Panel supports tool calling, which enables agentic editing. Zed includes [built-in tools](./tools.md) for searching your codebase, editing files, running terminal commands, and more. +The Agent Panel supports tool calling, which enables agentic editing. Gwen includes [built-in tools](./tools.md) for searching your codebase, editing files, running terminal commands, and more. -Use [Agent Profiles](./agent-profiles.md) to choose which built-in tools and MCP tools are available in a Zed Agent thread. Use [Tool Permissions](./tool-permissions.md) to control whether permission-gated tool calls are allowed, denied, or confirmed. +Use [Agent Profiles](./agent-profiles.md) to choose which built-in tools and MCP tools are available in a Gwen Agent thread. Use [Tool Permissions](./tool-permissions.md) to control whether permission-gated tool calls are allowed, denied, or confirmed. You can add external tools with [MCP Servers](./mcp.md). @@ -194,12 +194,12 @@ Tool calling needs to be individually supported by each model and model provider Therefore, despite the presence of built-in tools, some models may not have the ability to pick them up. You should see a "No tools" label if you select a model that falls into this case. -All [Zed-hosted models](../account/zed-hosted-models.md) support tool calling out-of-the-box. +All [Gwen-hosted models](../account/zed-hosted-models.md) support tool calling out-of-the-box. ### MCP Servers {#mcp-servers} Similarly to the built-in tools, some models may not support all tools included in a given MCP Server. -Zed's UI will inform you about this via a warning icon that appears close to the model selector. +Gwen's UI will inform you about this via a warning icon that appears close to the model selector. ## Errors and Debugging {#errors-and-debugging} @@ -209,17 +209,17 @@ You can also open threads as Markdown by clicking on the file icon button, to th ## Feedback {#feedback} -You can rate agent responses to help improve Zed's system prompt and tools. +You can rate agent responses to help improve Gwen's system prompt and tools. -> **Warning:** Rating an AI response sends the conversation thread to Zed. The +> **Warning:** Rating an AI response sends the conversation thread to Gwen. The > conversation thread includes your messages, AI responses, and thread metadata. > See [Feedback and Training Data](./ai-improvement.md) and > [AI Privacy](./privacy-and-security.md) for more information. -> **_If you don't want data persisted on Zed's servers, don't rate_**. -> We will not collect data for improving Zed's agent experience without you +> **_If you don't want data persisted on Gwen's servers, don't rate_**. +> We will not collect data for improving Gwen's agent experience without you > explicitly rating responses. -To help improve Zed's system prompt and tools, rate responses with the thumbs up/down controls at the end of each response. +To help improve Gwen's system prompt and tools, rate responses with the thumbs up/down controls at the end of each response. In case of a thumbs down, a new text area will show up where you can add more specifics about what happened. You can provide feedback on the thread at any point after the agent responds, and multiple times within the same thread. diff --git a/docs/src/ai/agent-profiles.md b/docs/src/ai/agent-profiles.md index fbd1c6dcd3..5c72a5a9c8 100644 --- a/docs/src/ai/agent-profiles.md +++ b/docs/src/ai/agent-profiles.md @@ -1,17 +1,17 @@ --- -title: Agent Profiles - Zed -description: Configure Zed Agent profiles for model selection, built-in tool availability, and MCP tool availability. +title: Agent Profiles - Gwen +description: Configure Gwen Agent profiles for model selection, built-in tool availability, and MCP tool availability. --- # Agent Profiles -Agent profiles control how the [Zed Agent](./zed-agent.md) behaves in a thread. A profile can set a default model and choose which [built-in tools](./tools.md) and MCP tools are available. +Agent profiles control how the [Gwen Agent](./zed-agent.md) behaves in a thread. A profile can set a default model and choose which [built-in tools](./tools.md) and MCP tools are available. Profiles do not decide whether a tool call is allowed automatically. Use [Tool Permissions](./tool-permissions.md) to control allow, deny, and confirm behavior. ## Built-in Profiles {#built-in-profiles} -Zed includes three built-in profiles: +Gwen includes three built-in profiles: - `Write`: enables tools for reading, editing, and running commands. - `Ask`: focuses on read-only codebase questions. @@ -69,8 +69,8 @@ The exact model IDs and provider IDs depend on your configured [LLM Providers](. | Agent profile | Whether a tool is available in a profile | Disable `terminal` in a read-only profile | | Tool permissions | Whether a permission-gated tool call is allowed, denied, or confirmed | Always confirm `terminal` commands | -If a tool is not available in the active profile, the Zed Agent cannot use it. If the tool is available and permission-gated, [Tool Permissions](./tool-permissions.md) still controls whether the tool call requires approval. +If a tool is not available in the active profile, the Gwen Agent cannot use it. If the tool is available and permission-gated, [Tool Permissions](./tool-permissions.md) still controls whether the tool call requires approval. ## Agent Path Boundaries {#agent-path-boundaries} -Agent profiles apply to the Zed Agent. External Agents and [Terminal Threads](./terminal-threads.md) do not use Zed Agent profiles unless their integration explicitly supports similar behavior. +Agent profiles apply to the Gwen Agent. External Agents and [Terminal Threads](./terminal-threads.md) do not use Gwen Agent profiles unless their integration explicitly supports similar behavior. diff --git a/docs/src/ai/agent-settings.md b/docs/src/ai/agent-settings.md index 406695f0d8..a2fc50081d 100644 --- a/docs/src/ai/agent-settings.md +++ b/docs/src/ai/agent-settings.md @@ -1,6 +1,6 @@ --- -title: Agent Settings - Zed -description: Map the AI settings pages to Zed AI setup for LLM providers, External Agents, MCP servers, and related settings. +title: Agent Settings - Gwen +description: Map the AI settings pages to Gwen AI setup for LLM providers, External Agents, MCP servers, and related settings. --- # Agent Settings @@ -16,11 +16,11 @@ Within the AI page, LLM Providers, External Agents, and MCP Servers each open as | Settings Editor | {#action agent::OpenSettings} | AI settings: LLM providers, External Agents, MCP servers, and related pages | | Settings file | {#action zed::OpenSettingsFile} | Direct JSON edits and settings not exposed in UI | -For general settings mechanics, see [Configuring Zed](../configuring-zed.md). +For general settings mechanics, see [Configuring Gwen](../configuring-zed.md). ## LLM Providers {#llm-providers} -The `LLM Providers` section configures model providers for Zed AI features, including Zed Agent, Inline Assistant, Git commit generation, thread summaries, and similar model-backed features. +The `LLM Providers` section configures model providers for Gwen AI features, including Gwen Agent, Inline Assistant, Git commit generation, thread summaries, and similar model-backed features. Use this section to: @@ -33,7 +33,7 @@ For the model-access paths and provider-specific setup, see [LLM Providers](./ll ## Feature-Specific Settings {#feature-specific-settings} -Some Zed AI features have their own model or prompt settings in `settings.json`, including: +Some Gwen AI features have their own model or prompt settings in `settings.json`, including: - `agent.inline_assistant_model` - `agent.commit_message_model` @@ -57,7 +57,7 @@ For feature-specific model examples, see [Feature-specific Models](#feature-spec ## Automatic Compaction {#automatic-compaction} -Zed Agent can automatically compact long threads before they reach the selected model's context window. Compaction summarizes earlier messages and keeps the conversation usable without starting a new thread. +Gwen Agent can automatically compact long threads before they reach the selected model's context window. Compaction summarizes earlier messages and keeps the conversation usable without starting a new thread. Automatic compaction is enabled by default and runs when the thread reaches `90%` of the model's context window. You can change the threshold or disable automatic compaction in `settings.json`: @@ -80,9 +80,9 @@ The `threshold` value can be one of: | Positive integer, like `100000` | Compact after that many tokens have been used. | | Negative integer, like `-20000` | Compact once fewer than that many tokens remain in the model's context window. | -`0` is not a valid threshold. If the threshold is invalid, Zed falls back to `90%`. +`0` is not a valid threshold. If the threshold is invalid, Gwen falls back to `90%`. -You can compact a Zed Agent thread manually at any time by typing `/compact` in the Agent Panel message editor. For more on thread token usage and compaction behavior, see [Token Usage and Compaction](./agent-panel.md#token-usage). +You can compact a Gwen Agent thread manually at any time by typing `/compact` in the Agent Panel message editor. For more on thread token usage and compaction behavior, see [Token Usage and Compaction](./agent-panel.md#token-usage). ## Compaction Model {#compaction-model} @@ -120,7 +120,7 @@ For setup details and support boundaries, see [External Agents](./external-agent ## MCP Servers {#mcp-servers} -The `MCP Servers` page configures Model Context Protocol servers connected to Zed. +The `MCP Servers` page configures Model Context Protocol servers connected to Gwen. Use `Add Server` (in the page header) to: @@ -142,23 +142,23 @@ Some AI settings are not configured on the AI settings pages: | Task | Go to | | ------------------------------------------------------------ | ---------------------------------------------- | -| Choose which tools are available in a Zed Agent thread | [Agent Profiles](./agent-profiles.md) | +| Choose which tools are available in a Gwen Agent thread | [Agent Profiles](./agent-profiles.md) | | Control whether tool calls are allowed, denied, or confirmed | [Tool Permissions](./tool-permissions.md) | | Configure reusable task instructions | [Skills](./skills.md) | | Configure always-on personal or project instructions | [Instructions](./instructions.md) | | Configure edit prediction providers | [Edit Prediction](./edit-prediction.md) | | Turn AI off | [AI Quick Start](./quick-start.md#turn-ai-off) | -| Edit raw settings JSON | [Configuring Zed](../configuring-zed.md) | +| Edit raw settings JSON | [Configuring Gwen](../configuring-zed.md) | ## Feature-Specific Models {#feature-specific-models} -Zed supports feature-specific model settings for Inline Assistant, Git commit generation, thread summaries, and subagents. Configure these in settings when you need a different model for a specific workflow. +Gwen supports feature-specific model settings for Inline Assistant, Git commit generation, thread summaries, and subagents. Configure these in settings when you need a different model for a specific workflow. See [LLM Providers](./llm-providers.md) for model access, and [All Settings](../reference/all-settings.md) for the complete settings reference. ## Model Temperature {#model-temperature} -Most Zed AI features use the selected model's default generation behavior. +Most Gwen AI features use the selected model's default generation behavior. Use `agent.model_parameters` when you need to set a temperature for a provider, a model, or a specific provider/model pair. @@ -176,7 +176,7 @@ a model, or a specific provider/model pair. } ``` -Zed checks matching entries from last to first. An entry can omit `provider` or +Gwen checks matching entries from last to first. An entry can omit `provider` or `model` to apply more broadly. For provider-specific model configuration such as custom model entries, context windows, or gateway routing, see [LLM Providers](./llm-providers.md) and the provider setup pages. diff --git a/docs/src/ai/agents.md b/docs/src/ai/agents.md index c2dead09a1..4496e10d49 100644 --- a/docs/src/ai/agents.md +++ b/docs/src/ai/agents.md @@ -1,34 +1,34 @@ --- -title: AI Agents in Zed -description: Compare Zed Agent, External Agents, and Terminal Threads. +title: AI Agents in Gwen +description: Compare Gwen Agent, External Agents, and Terminal Threads. --- # Agents -Zed supports three agent paths. Choose the path based on how you want agentic work to run. +Gwen supports three agent paths. Choose the path based on how you want agentic work to run. | Agent path | Runs in | Uses | Best when | | ----------------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | -| [Zed Agent](./zed-agent.md) | [Agent Panel](./agent-panel.md) and Threads Sidebar | Zed-configured LLM providers, native tools, skills, [instructions](./instructions.md), MCP | You want Zed's native agent integration | +| [Gwen Agent](./zed-agent.md) | [Agent Panel](./agent-panel.md) and Threads Sidebar | Gwen-configured LLM providers, native tools, skills, [instructions](./instructions.md), MCP | You want Gwen's native agent integration | | [External Agents](./external-agents.md) | Agent Panel and Threads Sidebar | ACP agent process and its own auth/config | You want Claude, Codex, OpenCode, Copilot, Cursor, Pi, or another ACP-integrated agent | -| [Terminal Threads](./terminal-threads.md) | Threads Sidebar and terminal | Native CLI/TUI auth/config | You want the tool's command-line experience organized in Zed | +| [Terminal Threads](./terminal-threads.md) | Threads Sidebar and terminal | Native CLI/TUI auth/config | You want the tool's command-line experience organized in Gwen | -An agent path is sometimes called a harness. It is the way agentic work is started, displayed, configured, and controlled in Zed. +An agent path is sometimes called a harness. It is the way agentic work is started, displayed, configured, and controlled in Gwen. ## Agent Path vs. LLM Provider {#agent-path-vs-llm-provider} | Question | Start here | | ----------------------------------------- | ----------------------------------- | | Which agent or CLI should run the work? | This page | -| Which model should power Zed AI features? | [LLM Providers](./llm-providers.md) | +| Which model should power Gwen AI features? | [LLM Providers](./llm-providers.md) | -The [Zed Agent](./zed-agent.md) uses models configured in Zed. [External Agents](./external-agents.md) and [Terminal Threads](./terminal-threads.md) may use their own model setup. +The [Gwen Agent](./zed-agent.md) uses models configured in Gwen. [External Agents](./external-agents.md) and [Terminal Threads](./terminal-threads.md) may use their own model setup. ## Thread Types {#thread-types} Threads are the units shown in the [Threads Sidebar](./parallel-agents.md#threads-sidebar). Thread types include: -- [Zed Agent](./zed-agent.md) threads +- [Gwen Agent](./zed-agent.md) threads - [External Agent](./external-agents.md) threads - [Terminal Threads](./terminal-threads.md) diff --git a/docs/src/ai/ai-improvement.md b/docs/src/ai/ai-improvement.md index 172a70e3f9..6a3fd8a5f6 100644 --- a/docs/src/ai/ai-improvement.md +++ b/docs/src/ai/ai-improvement.md @@ -1,20 +1,20 @@ --- -title: Feedback and Training Data - Zed -description: Understand opt-in AI feedback ratings, Edit Prediction training data, and when Zed may retain AI data. +title: Feedback and Training Data - Gwen +description: Understand opt-in AI feedback ratings, Edit Prediction training data, and when Gwen may retain AI data. --- # Feedback and Training Data -Normal AI requests are not retained by Zed. For -[Zed-hosted models](../account/zed-hosted-models.md), provider agreements +Normal AI requests are not retained by Gwen. For +[Gwen-hosted models](../account/zed-hosted-models.md), provider agreements prohibit training on your prompts or code context and require zero data retention, except for [provider-designated models with safety retention](./privacy-and-security.md#provider-safety-retention), such as Anthropic's Covered Models. -This page covers the cases where Zed may retain AI data because you explicitly +This page covers the cases where Gwen may retain AI data because you explicitly shared it or opted in. -AI features in Zed include: +AI features in Gwen include: - [Agent Panel](./agent-panel.md) - [Edit Prediction](./edit-prediction.md) @@ -24,49 +24,49 @@ AI features in Zed include: For the broader request path and provider data boundaries, see [AI Privacy](./privacy-and-security.md). -## Zed-Hosted Model Commitments {#data-retention-and-training} +## Gwen-Hosted Model Commitments {#data-retention-and-training} -Zed-hosted model zero-data-retention and no-training commitments, including the +Gwen-hosted model zero-data-retention and no-training commitments, including the exception for provider-designated models with safety retention (such as Anthropic's Covered Models), are documented on [AI Privacy](./privacy-and-security.md#data-retention-and-training). ## Response Ratings and Feedback {#ai-feedback-with-ratings} -You can rate AI responses or submit feedback to help improve Zed's system prompt, +You can rate AI responses or submit feedback to help improve Gwen's system prompt, tools, and AI product experience. Each share is opt-in, and sharing once does not grant permission for future collection. -> **Warning:** Rating an AI response sends the conversation thread to Zed. The +> **Warning:** Rating an AI response sends the conversation thread to Gwen. The > conversation thread includes your messages, AI responses, and thread metadata. -> If you do not want the thread persisted by Zed, do not rate the response. +> If you do not want the thread persisted by Gwen, do not rate the response. ### Data Collected from Feedback {#data-collected-ai-feedback} -For conversation threads you explicitly share through ratings or feedback, Zed +For conversation threads you explicitly share through ratings or feedback, Gwen may store: - your messages and AI responses in the conversation thread - any commentary you include with your rating or feedback - thread metadata, such as model used, token counts, and timestamps -- metadata about your Zed installation +- metadata about your Gwen installation -If you do not rate responses or submit feedback, Zed does not store Customer Data +If you do not rate responses or submit feedback, Gwen does not store Customer Data related to your AI feature usage for improvement. -Telemetry related to Zed's AI features is collected separately. This includes +Telemetry related to Gwen's AI features is collected separately. This includes metadata such as the AI feature being used and high-level interactions with the feature to understand performance, such as agent response time or edit acceptance and rejection. See [Telemetry](../telemetry.md) for details. -Collected feedback data is stored in Snowflake. Zed periodically reviews this +Collected feedback data is stored in Snowflake. Gwen periodically reviews this data to refine prompts, tools, and product behavior. Stored feedback data is anonymized and stripped of sensitive information such as access tokens, user IDs, and email addresses. ## Edit Prediction Training Data {#edit-predictions} -Zed does not collect training data for the Edit Prediction model unless all of +Gwen does not collect training data for the Edit Prediction model unless all of these conditions are met: 1. You opt in by toggling **Training Data Collection** under the **Privacy** @@ -102,7 +102,7 @@ regardless of opt-in status: You can explicitly exclude additional paths or file extensions by adding them to [`edit_predictions.disabled_globs`](https://zed.dev/docs/reference/all-settings#edit-predictions) -in your Zed settings file ([how to edit](../configuring-zed.md#settings-files)): +in your Gwen settings file ([how to edit](../configuring-zed.md#settings-files)): ```json [settings] { @@ -114,7 +114,7 @@ in your Zed settings file ([how to edit](../configuring-zed.md#settings-files)): ### Data Collected from Edit Prediction Training {#data-collected-edit-prediction-training} -For open source projects where you opted in, Zed may collect: +For open source projects where you opted in, Gwen may collect: - code excerpts around your cursor - recent edit diffs @@ -122,7 +122,7 @@ For open source projects where you opted in, Zed may collect: - repository URL and git revision - buffer outline and diagnostics -Collected data is stored in Snowflake. Zed periodically reviews this data to +Collected data is stored in Snowflake. Gwen periodically reviews this data to select training samples for inclusion in the model training dataset. Included data is anonymized and stripped of sensitive information such as access tokens, user IDs, and email addresses. @@ -132,14 +132,14 @@ The training dataset is publicly available at ### Training Dataset and Model Output {#training-dataset-and-model-output} -Zed uses this training dataset to fine-tune +Gwen uses this training dataset to fine-tune [Qwen2.5-Coder-7B](https://huggingface.co/Qwen/Qwen2.5-Coder-7B) and makes the resulting model available at [huggingface.co/zed-industries/zeta](https://huggingface.co/zed-industries/zeta). ## Business Controls {#business-controls} -On Zed Business, data sharing is off by default and controlled by organization +On Gwen Business, data sharing is off by default and controlled by organization administrators. Administrators can prevent members from submitting agent thread feedback or opting into Edit Prediction training data collection. See [Privacy for Business](../business/privacy.md) and @@ -147,4 +147,4 @@ feedback or opting into Edit Prediction training data collection. See ## Applicable Terms {#applicable-terms} -See the [Zed Terms of Service](https://zed.dev/terms) for more. +See the [Gwen Terms of Service](https://zed.dev/terms) for more. diff --git a/docs/src/ai/by-company.md b/docs/src/ai/by-company.md index aaafe4668c..aa0cd336e1 100644 --- a/docs/src/ai/by-company.md +++ b/docs/src/ai/by-company.md @@ -1,36 +1,36 @@ --- -title: AI by Company - Zed -description: Find the right Zed setup path for OpenAI, ChatGPT, Codex, Claude, Gemini, Copilot, Cursor, OpenCode, Pi, Poolside, OpenRouter, Bedrock, local models, and other AI tools. +title: AI by Company - Gwen +description: Find the right Gwen setup path for OpenAI, ChatGPT, Codex, Claude, Gemini, Copilot, Cursor, OpenCode, Pi, Poolside, OpenRouter, Bedrock, local models, and other AI tools. --- # AI by Company -Use this page when you know the company, subscription, provider, agent, or CLI you want to use in Zed. +Use this page when you know the company, subscription, provider, agent, or CLI you want to use in Gwen. For detailed setup, follow the links in the `Setup` column. This page answers routing questions; it does not replace the setup pages. -## Zed {#zed} +## Gwen {#zed} | Path | Support level | What you get | Account / billing | Setup | | -------------------- | -------------- | --------------------------------- | ----------------------- | ---------------------------------------------------- | -| Zed-hosted models | Built into Zed | Hosted models for Zed AI features | Billed through Zed | [Zed-Hosted Models](../account/zed-hosted-models.md) | -| Zeta edit prediction | Built into Zed | Edit predictions while you type | Included by plan limits | [Edit Prediction](./edit-prediction.md) | +| Gwen-hosted models | Built into Gwen | Hosted models for Gwen AI features | Billed through Gwen | [Gwen-Hosted Models](../account/zed-hosted-models.md) | +| Zeta edit prediction | Built into Gwen | Edit predictions while you type | Included by plan limits | [Edit Prediction](./edit-prediction.md) | ## OpenAI / ChatGPT / Codex {#openai-chatgpt-codex} | Path | Support level | What you get | Account / billing | Setup | | -------------------- | ----------------- | ----------------------------------------------------- | --------------------- | ------------------------------------------------------------------------- | -| ChatGPT Subscription | Configured in Zed | Subscription-backed OpenAI models for Zed AI features | ChatGPT Plus or Pro | [Use an Existing Subscription](./use-an-existing-subscription.md#chatgpt) | -| OpenAI API | Configured in Zed | OpenAI models through API access | OpenAI API billing | [Use API Access](./use-api-access.md#openai) | -| Codex via ACP | Hosted in Zed | Codex in an External Agent thread | Owned by Codex/OpenAI | [External Agents](./external-agents.md#codex-cli) | +| ChatGPT Subscription | Configured in Gwen | Subscription-backed OpenAI models for Gwen AI features | ChatGPT Plus or Pro | [Use an Existing Subscription](./use-an-existing-subscription.md#chatgpt) | +| OpenAI API | Configured in Gwen | OpenAI models through API access | OpenAI API billing | [Use API Access](./use-api-access.md#openai) | +| Codex via ACP | Hosted in Gwen | Codex in an External Agent thread | Owned by Codex/OpenAI | [External Agents](./external-agents.md#codex-cli) | | Codex CLI | Run in terminal | Native Codex CLI experience in a Terminal Thread | Owned by Codex/OpenAI | [Terminal Threads](./terminal-threads.md) | ## Anthropic / Claude / Claude Code {#anthropic-claude} | Path | Support level | What you get | Account / billing | Setup | | -------------------- | ----------------- | -------------------------------------------------- | --------------------------------------- | ---------------------------------------------------- | -| Anthropic API | Configured in Zed | Claude models through API access | Anthropic API billing | [Use API Access](./use-api-access.md#anthropic) | -| Claude Agent via ACP | Hosted in Zed | Claude in an External Agent thread | Owned by Claude/Anthropic | [External Agents](./external-agents.md#claude-agent) | +| Anthropic API | Configured in Gwen | Claude models through API access | Anthropic API billing | [Use API Access](./use-api-access.md#anthropic) | +| Claude Agent via ACP | Hosted in Gwen | Claude in an External Agent thread | Owned by Claude/Anthropic | [External Agents](./external-agents.md#claude-agent) | | Claude Code CLI | Run in terminal | Native Claude Code experience in a Terminal Thread | Claude subscription or Claude Code auth | [Terminal Threads](./terminal-threads.md) | Claude Pro and Max subscriptions are separate from Anthropic API credits. If you want Claude subscription-limit behavior, use Claude Agent or Claude Code where supported. See [Use an Existing Subscription](./use-an-existing-subscription.md#claude). @@ -39,78 +39,78 @@ Claude Pro and Max subscriptions are separate from Anthropic API credits. If you | Path | Support level | What you get | Account / billing | Setup | | ------------- | -------------------------------- | ------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------- | -| Google AI API | Configured in Zed | Gemini models through API access | Google AI API billing | [Use API Access](./use-api-access.md#google-ai) | -| Gemini CLI | Hosted in Zed or run in terminal | Gemini CLI as an External Agent or native CLI/TUI | Owned by Gemini CLI | [External Agents](./external-agents.md#gemini-cli), [Terminal Threads](./terminal-threads.md) | +| Google AI API | Configured in Gwen | Gemini models through API access | Google AI API billing | [Use API Access](./use-api-access.md#google-ai) | +| Gemini CLI | Hosted in Gwen or run in terminal | Gemini CLI as an External Agent or native CLI/TUI | Owned by Gemini CLI | [External Agents](./external-agents.md#gemini-cli), [Terminal Threads](./terminal-threads.md) | ## GitHub / Copilot {#github-copilot} | Path | Support level | What you get | Account / billing | Setup | | ----------------------- | ----------------- | ---------------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------- | -| GitHub Copilot Chat | Configured in Zed | Copilot Chat models for Zed AI features | GitHub Copilot/Copilot Chat | [Use an Existing Subscription](./use-an-existing-subscription.md#github-copilot) | -| Copilot edit prediction | Built into Zed | Edit prediction provider option | GitHub Copilot | [Edit Prediction](./edit-prediction.md) | -| Copilot External Agent | Hosted in Zed | Copilot in an External Agent thread, where available | Owned by Copilot | [External Agents](./external-agents.md#copilot) | +| GitHub Copilot Chat | Configured in Gwen | Copilot Chat models for Gwen AI features | GitHub Copilot/Copilot Chat | [Use an Existing Subscription](./use-an-existing-subscription.md#github-copilot) | +| Copilot edit prediction | Built into Gwen | Edit prediction provider option | GitHub Copilot | [Edit Prediction](./edit-prediction.md) | +| Copilot External Agent | Hosted in Gwen | Copilot in an External Agent thread, where available | Owned by Copilot | [External Agents](./external-agents.md#copilot) | | Copilot CLI | Run in terminal | Native CLI experience, where available | Owned by Copilot | [Terminal Threads](./terminal-threads.md) | ## OpenCode / Zen / Go {#opencode} | Path | Support level | What you get | Account / billing | Setup | | ----------------------- | ----------------- | ----------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------ | -| OpenCode provider | Configured in Zed | OpenCode models for Zed AI features | OpenCode API key; Zen or Go affects available models | [Use API Access](./use-api-access.md#opencode) | -| OpenCode External Agent | Hosted in Zed | OpenCode in an External Agent thread, where available | Owned by OpenCode | [External Agents](./external-agents.md#opencode) | +| OpenCode provider | Configured in Gwen | OpenCode models for Gwen AI features | OpenCode API key; Zen or Go affects available models | [Use API Access](./use-api-access.md#opencode) | +| OpenCode External Agent | Hosted in Gwen | OpenCode in an External Agent thread, where available | Owned by OpenCode | [External Agents](./external-agents.md#opencode) | | `opencode` CLI | Run in terminal | Native OpenCode CLI experience | Owned by OpenCode | [Terminal Threads](./terminal-threads.md) | ## Cursor {#cursor} | Path | Support level | What you get | Account / billing | Setup | | --------------------- | --------------- | ------------------------------------------------------ | --------------------------- | ---------------------------------------------- | -| Cursor External Agent | Hosted in Zed | Cursor in an External Agent thread, where available | Cursor account/subscription | [External Agents](./external-agents.md#cursor) | +| Cursor External Agent | Hosted in Gwen | Cursor in an External Agent thread, where available | Cursor account/subscription | [External Agents](./external-agents.md#cursor) | | Cursor CLI/TUI | Run in terminal | Native Cursor command-line experience, where available | Cursor account/subscription | [Terminal Threads](./terminal-threads.md) | -Cursor subscriptions do not configure Zed's LLM provider settings. If you want to use a work Cursor subscription in Zed, use the Cursor External Agent or a Terminal Threads workflow where available. +Cursor subscriptions do not configure Gwen's LLM provider settings. If you want to use a work Cursor subscription in Gwen, use the Cursor External Agent or a Terminal Threads workflow where available. ## Pi Coding Agent {#pi} | Path | Support level | What you get | Account / billing | Setup | | --------------- | --------------- | -------------------------------------------------- | ----------------- | ------------------------------------------ | -| Pi Coding Agent | Hosted in Zed | Pi in an External Agent thread, where available | Owned by Pi | [External Agents](./external-agents.md#pi) | +| Pi Coding Agent | Hosted in Gwen | Pi in an External Agent thread, where available | Owned by Pi | [External Agents](./external-agents.md#pi) | | Pi CLI/TUI | Run in terminal | Native Pi command-line experience, where available | Owned by Pi | [Terminal Threads](./terminal-threads.md) | -Pi is an agent harness, not a Zed LLM subscription. Pi may support provider auth such as ChatGPT, Claude, or Copilot through its own setup flow. +Pi is an agent harness, not a Gwen LLM subscription. Pi may support provider auth such as ChatGPT, Claude, or Copilot through its own setup flow. ## Poolside {#poolside} | Path | Support level | What you get | Account / billing | Setup | | ----------------------- | --------------- | ------------------------------------ | ------------------------------- | ------------------------------------------------ | -| Poolside External Agent | Hosted in Zed | Poolside in an External Agent thread | Poolside or configured provider | [External Agents](./external-agents.md#poolside) | +| Poolside External Agent | Hosted in Gwen | Poolside in an External Agent thread | Poolside or configured provider | [External Agents](./external-agents.md#poolside) | | `pool` CLI | Run in terminal | Native Poolside Agent CLI experience | Poolside or configured provider | [Terminal Threads](./terminal-threads.md) | -Install Poolside from the ACP Registry, configure Zed with the Poolside Agent CLI, or add Poolside as a Custom Agent. See [External Agents](./external-agents.md#poolside) for setup steps and platform-specific details. +Install Poolside from the ACP Registry, configure Gwen with the Poolside Agent CLI, or add Poolside as a Custom Agent. See [External Agents](./external-agents.md#poolside) for setup steps and platform-specific details. ## DeepSeek {#deepseek} | Path | Support level | What you get | Account / billing | Setup | | ------------ | ----------------- | ----------------------------------- | ----------------------------------------------- | ---------------------------------------------- | -| DeepSeek API | Configured in Zed | DeepSeek models for Zed AI features | DeepSeek API credits, top-ups, or usage billing | [Use API Access](./use-api-access.md#deepseek) | +| DeepSeek API | Configured in Gwen | DeepSeek models for Gwen AI features | DeepSeek API credits, top-ups, or usage billing | [Use API Access](./use-api-access.md#deepseek) | -Paid DeepSeek usage is API access in Zed, not subscription sign-in. +Paid DeepSeek usage is API access in Gwen, not subscription sign-in. ## Gateways and Cloud Platforms {#gateways} | Provider | Support level | What you get | Account / billing | Setup | | ----------------- | ----------------- | ------------------------------------ | ------------------ | ----------------------------------------------------- | -| OpenRouter | Configured in Zed | Gateway access to multiple providers | OpenRouter billing | [Use a Gateway](./use-a-gateway.md#openrouter) | -| Vercel AI Gateway | Configured in Zed | Gateway access through Vercel | Vercel billing | [Use a Gateway](./use-a-gateway.md#vercel-ai-gateway) | -| Amazon Bedrock | Configured in Zed | AWS-hosted model access | AWS billing | [Use a Gateway](./use-a-gateway.md#amazon-bedrock) | +| OpenRouter | Configured in Gwen | Gateway access to multiple providers | OpenRouter billing | [Use a Gateway](./use-a-gateway.md#openrouter) | +| Vercel AI Gateway | Configured in Gwen | Gateway access through Vercel | Vercel billing | [Use a Gateway](./use-a-gateway.md#vercel-ai-gateway) | +| Amazon Bedrock | Configured in Gwen | AWS-hosted model access | AWS billing | [Use a Gateway](./use-a-gateway.md#amazon-bedrock) | ## Local Models {#local-models} | Tool | Support level | What you get | Account / billing | Setup | | --------------------------------- | ----------------- | -------------------------------------- | ----------------- | ------------------------------------------------------------- | -| llama.cpp | Configured in Zed | Local models for Zed AI features | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#llama-cpp) | -| LM Studio | Configured in Zed | Local models for Zed AI features | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#lm-studio) | -| Ollama | Configured in Zed | Local models for Zed AI features | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#ollama) | -| Local OpenAI-compatible server | Configured in Zed | Local or self-hosted model endpoint | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#openai-compatible) | -| Local/self-hosted edit prediction | Configured in Zed | Edit predictions from a local provider | Local/self-hosted | [Edit Prediction](./edit-prediction.md) | +| llama.cpp | Configured in Gwen | Local models for Gwen AI features | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#llama-cpp) | +| LM Studio | Configured in Gwen | Local models for Gwen AI features | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#lm-studio) | +| Ollama | Configured in Gwen | Local models for Gwen AI features | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#ollama) | +| Local OpenAI-compatible server | Configured in Gwen | Local or self-hosted model endpoint | Local/self-hosted | [Use a Local Model](./use-a-local-model.md#openai-compatible) | +| Local/self-hosted edit prediction | Configured in Gwen | Edit predictions from a local provider | Local/self-hosted | [Edit Prediction](./edit-prediction.md) | ## Other API Providers {#other-api-providers} diff --git a/docs/src/ai/edit-prediction.md b/docs/src/ai/edit-prediction.md index b49506ac4b..548f555b9a 100644 --- a/docs/src/ai/edit-prediction.md +++ b/docs/src/ai/edit-prediction.md @@ -1,12 +1,12 @@ --- -title: AI Code Completion in Zed - Zeta, Copilot, Codestral, Mercury Coder -description: Set up AI code completions in Zed with Zeta (built-in), GitHub Copilot, Codestral, or Mercury Coder. Multi-line predictions as you type. +title: AI Code Completion in Gwen - Zeta, Copilot, Codestral, Mercury Coder +description: Set up AI code completions in Gwen with Zeta (built-in), GitHub Copilot, Codestral, or Mercury Coder. Multi-line predictions as you type. --- # Edit Prediction -Edit Prediction is how Zed's AI code completions work: an LLM predicts the code you want to write. -As you type, Zed requests predictions from the edit prediction provider, which returns individual or multi-line suggestions you accept by pressing `tab`. +Edit Prediction is how Gwen's AI code completions work: an LLM predicts the code you want to write. +As you type, Gwen requests predictions from the edit prediction provider, which returns individual or multi-line suggestions you accept by pressing `tab`. The default provider is [Zeta, an open source model developed by Zed](https://zed.dev/blog/zeta2), but you can also use [other providers](#other-providers) like GitHub Copilot, Mercury Coder, and Codestral. @@ -19,7 +19,7 @@ For privacy and training data details, see To use Zeta, [sign in](../authentication.md#what-features-require-signing-in). Once signed in, predictions appear as you type. -You can confirm that Zeta is properly configured by opening the [Settings Editor](zed://settings/edit_predictions.providers) (`Cmd+,` on macOS or `Ctrl+,` on Linux/Windows) and searching for `edit_predictions`. The `provider` field should be set to `Zed AI`. +You can confirm that Zeta is properly configured by opening the [Settings Editor](zed://settings/edit_predictions.providers) (`Cmd+,` on macOS or `Ctrl+,` on Linux/Windows) and searching for `edit_predictions`. The `provider` field should be set to `Gwen AI`. Or verify this in your settings.json: @@ -35,7 +35,7 @@ The Z icon in the status bar also indicates Zeta is active. ### Pricing and Plans -The free plan includes 2,000 Zeta predictions per month. The [Pro plan](../account/plans-and-pricing.md) removes this limit. See [Zed's pricing page](https://zed.dev/pricing) for details. +The free plan includes 2,000 Zeta predictions per month. The [Pro plan](../account/plans-and-pricing.md) removes this limit. See [Gwen's pricing page](https://zed.dev/pricing) for details. ### Switching Modes {#switching-modes} @@ -140,15 +140,15 @@ In this case, because the binding contains the modifier `ctrl`, it will be used ### Cleaning Up Older Keymap Entries -If you configured edit prediction keybindings before Zed `v0.229.0`, your `keymap.json` may have entries that are now redundant. +If you configured edit prediction keybindings before Gwen `v0.229.0`, your `keymap.json` may have entries that are now redundant. **Old tab workaround**: Before `unbind` existed, the only way to prevent `tab` from accepting edit predictions was to copy all the default non-edit-prediction `tab` bindings into your keymap alongside a custom `AcceptEditPrediction` binding. If your keymap still contains those copy-pasted entries, delete them and use a single `"unbind"` entry as shown in the examples above. -**Renamed context**: The `edit_prediction_conflict` context has been replaced by `edit_prediction && (showing_completions || in_leading_whitespace)`. Zed automatically migrates any bindings that used `edit_prediction_conflict`, so no changes are required on your end. +**Renamed context**: The `edit_prediction_conflict` context has been replaced by `edit_prediction && (showing_completions || in_leading_whitespace)`. Gwen automatically migrates any bindings that used `edit_prediction_conflict`, so no changes are required on your end. ## Configuring the Prediction Debounce -The prediction debounce controls how long Zed waits after you stop typing before automatically requesting an edit prediction. Configure it in milliseconds under the settings for your selected provider: +The prediction debounce controls how long Gwen waits after you stop typing before automatically requesting an edit prediction. Configure it in milliseconds under the settings for your selected provider: ```json [settings] { @@ -167,7 +167,7 @@ The default debounce depends on the provider: | --------------------- | ------: | | GitHub Copilot | 75 ms | | Codestral | 150 ms | -| Zed | 0 ms | +| Gwen | 0 ms | | Mercury | 0 ms | | Ollama | 0 ms | | OpenAI-compatible API | 0 ms | @@ -214,7 +214,7 @@ To disable edit predictions for specific directories or files, set this in your ```json [settings] { "edit_predictions": { - "disabled_globs": ["~/.config/zed/settings.json"] + "disabled_globs": ["~/.config/gwen/settings.json"] } } ``` @@ -251,7 +251,7 @@ To sign in to GitHub Copilot, click on the Copilot icon in the status bar. A pop #### Using GitHub Copilot Enterprise -If your organization uses GitHub Copilot Enterprise, you can configure Zed to use your enterprise instance by specifying the enterprise URI in your settings file ([how to edit](../configuring-zed.md#settings-files)): +If your organization uses GitHub Copilot Enterprise, you can configure Gwen to use your enterprise instance by specifying the enterprise URI in your settings file ([how to edit](../configuring-zed.md#settings-files)): ```json [settings] { @@ -265,7 +265,7 @@ If your organization uses GitHub Copilot Enterprise, you can configure Zed to us Replace `"https://your.enterprise.domain"` with the URL provided by your GitHub Enterprise administrator (e.g., `https://foo.ghe.com`). -Once set, Zed routes Copilot requests through your enterprise endpoint. +Once set, Gwen routes Copilot requests through your enterprise endpoint. When you sign in by clicking the Copilot icon in the status bar, you are redirected to your configured enterprise URL to complete authentication. All other Copilot features and usage remain the same. @@ -373,7 +373,7 @@ The `prompt_format` setting controls how code context is formatted for the model - `sweep` - [Sweep rewrite-window](https://blog.sweep.dev/posts/oss-next-edit) format using `<|file_sep|>` file blocks for related files, `original/...`, `current/...`, and `updated/...`. - `infer` - Auto-detect from model name (default) -With `"prompt_format": "infer"`, Zed automatically uses Zeta 2 format for models named `zeta2` and Zeta 2.1 format for models named `zeta2.1`. +With `"prompt_format": "infer"`, Gwen automatically uses Zeta 2 format for models named `zeta2` and Zeta 2.1 format for models named `zeta2.1`. For example, to use Zeta 2 with Ollama: diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md index a9f5f5e8dc..544676e0b1 100644 --- a/docs/src/ai/external-agents.md +++ b/docs/src/ai/external-agents.md @@ -1,21 +1,21 @@ --- -title: External Agents - Zed -description: Install and use ACP-integrated External Agents such as Claude, Codex, OpenCode, Copilot, Cursor, and Pi Coding Agent in Zed. +title: External Agents - Gwen +description: Install and use ACP-integrated External Agents such as Claude, Codex, OpenCode, Copilot, Cursor, and Pi Coding Agent in Gwen. --- # External Agents -External Agents are agents that integrate with Zed through the [Agent Client Protocol (ACP)](https://agentclientprotocol.com). Zed hosts the thread in the [Agent Panel](./agent-panel.md) and [Threads Sidebar](./parallel-agents.md#threads-sidebar), while the External Agent usually owns its own runtime, auth, model selection, tools, and native configuration. +External Agents are agents that integrate with Gwen through the [Agent Client Protocol (ACP)](https://agentclientprotocol.com). Gwen hosts the thread in the [Agent Panel](./agent-panel.md) and [Threads Sidebar](./parallel-agents.md#threads-sidebar), while the External Agent usually owns its own runtime, auth, model selection, tools, and native configuration. Use [Terminal Threads](./terminal-threads.md) instead when you want to run a CLI or TUI directly in a terminal-backed thread. -External Agents run through their own process and provider relationship. Billing, legal terms, retention, and data handling are between you and the agent provider. Zed does not charge for External Agents. +External Agents run through their own process and provider relationship. Billing, legal terms, retention, and data handling are between you and the agent provider. Gwen does not charge for External Agents. -For Zed-hosted models and Zed-managed AI features, see [AI Privacy](./privacy-and-security.md) and [Feedback and Training Data](./ai-improvement.md). +For Gwen-hosted models and Gwen-managed AI features, see [AI Privacy](./privacy-and-security.md) and [Feedback and Training Data](./ai-improvement.md). ## Install from the ACP Registry {#registry} -The ACP Registry is the primary way to install common External Agents in Zed. +The ACP Registry is the primary way to install common External Agents in Gwen. Open the registry with {#action zed::AcpRegistry}, or open [Agent Settings](./agent-settings.md) with {#action agent::OpenSettings}, go to the **External Agents** page, click `Add Agent`, and choose `Install from Registry`. @@ -32,63 +32,63 @@ Common External Agents include: - Cursor - Pi Coding Agent -This list is curated, not exhaustive. Open the ACP Registry in Zed for the current list of available agents. +This list is curated, not exhaustive. Open the ACP Registry in Gwen for the current list of available agents. For company-specific setup paths, including Claude, Codex, Gemini, OpenCode, Copilot, Cursor, Pi, and Poolside, see [AI by Company](./by-company.md). ## Claude Agent {#claude-agent} -Use Claude Agent when you want Claude running as an ACP-integrated External Agent in Zed. +Use Claude Agent when you want Claude running as an ACP-integrated External Agent in Gwen. -Install Claude Agent from the [ACP Registry](#registry), then start a Claude Agent thread from the Agent Panel or Threads Sidebar. Claude Agent owns its own authentication and billing. An Anthropic API key configured for [Zed Agent](./zed-agent.md) does not automatically configure Claude Agent. +Install Claude Agent from the [ACP Registry](#registry), then start a Claude Agent thread from the Agent Panel or Threads Sidebar. Claude Agent owns its own authentication and billing. An Anthropic API key configured for [Gwen Agent](./zed-agent.md) does not automatically configure Claude Agent. To choose your billing method, open a Claude Agent thread, run `/login`, and authenticate with an API key or with Claude Code where supported. Claude-specific files such as `CLAUDE.md` may be read by Claude Agent directly. ## Codex {#codex-cli} -Use Codex when you want Codex running as an ACP-integrated External Agent in Zed. +Use Codex when you want Codex running as an ACP-integrated External Agent in Gwen. -Install Codex from the [ACP Registry](#registry), then start a Codex thread from the Agent Panel or Threads Sidebar. Codex owns its own authentication and billing. An OpenAI API key configured for [Zed Agent](./zed-agent.md) does not automatically configure Codex. +Install Codex from the [ACP Registry](#registry), then start a Codex thread from the Agent Panel or Threads Sidebar. Codex owns its own authentication and billing. An OpenAI API key configured for [Gwen Agent](./zed-agent.md) does not automatically configure Codex. Codex may support ChatGPT login, Codex API keys, OpenAI API keys, or Codex-native configuration depending on the installed version and environment. To change authentication, use the Codex thread's native login/logout flow. ## Gemini CLI {#gemini-cli} -Use Gemini CLI when you want Gemini running as an ACP-integrated External Agent in Zed. +Use Gemini CLI when you want Gemini running as an ACP-integrated External Agent in Gwen. Install Gemini CLI from the [ACP Registry](#registry), then start a Gemini CLI thread from the Agent Panel or Threads Sidebar. Gemini CLI owns its own authentication and may prompt you to log in with Google, Vertex AI, or another Gemini-supported flow. -If `GEMINI_API_KEY` or `GOOGLE_AI_API_KEY` is available to the agent process, Gemini CLI uses that key. Otherwise, if you have configured an API key for Zed's Google AI provider, Zed passes that key to Gemini CLI as `GEMINI_API_KEY`. +If `GEMINI_API_KEY` or `GOOGLE_AI_API_KEY` is available to the agent process, Gemini CLI uses that key. Otherwise, if you have configured an API key for Gwen's Google AI provider, Gwen passes that key to Gemini CLI as `GEMINI_API_KEY`. ## OpenCode {#opencode} -Use OpenCode when you want OpenCode running as an ACP-integrated External Agent in Zed. +Use OpenCode when you want OpenCode running as an ACP-integrated External Agent in Gwen. -Install OpenCode from the [ACP Registry](#registry), then start an OpenCode thread from the Agent Panel or Threads Sidebar. OpenCode owns its own auth, model selection, and subscription behavior. To use OpenCode models in Zed Agent instead, configure [OpenCode API access](./use-api-access.md#opencode). +Install OpenCode from the [ACP Registry](#registry), then start an OpenCode thread from the Agent Panel or Threads Sidebar. OpenCode owns its own auth, model selection, and subscription behavior. To use OpenCode models in Gwen Agent instead, configure [OpenCode API access](./use-api-access.md#opencode). ## Copilot {#copilot} -Use Copilot External Agents where available when you want Copilot running as an ACP-integrated External Agent in Zed. +Use Copilot External Agents where available when you want Copilot running as an ACP-integrated External Agent in Gwen. -Copilot agent auth is owned by the Copilot integration. To use Copilot Chat models in Zed Agent or Copilot for edit prediction, see [Use an Existing Subscription](./use-an-existing-subscription.md#github-copilot). +Copilot agent auth is owned by the Copilot integration. To use Copilot Chat models in Gwen Agent or Copilot for edit prediction, see [Use an Existing Subscription](./use-an-existing-subscription.md#github-copilot). ## Cursor {#cursor} -Use Cursor External Agents where available when you want Cursor running as an ACP-integrated External Agent in Zed. +Use Cursor External Agents where available when you want Cursor running as an ACP-integrated External Agent in Gwen. -Cursor subscriptions do not configure Zed's LLM provider settings. Use Cursor's external-agent or CLI/TUI setup where available. +Cursor subscriptions do not configure Gwen's LLM provider settings. Use Cursor's external-agent or CLI/TUI setup where available. ## Pi Coding Agent {#pi} -Use Pi Coding Agent when you want Pi running as an ACP-integrated External Agent in Zed. +Use Pi Coding Agent when you want Pi running as an ACP-integrated External Agent in Gwen. -Pi is an agent harness, not a Zed LLM subscription. Configure any provider auth, subscriptions, tools, or model choices in Pi. +Pi is an agent harness, not a Gwen LLM subscription. Configure any provider auth, subscriptions, tools, or model choices in Pi. ## Poolside {#poolside} -Use Poolside when you want Poolside running as an ACP-integrated External Agent in Zed. +Use Poolside when you want Poolside running as an ACP-integrated External Agent in Gwen. -Install Poolside from the [ACP Registry](#registry), then start a Poolside thread from the Agent Panel or Threads Sidebar. If you haven't authenticated yet, the thread offers `Log in to Poolside`, which runs `pool login` in a terminal. Authentication and model selection are configured through Poolside, not Zed. +Install Poolside from the [ACP Registry](#registry), then start a Poolside thread from the Agent Panel or Threads Sidebar. If you haven't authenticated yet, the thread offers `Log in to Poolside`, which runs `pool login` in a terminal. Authentication and model selection are configured through Poolside, not Gwen. To configure Poolside from the terminal instead, install the [Poolside Agent CLI](https://github.com/poolsideai/pool), then run: @@ -96,7 +96,7 @@ To configure Poolside from the terminal instead, install the [Poolside Agent CLI pool acp setup --editor zed ``` -This command always writes to `~/.config/zed/settings.json`, which is Zed's settings file on macOS and on Linux without a custom `XDG_CONFIG_HOME`. On Windows, or with a custom config directory, install from the registry or use the manual configuration below instead. You do not need to restart Zed. It detects the settings change automatically. Select `Poolside` from the new-thread menu. +This command always writes to `~/.config/zed/settings.json`, the upstream Zed settings path, which Gwen does not read. On Gwen, install from the registry or use the manual configuration below instead. You do not need to restart Gwen. It detects the settings change automatically. Select `Poolside` from the new-thread menu. To configure it manually, install the [Poolside Agent CLI](https://github.com/poolsideai/pool), make sure `pool` is on your `PATH`, then add it as a [Custom Agent](#custom-agents): @@ -112,7 +112,7 @@ To configure it manually, install the [Poolside Agent CLI](https://github.com/po } ``` -See [Poolside's Zed documentation](https://docs.poolside.ai/tools/zed) for more setup details. +See [Poolside's Gwen documentation](https://docs.poolside.ai/tools/zed) for more setup details. ## Start an External Agent Thread {#start-thread} @@ -122,20 +122,20 @@ You can also create keybindings for specific agents with {#action agent::NewExte ## Configuration Boundaries {#configuration-boundaries} -External Agents run as separate processes that communicate with Zed over ACP. This creates a boundary between Zed configuration and agent-native configuration. +External Agents run as separate processes that communicate with Gwen over ACP. This creates a boundary between Gwen configuration and agent-native configuration. | Capability | Behavior in External Agent threads | | ----------------------------------------- | ------------------------------------------------------------------------------------------ | | Model/provider config | Usually owned by the External Agent | | Auth/API keys/subscriptions | Usually owned by the External Agent | -| [Zed Agent profiles](./agent-profiles.md) | Do not apply unless the integration says otherwise | -| Zed Skills | Do not apply as Zed Skills | +| [Gwen Agent profiles](./agent-profiles.md) | Do not apply unless the integration says otherwise | +| Gwen Skills | Do not apply as Gwen Skills | | Native agent skills/instructions | Depends on the agent | -| Zed MCP servers | May be forwarded over ACP | +| Gwen MCP servers | May be forwarded over ACP | | Native MCP config | May also be read by the agent | -| Tool permissions | Zed ACP/tool forwarding permissions may apply; native tool permissions depend on the agent | +| Tool permissions | Gwen ACP/tool forwarding permissions may apply; native tool permissions depend on the agent | -For Zed's native agent configuration, see [Zed Agent](./zed-agent.md). +For Gwen's native agent configuration, see [Gwen Agent](./zed-agent.md). ## Agent-Specific Auth and Config {#agent-auth-config} @@ -145,22 +145,22 @@ Examples: - Claude Agent may use Claude Code auth and Claude-native config. - Codex may use ChatGPT login, Codex API keys, OpenAI API keys, or Codex-native config. -- Cursor subscriptions do not configure Zed's LLM provider settings; use Cursor's agent or CLI setup where available. +- Cursor subscriptions do not configure Gwen's LLM provider settings; use Cursor's agent or CLI setup where available. - Pi Coding Agent is an agent harness. Configure provider auth in Pi. -If an External Agent supports subscription-backed behavior, configure that in the agent unless the agent's Zed integration says otherwise. +If an External Agent supports subscription-backed behavior, configure that in the agent unless the agent's Gwen integration says otherwise. ## Remote Projects {#remote-projects} External Agents may read credentials locally, remotely, or through their own sign-in flow. Check the specific agent's setup path when using SSH, dev containers, or other remote projects. -Zed LLM provider API keys saved in the local keychain are not automatically the same as an External Agent's credentials. +Gwen LLM provider API keys saved in the local keychain are not automatically the same as an External Agent's credentials. ## Custom Agents {#custom-agents} Use custom agents when you are developing an ACP-compatible agent or need to run an agent that is not in the registry. -Open [Agent Settings](./agent-settings.md), go to the **External Agents** page, click `Add Agent`, and choose `Add Custom Agent`. Zed opens your settings file with an `agent_servers` entry. +Open [Agent Settings](./agent-settings.md), go to the **External Agents** page, click `Add Agent`, and choose `Add Custom Agent`. Gwen opens your settings file with an `agent_servers` entry. ```json [settings] { @@ -185,22 +185,22 @@ For details, see [Agent Server Extensions](../extensions/agent-servers.md). ## Importing Threads {#importing-threads} -Zed can import existing threads from configured External Agents so they appear in your [Thread History](./agent-panel.md#multiple-threads) alongside the rest of your threads. +Gwen can import existing threads from configured External Agents so they appear in your [Thread History](./agent-panel.md#multiple-threads) alongside the rest of your threads. Open the Threads Sidebar with {#kb multi_workspace::ToggleWorkspaceSidebar}, then open Thread History by clicking the clock icon at the bottom of the sidebar or running {#action agents_sidebar::ToggleThreadHistory} from the Command Palette. Click **Import Threads**, choose the agents you want to import from, then click **Import Threads** again. -Zed connects to each selected agent over ACP and adds sessions that are not already in your history. Imported threads are archived entries; open one to restore it and continue where you left off. +Gwen connects to each selected agent over ACP and adds sessions that are not already in your history. Imported threads are archived entries; open one to restore it and continue where you left off. Only configured External Agents appear in the import dialog. Sessions without an associated working directory are skipped, and re-importing is safe because threads already in your history are skipped. ## MCP {#mcp} -Zed-configured [MCP servers](./mcp.md) may be forwarded to External Agents over ACP. External Agents may also read their own native MCP configuration. +Gwen-configured [MCP servers](./mcp.md) may be forwarded to External Agents over ACP. External Agents may also read their own native MCP configuration. -If an MCP tool does not appear in an External Agent, check both Zed's MCP server configuration and the agent's native MCP configuration. +If an MCP tool does not appear in an External Agent, check both Gwen's MCP server configuration and the agent's native MCP configuration. ## Debugging {#debugging-agents} -Use {#action dev::OpenAcpLogs} from the Command Palette to inspect messages between Zed and an External Agent. +Use {#action dev::OpenAcpLogs} from the Command Palette to inspect messages between Gwen and an External Agent. Include ACP logs when reporting issues with External Agents. diff --git a/docs/src/ai/inline-assistant.md b/docs/src/ai/inline-assistant.md index bb9cbdf367..767f5eb529 100644 --- a/docs/src/ai/inline-assistant.md +++ b/docs/src/ai/inline-assistant.md @@ -1,6 +1,6 @@ --- -title: Inline AI Code Editing - Zed -description: Transform code inline with AI in Zed. Send selections to any LLM for refactoring, generation, or editing with multi-cursor support. +title: Inline AI Code Editing - Gwen +description: Transform code inline with AI in Gwen. Send selections to any LLM for refactoring, generation, or editing with multi-cursor support. --- # Inline Assistant @@ -16,12 +16,12 @@ The Inline Assistant sends your current selection (or line) to a language model If you're using the Inline Assistant for the first time, you need to have at least one [LLM provider](./llm-providers.md) configured. You can do that by: -1. [using Zed-hosted models](../account/zed-hosted-models.md), so you have access to models billed through Zed +1. [using Gwen-hosted models](../account/zed-hosted-models.md), so you have access to models billed through Gwen 2. [using API access](./use-api-access.md), either from model providers like Anthropic or model gateways like OpenRouter. If you have already set up an LLM provider to interact with [the Agent Panel](./agent-panel.md#getting-started), then that will also work for the Inline Assistant. -[External Agents](./external-agents.md) run in agent threads, but they are not available for Inline Assistant generations. The Inline Assistant uses Zed-configured [LLM providers](./llm-providers.md), including Zed-hosted models, provider API keys, gateways, [local models](./use-a-local-model.md), and supported subscriptions. +[External Agents](./external-agents.md) run in agent threads, but they are not available for Inline Assistant generations. The Inline Assistant uses Gwen-configured [LLM providers](./llm-providers.md), including Gwen-hosted models, provider API keys, gateways, [local models](./use-a-local-model.md), and supported subscriptions. ## Adding Context @@ -98,7 +98,7 @@ One with Claude Sonnet 4.5 (the default model), another with GPT-5-mini, and ano Both features generate inline code, but they work differently: - **Inline Assistant**: You write a prompt and select what to transform. You control the context. -- **[Edit Prediction](./edit-prediction.md)**: Zed automatically suggests edits based on your recent changes, visited files, and cursor position. No prompting required. +- **[Edit Prediction](./edit-prediction.md)**: Gwen automatically suggests edits based on your recent changes, visited files, and cursor position. No prompting required. The key difference: Inline Assistant is explicit and prompt-driven; Edit Prediction is automatic and context-inferred. diff --git a/docs/src/ai/instructions.md b/docs/src/ai/instructions.md index 39bbda7c9f..41d6b7dd4b 100644 --- a/docs/src/ai/instructions.md +++ b/docs/src/ai/instructions.md @@ -1,31 +1,31 @@ --- -title: Agent Instructions - Zed -description: Configure always-on personal and project instructions for Zed Agent with AGENTS.md and compatible project instruction files. +title: Agent Instructions - Gwen +description: Configure always-on personal and project instructions for Gwen Agent with AGENTS.md and compatible project instruction files. --- # Instructions -Instructions are always-on context for the Zed Agent. Use instructions for persistent guidance that should apply to every relevant agent interaction. +Instructions are always-on context for the Gwen Agent. Use instructions for persistent guidance that should apply to every relevant agent interaction. Use [Skills](./skills.md) instead when you want reusable task instructions that can be invoked by name. -Zed supports [`AGENTS.md`](https://agents.md/) as the primary instruction file for personal and project-level agent guidance. +Gwen supports [`AGENTS.md`](https://agents.md/) as the primary instruction file for personal and project-level agent guidance. ## Personal Instructions {#personal-instructions} -Personal instructions apply to every project you open with the Zed Agent. +Personal instructions apply to every project you open with the Gwen Agent. Create or edit: ```text -~/.config/zed/AGENTS.md +~/.config/gwen/AGENTS.md ``` -On Windows, the equivalent file is under `%APPDATA%\Zed\AGENTS.md`. +On Windows, the equivalent file is under `%APPDATA%\Gwen\AGENTS.md`. ## Project Instructions {#project-instructions} -Project instruction files apply to the current project. Zed uses the first matching file in this list: +Project instruction files apply to the current project. Gwen uses the first matching file in this list: - `.rules` - `.cursorrules` @@ -41,14 +41,14 @@ Project instructions override personal `AGENTS.md` when they conflict. ## Instruction File Support {#support} -| File | [Zed Agent](./zed-agent.md) | [External Agents](./external-agents.md) | Terminal Threads | +| File | [Gwen Agent](./zed-agent.md) | [External Agents](./external-agents.md) | Terminal Threads | | --------------------------------- | ------------------------------------------------------ | --------------------------------------- | -------------------------------- | -| `~/.config/zed/AGENTS.md` | Loaded as personal instructions | Not generally used | Not used unless the CLI reads it | +| `~/.config/gwen/AGENTS.md` | Loaded as personal instructions | Not generally used | Not used unless the CLI reads it | | Project `AGENTS.md` | Loaded as project instructions | Depends on the agent | Depends on the CLI | -| `CLAUDE.md` | Loaded as compatible project instructions by Zed Agent | Claude reads natively | Claude Code CLI reads natively | -| `.github/copilot-instructions.md` | Loaded as compatible project instructions by Zed Agent | Depends on the agent | Depends on the CLI | +| `CLAUDE.md` | Loaded as compatible project instructions by Gwen Agent | Claude reads natively | Claude Code CLI reads natively | +| `.github/copilot-instructions.md` | Loaded as compatible project instructions by Gwen Agent | Depends on the agent | Depends on the CLI | -External Agents and [Terminal Threads](./terminal-threads.md) may read their own native instruction files directly. Do not assume Zed's instruction loader controls those agents. +External Agents and [Terminal Threads](./terminal-threads.md) may read their own native instruction files directly. Do not assume Gwen's instruction loader controls those agents. ## Instructions vs. Skills {#instructions-vs-skills} diff --git a/docs/src/ai/llm-providers.md b/docs/src/ai/llm-providers.md index f85966b49c..eb3e8cddc2 100644 --- a/docs/src/ai/llm-providers.md +++ b/docs/src/ai/llm-providers.md @@ -1,12 +1,12 @@ --- -title: LLM Providers - Zed -description: Choose how Zed gets language models: Zed-hosted models, API access, subscriptions, gateways, or local models. +title: LLM Providers - Gwen +description: Choose how Gwen gets language models: Gwen-hosted models, API access, subscriptions, gateways, or local models. --- # LLM Providers -Use this page to choose which models power [the Zed Agent](./zed-agent.md) and -other Zed-owned AI features, including [Inline Assistant](./inline-assistant.md), +Use this page to choose which models power [the Gwen Agent](./zed-agent.md) and +other Gwen-owned AI features, including [Inline Assistant](./inline-assistant.md), Git commit generation, thread summaries, and similar model-backed features. Model access paths do not configure [External Agents](./external-agents.md) or @@ -17,18 +17,18 @@ usually own their own model access, auth, and configuration. | Model access path | Best when | Source of truth | | ----------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------- | -| [Use Zed-Hosted Models](../account/zed-hosted-models.md) | You want models billed through Zed | Account & Billing > Zed-Hosted Models | +| [Use Gwen-Hosted Models](../account/zed-hosted-models.md) | You want models billed through Gwen | Account & Billing > Gwen-Hosted Models | | [Use API Access](./use-api-access.md) | You have provider API access, credits, or usage billing | Use API Access | | [Use an Existing Subscription](./use-an-existing-subscription.md) | You already pay for ChatGPT, Claude, Copilot, or another subscription | Use an Existing Subscription | | [Use a Gateway](./use-a-gateway.md) | You route through OpenRouter, Bedrock, Vercel, or a similar platform | Use a Gateway | | [Use a Local Model](./use-a-local-model.md) | You run models locally or self-hosted | Use a Local Model | Use the setup pages for provider-specific details. See [Agents](./agents.md) for -the difference between the Zed Agent, External Agents, and Terminal Threads. +the difference between the Gwen Agent, External Agents, and Terminal Threads. ## Edit Prediction {#edit-prediction} -[Edit Prediction](./edit-prediction.md) has its own provider setup under `edit_predictions`. LLM providers on this page apply to model-backed Zed AI features such as Zed Agent, Inline Assistant, Git commit generation, and thread summaries. +[Edit Prediction](./edit-prediction.md) has its own provider setup under `edit_predictions`. LLM providers on this page apply to model-backed Gwen AI features such as Gwen Agent, Inline Assistant, Git commit generation, and thread summaries. ## Anthropic-Compatible Providers {#anthropic-api-compatible} diff --git a/docs/src/ai/mcp.md b/docs/src/ai/mcp.md index 193d2b3103..4a01ed00da 100644 --- a/docs/src/ai/mcp.md +++ b/docs/src/ai/mcp.md @@ -1,39 +1,39 @@ --- -title: Model Context Protocol (MCP) in Zed -description: Install and configure MCP servers in Zed to extend your AI agent with external tools, data sources, and integrations. +title: Model Context Protocol (MCP) in Gwen +description: Install and configure MCP servers in Gwen to extend your AI agent with external tools, data sources, and integrations. --- # Model Context Protocol -Zed uses the [Model Context Protocol](https://modelcontextprotocol.io/) to interact with context servers. +Gwen uses the [Model Context Protocol](https://modelcontextprotocol.io/) to interact with context servers. > The Model Context Protocol (MCP) is an open protocol for connecting LLM applications to external tools and data sources through a standard interface. ## Supported Features -Zed currently supports MCP's [Tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) and [Prompts](https://modelcontextprotocol.io/specification/2025-11-25/server/prompts) features. -We welcome contributions that help advance Zed's MCP feature coverage (Discovery, Sampling, Elicitation, etc). +Gwen currently supports MCP's [Tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) and [Prompts](https://modelcontextprotocol.io/specification/2025-11-25/server/prompts) features. +We welcome contributions that help advance Gwen's MCP feature coverage (Discovery, Sampling, Elicitation, etc). -Zed also handles the `notifications/tools/list_changed` notification from MCP servers. When a server adds, removes, or modifies its available tools at runtime, Zed automatically reloads the tool list without requiring a server restart. +Gwen also handles the `notifications/tools/list_changed` notification from MCP servers. When a server adds, removes, or modifies its available tools at runtime, Gwen automatically reloads the tool list without requiring a server restart. ## Agent Path Support {#agent-path-support} | Agent path | MCP behavior | | ----------------------------------------- | --------------------------------------------------------------------------------------- | -| [Zed Agent](./zed-agent.md) | Uses Zed-configured MCP servers directly | -| [External Agents](./external-agents.md) | Zed can forward configured MCP servers over ACP; agents may also read native MCP config | +| [Gwen Agent](./zed-agent.md) | Uses Gwen-configured MCP servers directly | +| [External Agents](./external-agents.md) | Gwen can forward configured MCP servers over ACP; agents may also read native MCP config | | [Terminal Threads](./terminal-threads.md) | Native CLIs/TUIs read their own MCP configuration | ## Installing MCP Servers ### As Extensions -One of the ways you can use MCP servers in Zed is by exposing them as an extension. +One of the ways you can use MCP servers in Gwen is by exposing them as an extension. Check out the [MCP Server Extensions](../extensions/mcp-extensions.md) page to learn how to create your own. Many MCP servers are available as extensions. Find them via: -1. [the Zed website](https://zed.dev/extensions?filter=context-servers) +1. [the Gwen website](https://zed.dev/extensions?filter=context-servers) 2. in the app, open the Command Palette and run the {#action zed::Extensions} action 3. in the app, open **Settings → AI → MCP Servers**, click `Add Server`, and choose `Install from Extensions` @@ -50,7 +50,7 @@ Popular servers available as an extension include: ### As Custom Servers -Creating an extension is not the only way to use MCP servers in Zed. +Creating an extension is not the only way to use MCP servers in Gwen. You can connect both local and remote MCP servers from **[Settings → AI → MCP Servers](./agent-settings.md)** (also accessible via the {#action agent::OpenSettings} action, then selecting `MCP Servers`). Click `Add Server` in the page header, then choose `Add Local Server` or `Add Remote Server`. Your specified configuration will create entries in your settings file (which you can open with {#action zed::OpenSettingsFile}) similar to the ones below: ```json [settings] @@ -72,7 +72,7 @@ You can connect both local and remote MCP servers from **[Settings → AI → MC } ``` -> Note: When a remote MCP server has no configured `"Authorization"` header, Zed will prompt you to authenticate yourself against the MCP server using the standard MCP OAuth flow. +> Note: When a remote MCP server has no configured `"Authorization"` header, Gwen will prompt you to authenticate yourself against the MCP server using the standard MCP OAuth flow. ## Using MCP Servers @@ -80,7 +80,7 @@ You can connect both local and remote MCP servers from **[Settings → AI → MC Most MCP servers require configuration after installation. -In the case of an extension, after installing it, Zed will pop up a modal displaying what is required for you to properly set it up. +In the case of an extension, after installing it, Gwen will pop up a modal displaying what is required for you to properly set it up. For example, the GitHub MCP extension requires you to add a [Personal Access Token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). In the case of custom servers, make sure you check the provider documentation to determine what type of command, arguments, and environment variables need to be added to the JSON. @@ -143,10 +143,10 @@ As an example, [the Dagger team suggests](https://container-use.com/agent-integr ### Tool Permissions -> **Note:** In Zed v0.224.0 and above, tool approval is controlled by `agent.tool_permissions.default`. +> **Note:** In Gwen v0.224.0 and above, tool approval is controlled by `agent.tool_permissions.default`. > In earlier versions, it was controlled by the `agent.always_allow_tool_actions` boolean (default `false`). -Zed's Agent Panel provides the `agent.tool_permissions.default` setting to control tool approval behavior for the native Zed agent: +Gwen's Agent Panel provides the `agent.tool_permissions.default` setting to control tool approval behavior for the native Gwen agent: - `"confirm"` (default) — Prompts for approval before running any tool action, including MCP tool calls - `"allow"` — Auto-approves tool actions without prompting @@ -160,9 +160,9 @@ Learn more about [how tool permissions work](./tool-permissions.md), how to furt ### External Agents -MCP servers configured in Zed are forwarded to [External Agents](./external-agents.md) via the [Agent Client Protocol](https://agentclientprotocol.com/). External Agents can also access MCP servers from their own native configuration files. +MCP servers configured in Gwen are forwarded to [External Agents](./external-agents.md) via the [Agent Client Protocol](https://agentclientprotocol.com/). External Agents can also access MCP servers from their own native configuration files. -For details on what configuration is shared between Zed and External Agents, see [Configuration Boundaries](./external-agents.md#configuration-boundaries). +For details on what configuration is shared between Gwen and External Agents, see [Configuration Boundaries](./external-agents.md#configuration-boundaries). ### Error Handling diff --git a/docs/src/ai/overview.md b/docs/src/ai/overview.md index a1ddb760fd..e6c278a70d 100644 --- a/docs/src/ai/overview.md +++ b/docs/src/ai/overview.md @@ -1,27 +1,27 @@ --- -title: AI in Zed -description: Understand Zed's AI features, agent paths, model providers, and setup routes. +title: AI in Gwen +description: Understand Gwen's AI features, agent paths, model providers, and setup routes. --- # AI -Zed's AI docs are organized around three areas: +Gwen's AI docs are organized around three areas: | Area | Use it to choose | Examples | | ------------ | ----------------------------------- | ------------------------------------------------------------------------------------------ | -| Agents | How agentic work runs in Zed | Zed Agent, External Agents, Terminal Threads | -| Model access | How Zed connects to language models | Zed-hosted models, API access, subscriptions, [gateways](./use-a-gateway.md), local models | +| Agents | How agentic work runs in Gwen | Gwen Agent, External Agents, Terminal Threads | +| Model access | How Gwen connects to language models | Gwen-hosted models, API access, subscriptions, [gateways](./use-a-gateway.md), local models | | Features | Which AI workflow you want to use | Agentic editing, inline edits, edit prediction, Git assistance | Start with [AI Quick Start](./quick-start.md) if you know what you want to do. Use [AI by Company](./by-company.md) if you know the company, subscription, model provider, agent, or CLI you want to use. ## Agent Paths {#agent-paths} -Agent paths decide how agentic work runs in Zed. +Agent paths decide how agentic work runs in Gwen. -- [Zed Agent](./zed-agent.md): Zed's native agent. It can use models configured through [LLM Providers](./llm-providers.md), including [Zed-hosted models](../account/zed-hosted-models.md), provider API keys, supported subscriptions, gateways, and [local models](./use-a-local-model.md). It also uses built-in tools, profiles, skills, instructions, and MCP servers. +- [Gwen Agent](./zed-agent.md): Gwen's native agent. It can use models configured through [LLM Providers](./llm-providers.md), including [Gwen-hosted models](../account/zed-hosted-models.md), provider API keys, supported subscriptions, gateways, and [local models](./use-a-local-model.md). It also uses built-in tools, profiles, skills, instructions, and MCP servers. - [External Agents](./external-agents.md): ACP-integrated agents that run through their own process and configuration. -- [Terminal Threads](./terminal-threads.md): terminal-backed threads for running an agent CLI or TUI directly in Zed. +- [Terminal Threads](./terminal-threads.md): terminal-backed threads for running an agent CLI or TUI directly in Gwen. The [Threads Sidebar](./parallel-agents.md#threads-sidebar) is where you organize agent work. You can run multiple agent threads and Terminal Threads at once, each using a different agent and working against different projects. @@ -29,13 +29,13 @@ See [Agents](./agents.md) for a comparison. ## Model Access {#model-access} -Model access controls which models power the Zed Agent and other model-backed Zed AI features. Zed can use hosted models, [provider API access](./use-api-access.md), subscription sign-in, gateways, and local models. +Model access controls which models power the Gwen Agent and other model-backed Gwen AI features. Gwen can use hosted models, [provider API access](./use-api-access.md), subscription sign-in, gateways, and local models. See [LLM Providers](./llm-providers.md) to choose a model access path. ## AI Features {#ai-features} -Zed has several AI-powered workflows: +Gwen has several AI-powered workflows: - [Agent Panel](./agent-panel.md): prompt agents, add context, review changes, and manage active threads. - [Parallel Agents](./parallel-agents.md): run multiple threads across projects and worktrees. diff --git a/docs/src/ai/parallel-agents.md b/docs/src/ai/parallel-agents.md index a23c1d4b86..716d66e37f 100644 --- a/docs/src/ai/parallel-agents.md +++ b/docs/src/ai/parallel-agents.md @@ -1,5 +1,5 @@ --- -title: Parallel Agents - Zed +title: Parallel Agents - Gwen description: Run multiple agent threads and Terminal Threads concurrently using the Threads Sidebar, manage them across projects, and isolate work using Git worktrees. --- @@ -37,7 +37,7 @@ To remove a thread from the sidebar, you can archive it by hovering over it and The Thread History view holds all your threads, including ones that you have archived. Toggle it with {#kb agents_sidebar::ToggleThreadHistory} or by clicking the clock icon in the sidebar bottom bar, next to the sidebar toggle. -To restore a thread, open Thread History and click the thread you want to bring back. Zed moves it back to the thread list and opens it in the Agent Panel. If the thread was running in a Git worktree that was removed, Zed restores the worktree automatically. +To restore a thread, open Thread History and click the thread you want to bring back. Gwen moves it back to the thread list and opens it in the Agent Panel. If the thread was running in a Git worktree that was removed, Gwen restores the worktree automatically. To permanently delete a thread, open Thread History, hover over the thread, and click the trash icon. This removes the thread's conversation history and cleans up any associated worktree data. Deleted threads cannot be recovered. @@ -45,7 +45,7 @@ You can search your threads in history; search will fuzzy match on thread titles ### Importing External Agent Threads {#importing-threads} -If you have External Agents installed, Zed will detect whether you have existing threads and invite you to import them into Zed. Once you open Thread History, you'll find an import icon button in the Thread History toolbar that lets you import threads at any time. Clicking on it opens a modal where you can select the agents whose threads you want to import. +If you have External Agents installed, Gwen will detect whether you have existing threads and invite you to import them into Gwen. Once you open Thread History, you'll find an import icon button in the Thread History toolbar that lets you import threads at any time. Clicking on it opens a modal where you can select the agents whose threads you want to import. > **Note:** Thread import is subject to agent support. Some agents (such as Cursor and Gemini CLI) are not currently supported. @@ -53,7 +53,7 @@ If you have External Agents installed, Zed will detect whether you have existing Each thread runs independently, so you can send a prompt, open a second thread, and give it a different task while the first continues working. To scope a new thread to a specific project, hover over that project's header in the Threads Sidebar and click the `+` button, or use {#action agents_sidebar::NewThreadInGroup} from the keyboard. See [Creating New Threads](./agent-panel.md#new-thread) for the other entry points. -Each thread can use a different agent, so you can run Zed's built-in agent in one thread and an [External Agent](./external-agents.md) like Claude Code or Codex in another. +Each thread can use a different agent, so you can run Gwen's built-in agent in one thread and an [External Agent](./external-agents.md) like Claude Code or Codex in another. ### Thread Types {#thread-types} @@ -61,13 +61,13 @@ The Threads Sidebar can hold different thread types: | Thread type | Configuration | | --------------------------------------------- | -------------------------------------------------------------------------------------- | -| [Zed Agent thread](./zed-agent.md) | Uses Zed Agent settings, profiles, tools, [Skills](./skills.md), Instructions, and MCP | +| [Gwen Agent thread](./zed-agent.md) | Uses Gwen Agent settings, profiles, tools, [Skills](./skills.md), Instructions, and MCP | | [External Agent thread](./external-agents.md) | Uses the ACP integration and the agent's native configuration | | [Terminal Thread](./terminal-threads.md) | Runs a CLI/TUI in a terminal-backed thread; the CLI owns auth and configuration | ## Multiple Projects {#multiple-projects} -The Threads Sidebar can hold multiple projects at once. Each project gets its own group with its own threads and conversation history. This mirrors how Zed handles projects in general — see [Windows & Projects](../windows-and-projects.md) for more on how projects open and how to manage them. +The Threads Sidebar can hold multiple projects at once. Each project gets its own group with its own threads and conversation history. This mirrors how Gwen handles projects in general — see [Windows & Projects](../windows-and-projects.md) for more on how projects open and how to manage them. To add another project to the sidebar, click the **Add Project** button (open-folder icon) in the sidebar bottom bar. The popover that opens lists your recent projects and also provides **Add Local Folders** and **Add Remote Folder** buttons at the bottom. @@ -87,7 +87,7 @@ Worktrees are managed from the title bar. Click the worktree picker (to the righ Once you're in a new worktree, use the branch picker next to the worktree picker to create a new branch or check out an existing one. If the branch you pick is already checked out in another worktree, the current worktree stays in detached HEAD until you choose a different branch. -To automate setup steps whenever a new worktree is created, use a [Task hook](../tasks.md#hooks). The `create_worktree` hook runs automatically after Zed creates a linked worktree, with `ZED_WORKTREE_ROOT` pointing at the new worktree and `ZED_MAIN_GIT_WORKTREE` pointing at the original repository. +To automate setup steps whenever a new worktree is created, use a [Task hook](../tasks.md#hooks). The `create_worktree` hook runs automatically after Gwen creates a linked worktree, with `ZED_WORKTREE_ROOT` pointing at the new worktree and `ZED_MAIN_GIT_WORKTREE` pointing at the original repository. After the agent finishes, review the diff and merge the changes through your normal Git workflow. If the thread was running in a linked worktree and no other active threads use it, moving the thread to Thread History saves the worktree's Git state and removes it from disk. Restoring the thread from history restores the worktree. @@ -95,5 +95,5 @@ After the agent finishes, review the diff and merge the changes through your nor - [Agent Panel](./agent-panel.md): Manage individual threads and configure the agent - [External Agents](./external-agents.md): Use ACP-integrated External Agents -- [Terminal Threads](./terminal-threads.md): Run agent CLIs and TUIs directly in Zed +- [Terminal Threads](./terminal-threads.md): Run agent CLIs and TUIs directly in Gwen - [Tools](./tools.md): Built-in tools available in each thread diff --git a/docs/src/ai/privacy-and-security.md b/docs/src/ai/privacy-and-security.md index 3943206a37..a264c588f6 100644 --- a/docs/src/ai/privacy-and-security.md +++ b/docs/src/ai/privacy-and-security.md @@ -1,47 +1,47 @@ --- -title: AI Privacy - Zed -description: Understand how Zed handles AI prompts, code context, hosted model requests, provider data boundaries, feedback, training data, and privacy controls. +title: AI Privacy - Gwen +description: Understand how Gwen handles AI prompts, code context, hosted model requests, provider data boundaries, feedback, training data, and privacy controls. --- # AI Privacy -This page explains the privacy and trust boundaries for AI features in Zed, -including [Zed Agent](./zed-agent.md), [Edit Prediction](./edit-prediction.md), +This page explains the privacy and trust boundaries for AI features in Gwen, +including [Gwen Agent](./zed-agent.md), [Edit Prediction](./edit-prediction.md), [Inline Assistant](./inline-assistant.md), and [Git commit generation](../git.md#ai-support-in-git). -Zed does not retain your prompts or code context by default. For -[Zed-hosted models](../account/zed-hosted-models.md), Zed has no-training +Gwen does not retain your prompts or code context by default. For +[Gwen-hosted models](../account/zed-hosted-models.md), Gwen has no-training commitments from model providers, and provider agreements require zero data retention for inference requests except for [provider-designated models with safety retention](#provider-safety-retention), such as Anthropic's Covered Models. -Zed only retains AI data when you explicitly share feedback or opt in to +Gwen only retains AI data when you explicitly share feedback or opt in to training data collection. ## AI Request Paths {#ai-request-paths} | Path | Who handles model requests | What to know | Details | | ------------------------------------------------------------ | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | -| [Zed-hosted models](../account/zed-hosted-models.md) | Zed routes requests to hosted model providers | Provider agreements prohibit training on your prompts or code context and require zero data retention for inference requests, except for provider-designated models with safety retention, such as Anthropic's Covered Models. | [Zed-hosted model commitments](#data-retention-and-training) | -| [Provider API keys](./use-api-access.md) | The configured provider | The provider handles requests under its own terms. Provider keys saved through Zed are stored in the system keychain, not in `settings.json`. | [Use API Access](./use-api-access.md) | +| [Gwen-hosted models](../account/zed-hosted-models.md) | Gwen routes requests to hosted model providers | Provider agreements prohibit training on your prompts or code context and require zero data retention for inference requests, except for provider-designated models with safety retention, such as Anthropic's Covered Models. | [Gwen-hosted model commitments](#data-retention-and-training) | +| [Provider API keys](./use-api-access.md) | The configured provider | The provider handles requests under its own terms. Provider keys saved through Gwen are stored in the system keychain, not in `settings.json`. | [Use API Access](./use-api-access.md) | | [Existing subscriptions](./use-an-existing-subscription.md) | The subscription provider | The provider handles requests under the subscription terms. | [Use an Existing Subscription](./use-an-existing-subscription.md) | | [Gateways](./use-a-gateway.md) | The configured gateway and upstream providers | The gateway and upstream providers handle requests under their own terms. | [Use a Gateway](./use-a-gateway.md) | | [Local models](./use-a-local-model.md) | The local server or self-hosted endpoint | The local server handles requests according to how you configured that server. | [Use a Local Model](./use-a-local-model.md) | | [External Agents](./external-agents.md) | The External Agent and its configured providers | The External Agent handles model requests under its own terms. Tool and MCP behavior depends on agent and ACP configuration. | [External Agents](./external-agents.md) | | [Terminal Threads](./terminal-threads.md) | The CLI or TUI running in the terminal | The CLI or TUI owns its auth, model routing, tools, instructions, MCP configuration, and data handling. | [Terminal Threads](./terminal-threads.md) | | [Edit Prediction](./edit-prediction.md) | The selected edit prediction provider | Each keystroke can send local editing context to the selected provider. Zeta requests are processed transiently unless training data collection is enabled; third-party providers follow their own terms. | [Edit Prediction](./edit-prediction.md), [Feedback and Training Data](./ai-improvement.md) | -| [Agent tools](./tools.md), [MCP](./mcp.md), and integrations | Zed, configured MCP servers, and external systems | Tools can read, edit, search, run commands, fetch URLs, or call external systems depending on profile, MCP server, and tool permission settings. | [Agent Profiles](./agent-profiles.md), [Tool Permissions](./tool-permissions.md), [MCP](./mcp.md) | -| Project trust and instructions | Zed and the trusted worktree | Project-local instructions and skills are loaded from trusted worktrees. External Agents and Terminal Threads may read their own instruction files. | [Worktree Trust](../worktree-trust.md), [Skills](./skills.md), [Instructions](./instructions.md) | +| [Agent tools](./tools.md), [MCP](./mcp.md), and integrations | Gwen, configured MCP servers, and external systems | Tools can read, edit, search, run commands, fetch URLs, or call external systems depending on profile, MCP server, and tool permission settings. | [Agent Profiles](./agent-profiles.md), [Tool Permissions](./tool-permissions.md), [MCP](./mcp.md) | +| Project trust and instructions | Gwen and the trusted worktree | Project-local instructions and skills are loaded from trusted worktrees. External Agents and Terminal Threads may read their own instruction files. | [Worktree Trust](../worktree-trust.md), [Skills](./skills.md), [Instructions](./instructions.md) | -## Zed-Hosted Model Commitments {#data-retention-and-training} +## Gwen-Hosted Model Commitments {#data-retention-and-training} -For Zed-hosted models, Zed has commitments from model providers that prohibit +For Gwen-hosted models, Gwen has commitments from model providers that prohibit training on your prompts or code context and require zero data retention for inference requests, except for [provider-designated models with safety retention](#provider-safety-retention), such as Anthropic's Covered Models. The public provider documents linked below describe provider programs or default -API terms; Zed-hosted model requests are governed by Zed's provider agreements. +API terms; Gwen-hosted model requests are governed by Gwen's provider agreements. | Provider | No training reference | Zero-data-retention reference | | --------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -54,7 +54,7 @@ API terms; Zed-hosted model requests are governed by Zed's provider agreements. Some providers require limited data retention for specific models as a condition of offering them, on every platform where those models are available. Anthropic retains prompts and outputs for models it designates as Covered Models, including -Claude Fable 5, for at least 30 days for trust and safety purposes. Zed cannot +Claude Fable 5, for at least 30 days for trust and safety purposes. Gwen cannot opt out of this retention; it applies wherever these models are served. See [Anthropic's data retention practices for Covered Models](https://support.claude.com/en/articles/15425996-data-retention-practices-for-covered-models). @@ -62,10 +62,10 @@ For these models: - The no-training commitment still applies. Retained data is used for safety review, not model training. -- Zed does not retain your prompts or outputs. Retention happens at the +- Gwen does not retain your prompts or outputs. Retention happens at the provider, under the provider's documented access controls and deletion timelines. -- All other Zed-hosted models keep zero-data-retention handling. +- All other Gwen-hosted models keep zero-data-retention handling. If you don't want provider-side retention, use a model that the provider has not designated for safety retention. Switching to @@ -74,12 +74,12 @@ not designated for safety retention. Switching to for covered models, because providers apply it on every platform where those models are offered. -## AI Data Retained by Zed {#ai-data-retained-by-zed} +## AI Data Retained by Gwen {#ai-data-retained-by-zed} -Zed may retain AI data only when you explicitly share it or opt in: +Gwen may retain AI data only when you explicitly share it or opt in: - [Response ratings and feedback](./ai-improvement.md#ai-feedback-with-ratings) - can send a conversation thread to Zed for review and improvement. + can send a conversation thread to Gwen for review and improvement. - [Edit Prediction training data](./ai-improvement.md#edit-predictions) is collected only when you opt in, the project is open source, and the file is not excluded. @@ -89,13 +89,13 @@ can be stored in each opt-in case. ## Controls and Related Privacy Docs {#controls-and-related-privacy-docs} -- [Telemetry](../telemetry.md): What telemetry Zed collects and how to control +- [Telemetry](../telemetry.md): What telemetry Gwen collects and how to control it. -- [Privacy for Business](../business/privacy.md): How Zed Business enforces +- [Privacy for Business](../business/privacy.md): How Gwen Business enforces privacy settings across an organization. - [Admin Controls](../business/admin-controls.md): How owners and admins control - Zed-hosted models, Edit Prediction, and feedback sharing. + Gwen-hosted models, Edit Prediction, and feedback sharing. - [AI Quick Start](./quick-start.md#turn-ai-off): How to turn AI off. -- [Privacy Policy](https://zed.dev/privacy-policy): Zed's privacy policy. -- [Subprocessors](https://zed.dev/subprocessors): Zed's subprocessors. -- [Terms of Service](https://zed.dev/terms): Zed's terms. +- [Privacy Policy](https://zed.dev/privacy-policy): Gwen's privacy policy. +- [Subprocessors](https://zed.dev/subprocessors): Gwen's subprocessors. +- [Terms of Service](https://zed.dev/terms): Gwen's terms. diff --git a/docs/src/ai/quick-start.md b/docs/src/ai/quick-start.md index 765c5cfeec..0ee3e4304f 100644 --- a/docs/src/ai/quick-start.md +++ b/docs/src/ai/quick-start.md @@ -1,21 +1,21 @@ --- -title: AI Quick Start - Zed -description: Choose the right Zed AI setup path for agents, models, subscriptions, local models, edit prediction, and privacy. +title: AI Quick Start - Gwen +description: Choose the right Gwen AI setup path for agents, models, subscriptions, local models, edit prediction, and privacy. --- # AI Quick Start -Use this page to choose the right AI setup path in Zed. If you already know the company, subscription, model provider, agent, or CLI you want to use, start with [AI by Company](./by-company.md). +Use this page to choose the right AI setup path in Gwen. If you already know the company, subscription, model provider, agent, or CLI you want to use, start with [AI by Company](./by-company.md). -## Use the Zed Agent {#zed-agent} +## Use the Gwen Agent {#zed-agent} -Use [Zed Agent](./zed-agent.md) when you want Zed's native agent to read, edit, search, and run code in your project. +Use [Gwen Agent](./zed-agent.md) when you want Gwen's native agent to read, edit, search, and run code in your project. -Zed Agent uses Zed-configured models from [LLM Providers](./llm-providers.md). It also uses Zed's built-in tools, [Agent Profiles](./agent-profiles.md), [Skills](./skills.md), [Instructions](./instructions.md), and [MCP servers](./mcp.md). +Gwen Agent uses Gwen-configured models from [LLM Providers](./llm-providers.md). It also uses Gwen's built-in tools, [Agent Profiles](./agent-profiles.md), [Skills](./skills.md), [Instructions](./instructions.md), and [MCP servers](./mcp.md). Start in the [Agent Panel](./agent-panel.md) to prompt the agent, add context, review changes, and manage threads. -### Configure the Zed Agent {#configure-zed-agent} +### Configure the Gwen Agent {#configure-zed-agent} | If you want to... | Use | | ----------------------------------------- | ----------------------------------------- | @@ -25,30 +25,30 @@ Start in the [Agent Panel](./agent-panel.md) to prompt the agent, add context, r | Add always-on personal or project context | [Instructions](./instructions.md) | | Connect external tools and context | [Model Context Protocol](./mcp.md) | -## Use Another Coding Agent in Zed {#agent-cli} +## Use Another Coding Agent in Gwen {#agent-cli} Use this path for Claude, Codex, OpenCode, Copilot, Cursor, Pi Coding Agent, Gemini CLI, or another coding agent. | If the agent... | Use | | ------------------------------- | ----------------------------------------- | -| Integrates with Zed through ACP | [External Agents](./external-agents.md) | +| Integrates with Gwen through ACP | [External Agents](./external-agents.md) | | Runs as a CLI or TUI | [Terminal Threads](./terminal-threads.md) | External Agents and Terminal Threads usually own their own auth, model configuration, subscriptions, tools, instructions, and MCP configuration. -## Choose Which Models the Zed Agent Uses {#model-access} +## Choose Which Models the Gwen Agent Uses {#model-access} -The Zed Agent and other model-backed Zed AI features use models configured through [LLM Providers](./llm-providers.md). +The Gwen Agent and other model-backed Gwen AI features use models configured through [LLM Providers](./llm-providers.md). | If you want to... | Use | | ----------------------------------------------------------------------------- | ----------------------------------------------------------------- | -| Use models billed through Zed | [Zed-Hosted Models](../account/zed-hosted-models.md) | +| Use models billed through Gwen | [Gwen-Hosted Models](../account/zed-hosted-models.md) | | Bring your own provider API key, credits, top-ups, or usage billing | [Use API Access](./use-api-access.md) | | Use a subscription you already pay for | [Use an Existing Subscription](./use-an-existing-subscription.md) | | Use OpenRouter, Vercel AI Gateway, Amazon Bedrock, or another gateway | [Use a Gateway](./use-a-gateway.md) | | Use Ollama, LM Studio, local OpenAI-compatible servers, or self-hosted models | [Use a Local Model](./use-a-local-model.md) | -Provider keys saved through Zed are stored in the system keychain, not in `settings.json`. +Provider keys saved through Gwen are stored in the system keychain, not in `settings.json`. ## Change AI Settings {#ai-settings} @@ -58,7 +58,7 @@ Provider keys saved through Zed are stored in the system keychain, not in `setti | Disable AI, configure tool permissions, or set up edit prediction providers | Settings Editor with {#action zed::OpenSettings} | | Edit advanced JSON-only settings | Settings file with {#action zed::OpenSettingsFile} | -For general settings mechanics, see [Configuring Zed](../configuring-zed.md). +For general settings mechanics, see [Configuring Gwen](../configuring-zed.md). ## Use a Specific AI Feature {#features} @@ -75,7 +75,7 @@ For general settings mechanics, see [Configuring Zed](../configuring-zed.md). | If you want to... | Use | | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | | Understand privacy and data controls | [AI Privacy](./privacy-and-security.md) and [Feedback and Training Data](./ai-improvement.md) | -| Understand plans, usage, and billing | [Plans & Pricing](../account/plans-and-pricing.md), [Zed-Hosted Models](../account/zed-hosted-models.md), and [Billing](../account/billing.md) | +| Understand plans, usage, and billing | [Plans & Pricing](../account/plans-and-pricing.md), [Gwen-Hosted Models](../account/zed-hosted-models.md), and [Billing](../account/billing.md) | ## Turn AI Off {#turn-ai-off} diff --git a/docs/src/ai/rules.md b/docs/src/ai/rules.md index d2ab7da817..55f3bd68d2 100644 --- a/docs/src/ai/rules.md +++ b/docs/src/ai/rules.md @@ -1,13 +1,13 @@ --- title: Rules (Replaced by Skills) -description: Rules have been replaced by Skills and Instructions in Zed. +description: Rules have been replaced by Skills and Instructions in Gwen. --- # Rules {#rules} Rules have been replaced by [Skills](./skills.md) and [Instructions](./instructions.md). -> **Note:** Starting in Zed v1.4.0, on-demand Rules and the Rules Library have been replaced by [Skills](./skills.md). Skills are the recommended way to package reusable agent instructions. +> **Note:** Starting in Gwen v1.4.0, on-demand Rules and the Rules Library have been replaced by [Skills](./skills.md). Skills are the recommended way to package reusable agent instructions. Use [Skills](./skills.md) for reusable task instructions that can be invoked by name or selected by the model. Use [Instructions](./instructions.md) for always-on personal and project context. @@ -32,7 +32,7 @@ Other instruction filenames are also supported for compatibility with other agen Existing Rules migrate automatically: - Non-default Rules become global Skills in `~/.agents/skills/`, each with `disable-model-invocation: true`. They remain user-invocable by slash command or `@`-mention. -- Default Rules are appended to your global `AGENTS.md` file (`~/.config/zed/AGENTS.md` on macOS and Linux, `%APPDATA%\Zed\AGENTS.md` on Windows). +- Default Rules are appended to your global `AGENTS.md` file (`~/.config/gwen/AGENTS.md` on macOS and Linux, `%APPDATA%\Gwen\AGENTS.md` on Windows). - Git commit prompt customizations are also appended to the global `AGENTS.md` file. -Rules Library content is not deleted, so downgrading to an earlier version of Zed leaves your Rules intact. +Rules Library content is not deleted, so downgrading to an earlier version of Gwen leaves your Rules intact. diff --git a/docs/src/ai/sandboxing.md b/docs/src/ai/sandboxing.md index 2d676d75c8..d7de67c804 100644 --- a/docs/src/ai/sandboxing.md +++ b/docs/src/ai/sandboxing.md @@ -1,11 +1,11 @@ --- title: Sandboxing -description: Zed Agent tool calls can run in an OS-level sandbox to restrict certain operations. +description: Gwen Agent tool calls can run in an OS-level sandbox to restrict certain operations. --- # Sandboxing -You can restrict what operations the [Zed Agent](./zed-agent.md) can run in multiple ways. One way to restrict them is +You can restrict what operations the [Gwen Agent](./zed-agent.md) can run in multiple ways. One way to restrict them is [Tool Permissions](./tool-permissions.md), but these are of limited use when the agent wants to do things like run a complicated script in a terminal. @@ -20,7 +20,7 @@ sandbox?](#trust) for more details. - Tool permissions restrict the agent's ability to run certain tool actions in the first place - Once a tool action is actually running, sandboxing restricts what it can do -Sandboxing applies only to Zed Agent. It does not sandbox Zed itself, language servers, extensions, tasks, your normal +Sandboxing applies only to Gwen Agent. It does not sandbox Gwen itself, language servers, extensions, tasks, your normal terminal tabs, [External Agents](./external-agents.md), or [Terminal Threads](./terminal-threads.md). > **Note**: Under some conditions, sandboxes on Windows are weaker than those on @@ -29,7 +29,7 @@ terminal tabs, [External Agents](./external-agents.md), or [Terminal Threads](./ ## Sandboxed Tools {#sandboxed-tools} -Zed Agent sandboxing currently applies to the `terminal` and `fetch` tools. +Gwen Agent sandboxing currently applies to the `terminal` and `fetch` tools. | Tool | What sandboxing limits | | ---------- | ----------------------------------------------------------------------------------------------------- | @@ -54,7 +54,7 @@ The `fetch` tool has no extra requirements on any platform. ## Default Access {#default-access} -By default, sandboxed Zed Agent tool actions have these restrictions: +By default, sandboxed Gwen Agent tool actions have these restrictions: | Access type | Default behavior | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -73,7 +73,7 @@ However, it does not fully eliminate them. Firstly, sandboxing relies on OS-level features, which may contain bugs. Operating systems have historically had bugs in security features. And while we -have tested thoroughly, there may also be bugs in Zed's implementation. These +have tested thoroughly, there may also be bugs in Gwen's implementation. These could allow privilege escalation - for example, allow an agent to write to a file that it should only have read access to. @@ -90,7 +90,7 @@ provide a `reason`, which is displayed in the prompt. Read it, and decide whether it makes sense before approving. Also, sandboxing restricts **only** what the `terminal` and `fetch` tools in the -Zed agent can do. It has **no effect** on other parts of Zed, including: +Gwen agent can do. It has **no effect** on other parts of Gwen, including: - Language servers - The built-in git client @@ -124,14 +124,14 @@ But none of this changes the fundamental principle: **a sandbox is not a substitute for good security practices**. It is one layer in a defense-in-depth strategy. -Zed's default profile aims to strike a balance between security and convenience, +Gwen's default profile aims to strike a balance between security and convenience, but we encourage you to tune your settings based on your own security requirements and risk profile. A disabled sandbox is not a very effective sandbox. ## Approval Prompts {#approval-prompts} -When the agent needs access outside the default sandbox, Zed shows a sandbox approval prompt before the tool action runs. +When the agent needs access outside the default sandbox, Gwen shows a sandbox approval prompt before the tool action runs. Depending on what the tool requested, the prompt can ask you to allow: - network access to specific hosts, such as `github.com` or `*.npmjs.org` @@ -172,7 +172,7 @@ The available options are: | `allow_all_hosts` | Allow sandboxed tools to reach any host without prompting. | | `write_paths` | Directory subtrees that sandboxed terminal commands may write to without prompting. Paths are absolute. | | `allow_fs_write_all` | Allow sandboxed terminal commands to write anywhere except protected Git metadata without prompting. | -| `allow_unsandboxed` | Turn sandboxing off entirely for Zed Agent terminal commands. The fetch tool will have no restrictions. | +| `allow_unsandboxed` | Turn sandboxing off entirely for Gwen Agent terminal commands. The fetch tool will have no restrictions. | Prefer narrow grants, such as a specific host or write path, over `allow_all_hosts`, `allow_fs_write_all`, or `allow_unsandboxed`. @@ -190,7 +190,7 @@ enforcement details vary. ### macOS {#macos} -On macOS, Zed uses Apple's Seatbelt sandbox through `sandbox-exec`. +On macOS, Gwen uses Apple's Seatbelt sandbox through `sandbox-exec`. Sandboxed terminal commands: @@ -203,17 +203,17 @@ Sandboxed terminal commands: - cannot reach the network unless you approve network access - can reach only an allowlist of macOS system (Mach) services that developer tooling needs; services that could be abused to escape the sandbox (LaunchServices and launchd, which can launch processes outside it), read the clipboard (the pasteboard), or capture audio are not reachable -When network access is approved on macOS, Zed uses an HTTP/HTTPS proxy so access can be limited to approved hosts. +When network access is approved on macOS, Gwen uses an HTTP/HTTPS proxy so access can be limited to approved hosts. Tools that do not honor proxy environment variables, such as SSH, FTP, and raw socket clients, may not work even after host-specific network access is approved. For networked terminal commands, prefer HTTPS URLs over SSH URLs when possible. ### Linux {#linux} -On Linux, Zed uses [Bubblewrap][bubblewrap] (`bwrap`) for sandboxing. +On Linux, Gwen uses [Bubblewrap][bubblewrap] (`bwrap`) for sandboxing. -Zed only uses a non-setuid `bwrap` binary. Its sandbox is built entirely on unprivileged user namespaces, so a setuid-root +Gwen only uses a non-setuid `bwrap` binary. Its sandbox is built entirely on unprivileged user namespaces, so a setuid-root `bwrap` provides no extra functionality, and running one would mean executing root-privileged setup with arguments partly -derived from model-influenced input. If the only `bwrap` found on your `PATH` is setuid-root, Zed refuses to run it; +derived from model-influenced input. If the only `bwrap` found on your `PATH` is setuid-root, Gwen refuses to run it; install a non-setuid Bubblewrap to enable sandboxing. Sandboxed terminal commands: @@ -225,11 +225,11 @@ Sandboxed terminal commands: - cannot write elsewhere unless you approve additional paths or broader write access - cannot reach the network unless you approve network access -When host-specific network access is approved on Linux, Zed uses an HTTP/HTTPS proxy so access can be limited to approved +When host-specific network access is approved on Linux, Gwen uses an HTTP/HTTPS proxy so access can be limited to approved hosts. Tools that do not honor proxy environment variables, such as SSH, FTP, and raw socket clients, may not work even after host-specific network access is approved. -If Bubblewrap is unavailable or cannot create a sandbox in the current environment, Zed may run the command without the OS +If Bubblewrap is unavailable or cannot create a sandbox in the current environment, Gwen may run the command without the OS sandbox and show a warning in the tool output. > **Warning**: On Linux and WSL, restrictions on filesystem objects are @@ -240,7 +240,7 @@ sandbox and show a warning in the tool output. #### Installing Bubblewrap {#installing-bubblewrap} -Zed needs a runnable, non-setuid `bwrap` binary on your `$PATH`. Installing +Gwen needs a runnable, non-setuid `bwrap` binary on your `$PATH`. Installing `bubblewrap` from your distribution's package manager is usually all you need. You can test whether it's working with: @@ -251,7 +251,7 @@ bwrap --ro-bind / / -- echo "working" "Non-setuid" here refers to the [setuid bit][setuid bit]. Historically, bubblewrap has shipped both a setuid and non-setuid binary. The setuid binary is -being phased out for security concerns, and so Zed's sandbox _explicitly rejects +being phased out for security concerns, and so Gwen's sandbox _explicitly rejects setuid `bwrap` binaries_. ##### Ubuntu-specific requirements {#installing-bubblewrap-ubuntu} @@ -288,19 +288,19 @@ sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrict ### Windows {#windows} -On Windows, Zed Agent sandboxing is supported only when the agent action runs inside WSL. +On Windows, Gwen Agent sandboxing is supported only when the agent action runs inside WSL. > **Warning**: Due to limitations in WSL's implementation, it is possible that a > terminal command may write outside sandbox grants when the user has given > write access to any path that resides on the NTFS drive. This includes the -> current-project grant for projects stored on NTFS. Zed will show a warning +> current-project grant for projects stored on NTFS. Gwen will show a warning > when this happens. In practice, we believe this is difficult to exploit, but > security cannot be guaranteed. See [below](#why-ntfs-compromise) for a more > technical explanation. -Zed uses the Linux Bubblewrap sandbox inside WSL because WSL provides the Linux process and filesystem primitives that -Bubblewrap needs. Native Windows processes do not currently have the same sandbox integration in Zed, so a native Windows -command cannot be confined by Zed Agent's OS sandbox in the same way. +Gwen uses the Linux Bubblewrap sandbox inside WSL because WSL provides the Linux process and filesystem primitives that +Bubblewrap needs. Native Windows processes do not currently have the same sandbox integration in Gwen, so a native Windows +command cannot be confined by Gwen Agent's OS sandbox in the same way. When running inside WSL, the Linux sandboxing behavior applies, including the requirement that `bwrap` not be setuid-root: @@ -309,7 +309,7 @@ When running inside WSL, the Linux sandboxing behavior applies, including the re - `/tmp` is temporary for sandboxed terminal calls - network access is all-or-nothing rather than host-specific, so host-specific network requests are rejected and the agent must request unrestricted network access when network access is needed -If WSL is not installed, or if you choose to run a command without the sandbox, Zed falls back to the standard terminal +If WSL is not installed, or if you choose to run a command without the sandbox, Gwen falls back to the standard terminal behavior of running in your native shell. It selects the shell using the usual preference order: a bash (scoop's bash or Git Bash) when one is installed, otherwise PowerShell, and finally `cmd.exe`. Because the command then runs against native Windows paths instead of WSL's Linux filesystem, path conventions change accordingly (for example `C:\...` or `/c/...` @@ -373,7 +373,7 @@ testing, but could not find documentation guaranteeing this behaviour in all circumstances, for all Windows/WSL versions past and present, regardless of configuration options. -Zed's sandbox has been designed with the aim of being totally unbreakable, even +Gwen's sandbox has been designed with the aim of being totally unbreakable, even in the presence of a motivated attacker with full control over the files in your project running as a standard user. It does _not_ assume a mostly-benevolent-but-sometimes-careless agent. diff --git a/docs/src/ai/skills.md b/docs/src/ai/skills.md index a3d6a26e60..08fa95f0bc 100644 --- a/docs/src/ai/skills.md +++ b/docs/src/ai/skills.md @@ -1,6 +1,6 @@ --- -title: Agent Skills - Zed -description: Extend Zed's AI agent with reusable, on-demand skill files for specialized tasks. +title: Agent Skills - Gwen +description: Extend Gwen's AI agent with reusable, on-demand skill files for specialized tasks. --- # Skills {#skills} @@ -13,11 +13,11 @@ A skill is a folder containing a `SKILL.md` file with metadata and instructions. ### Create your own {#create-your-own} -Zed includes a built-in `create-skill` skill — invoke it with `/create-skill` and the agent walks you through the process. +Gwen includes a built-in `create-skill` skill — invoke it with `/create-skill` and the agent walks you through the process. You can also open the Skills Manager from the Agent Panel using {#kb agent::ManageSkills}, or by clicking `...` and selecting **Skills**. Outside the panel, use the {#action agent::OpenSkillCreator} action from the command palette, or click **Create Skill** on the **AI > Skills** settings page. The creator opens as a page in the settings window where you fill in the skill's name, description, body, and optionally toggle `disable-model-invocation`. The skill is saved to the scope of the settings file selected in the settings window — the **User** tab creates a global skill, while a **Project** tab creates a project-local skill — and the form shows exactly where the file will be written. -Lastly, it's also possible to add a skill through importing it from an existing GitHub Markdown file. Open the command palette and look for the {#action agent::CreateSkillFromUrl} action. If your clipboard contains a supported GitHub `.md` URL, Zed pre-fills and fetches it automatically. +Lastly, it's also possible to add a skill through importing it from an existing GitHub Markdown file. Open the command palette and look for the {#action agent::CreateSkillFromUrl} action. If your clipboard contains a supported GitHub `.md` URL, Gwen pre-fills and fetches it automatically. See [Skill format](#skill-format) below for the full format reference. @@ -50,7 +50,7 @@ In the skills page, you'll see a **Create Skill** button that opens the settings You can hand a skill to a teammate without hosting it anywhere. In the Skills settings page, click the **link** icon on a skill row to copy a `zed://skill?data=…` link to your clipboard. The link is self-contained: it embeds the full `SKILL.md` contents (base64url-encoded), so the recipient doesn't need access to your project or any registry. -When someone opens that link (for example by pasting it into their browser or clicking it in a chat), Zed opens the "Create Skill" page in the settings window, pre-filled with the shared skill. +When someone opens that link (for example by pasting it into their browser or clicking it in a chat), Gwen opens the "Create Skill" page in the settings window, pre-filled with the shared skill. The recipient can review the name, description, and full body, choose a scope by selecting the **User** tab (global) or a **Project** tab, and click **Save** to install it. Nothing is written to disk until they explicitly save, so a shared link can never silently install instructions into someone's agent. @@ -58,7 +58,7 @@ Nothing is written to disk until they explicitly save, so a shared link can neve By default, the agent picks up skills autonomously. It sees a catalog of every installed skill (name and description) in its system prompt, and calls the `skill` tool when a task matches a skill's description. -When the agent invokes a skill you created or installed, Zed prompts you to allow or deny it, using the same permission flow as other tools. Skills built into Zed do not prompt. You can set per-skill defaults in [Tool Permissions](./tool-permissions.md) so you're not prompted for skills you always trust. +When the agent invokes a skill you created or installed, Gwen prompts you to allow or deny it, using the same permission flow as other tools. Skills built into Gwen do not prompt. You can set per-skill defaults in [Tool Permissions](./tool-permissions.md) so you're not prompted for skills you always trust. ### Manual Invocation {#manual-invocation} @@ -165,7 +165,7 @@ See the [Agent Skills specification](https://agentskills.io/specification) for t ## Where Skills Live {#where-skills-live} -Zed loads skills from two locations: +Gwen loads skills from two locations: | Scope | Path | When it applies | | ------------- | ---------------------------- | ------------------------ | @@ -190,13 +190,13 @@ The agent cannot edit `SKILL.md` files or their bundled resources without your e ## Agent Path Boundaries {#agent-path-boundaries} -Zed Skills apply to the Zed Agent. [External Agents](./external-agents.md) and Terminal Threads may have their own native skills, prompts, or instruction systems. Configure those in the External Agent or CLI. +Gwen Skills apply to the Gwen Agent. [External Agents](./external-agents.md) and Terminal Threads may have their own native skills, prompts, or instruction systems. Configure those in the External Agent or CLI. ## Limitations {#limitations} - **Flat layout only.** Skills must be direct children of the skills root. Nested folders like `~/.agents/skills/group/my-skill/` are not discovered. - **50KB catalog budget.** The total size of all skill names and descriptions is capped at 50KB. Skills that don't fit are dropped from the catalog with a warning in the UI. Keep descriptions concise. -- **No remote registry.** Zed does not discover or load skills from remote locations at runtime, and custom search paths are not supported. (You can still import a skill once from a GitHub URL — see [Create your own](#create-your-own).) Skills are loaded from `~/.agents/skills/` and `/.agents/skills/` only. Use a symlink if you need to point at another location. +- **No remote registry.** Gwen does not discover or load skills from remote locations at runtime, and custom search paths are not supported. (You can still import a skill once from a GitHub URL — see [Create your own](#create-your-own).) Skills are loaded from `~/.agents/skills/` and `/.agents/skills/` only. Use a symlink if you need to point at another location. - **Live reload.** Adding, removing, or editing a `SKILL.md` takes effect immediately without restarting your session. Changes to a skill's `name` or `description` invalidate the model's prompt cache for the current session. ## See also diff --git a/docs/src/ai/terminal-threads.md b/docs/src/ai/terminal-threads.md index 7d20323e52..630c0f0121 100644 --- a/docs/src/ai/terminal-threads.md +++ b/docs/src/ai/terminal-threads.md @@ -1,17 +1,17 @@ --- -title: Terminal Threads - Zed -description: Run agent CLIs and TUIs directly in terminal-backed threads in Zed. +title: Terminal Threads - Gwen +description: Run agent CLIs and TUIs directly in terminal-backed threads in Gwen. --- # Terminal Threads -Terminal Threads are terminal-backed threads in the [Threads Sidebar](./parallel-agents.md#threads-sidebar). Use them when you want to run an agent CLI or TUI directly in Zed. +Terminal Threads are terminal-backed threads in the [Threads Sidebar](./parallel-agents.md#threads-sidebar). Use them when you want to run an agent CLI or TUI directly in Gwen. -Terminal Threads are different from [External Agents](./external-agents.md). External Agents integrate with Zed through ACP and render as agent threads. Terminal Threads run the native command-line tool in a terminal that Zed organizes as a thread. +Terminal Threads are different from [External Agents](./external-agents.md). External Agents integrate with Gwen through ACP and render as agent threads. Terminal Threads run the native command-line tool in a terminal that Gwen organizes as a thread. -## What Zed Owns {#what-zed-owns} +## What Gwen Owns {#what-zed-owns} -Zed owns the thread surface: +Gwen owns the thread surface: - the terminal-backed thread in the Threads Sidebar - thread grouping by project @@ -28,7 +28,7 @@ The CLI or TUI running inside the terminal owns its own: - skills and instruction files - MCP configuration -[Zed Agent profiles](./agent-profiles.md), Zed Agent tool permissions, Zed Skills, and Zed Agent MCP settings do not automatically apply to Terminal Threads. +[Gwen Agent profiles](./agent-profiles.md), Gwen Agent tool permissions, Gwen Skills, and Gwen Agent MCP settings do not automatically apply to Terminal Threads. ## Opening a Terminal Thread {#opening-a-terminal-thread} @@ -38,7 +38,7 @@ You can open as many Terminal Threads as you like. Each gets its own entry in th ## Running a Command Automatically {#terminal-thread-init-command} -If you always run the same CLI in Terminal Threads, set the `agent.terminal_init_command` setting to have Zed run a command automatically whenever Zed creates a Terminal Thread shell: +If you always run the same CLI in Terminal Threads, set the `agent.terminal_init_command` setting to have Gwen run a command automatically whenever Gwen creates a Terminal Thread shell: ```json [settings] { @@ -60,7 +60,7 @@ To edit the title of the active Terminal Thread from the Agent Panel, custom-map ## Notifications {#terminal-thread-notifications} -When a terminal produces a bell character while not in focus, Zed notifies you the same way it does when an agent finishes: with a visual pop-up and an optional sound. Clicking the notification brings the terminal into focus and clears the indicator. +When a terminal produces a bell character while not in focus, Gwen notifies you the same way it does when an agent finishes: with a visual pop-up and an optional sound. Clicking the notification brings the terminal into focus and clears the indicator. The same `agent.notify_when_agent_waiting` and `agent.play_sound_when_agent_done` settings apply. @@ -70,7 +70,7 @@ Unlike agent threads, Terminal Threads are closed rather than archived. They do ## CLI/TUI Setup Notes {#cli-setup} -Some agent CLIs and TUIs can send terminal signals, such as bell notifications or title updates, that Zed uses to show useful context in the sidebar. +Some agent CLIs and TUIs can send terminal signals, such as bell notifications or title updates, that Gwen uses to show useful context in the sidebar. ### Claude Code Notifications {#claude-code-notifications} @@ -94,7 +94,7 @@ For more, see the [Claude Code documentation](https://code.claude.com/docs/en/te ### Amp Notifications {#amp-notifications} -Amp updates terminal titles automatically and can also notify you when it needs your attention. To enable notifications in Zed Terminal Threads, add `AMP_FORCE_BEL=1` to your terminal environment settings: +Amp updates terminal titles automatically and can also notify you when it needs your attention. To enable notifications in Gwen Terminal Threads, add `AMP_FORCE_BEL=1` to your terminal environment settings: ```json [settings] { @@ -110,12 +110,12 @@ Restart Amp after adding the environment variable. ### OpenCode Notifications {#opencode-notifications} -OpenCode can update terminal titles automatically. For Zed notifications, add an OpenCode plugin that emits a terminal bell when OpenCode needs your attention. +OpenCode can update terminal titles automatically. For Gwen notifications, add an OpenCode plugin that emits a terminal bell when OpenCode needs your attention. -Create `.opencode/plugins/zed-bell.js` in your project, or `~/.config/opencode/plugins/zed-bell.js` to use it globally: +Create `.opencode/plugins/gwen-bell.js` in your project, or `~/.config/opencode/plugins/gwen-bell.js` to use it globally: ```js -export const ZedBell = async () => { +export const GwenBell = async () => { return { event: async ({ event }) => { if (process.env.OPENCODE_CLIENT === "acp") return; @@ -132,7 +132,7 @@ Restart OpenCode after adding the plugin. ### Pi Notifications {#pi-notifications} -Pi can use an extension to emit a notification when it finishes a turn. Create `.pi/extensions/zed-bell.ts` in your project, or `~/.pi/agent/extensions/zed-bell.ts` to use it globally: +Pi can use an extension to emit a notification when it finishes a turn. Create `.pi/extensions/gwen-bell.ts` in your project, or `~/.pi/agent/extensions/gwen-bell.ts` to use it globally: ```ts import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"; @@ -148,7 +148,7 @@ Restart Pi after adding the extension, or run `/reload` if the extension is in o ### Codex Terminal Titles {#codex-terminal-titles} -Codex can update the terminal title as it works, which Zed uses to show useful context for Codex Terminal Threads in the sidebar, such as the project, current status, branch, model, or task progress. +Codex can update the terminal title as it works, which Gwen uses to show useful context for Codex Terminal Threads in the sidebar, such as the project, current status, branch, model, or task progress. To configure this from within Codex, run `/title` and use the picker to choose which fields appear and in what order. Codex saves the selection to `tui.terminal_title` in `~/.codex/config.toml`. You can also edit it directly: @@ -161,7 +161,7 @@ terminal_title = ["spinner", "project-name", "run-state", "thread-title"] Credentials come from the terminal session and the CLI/TUI running inside it. -In remote projects, the CLI may read the remote shell environment and remote config files. In local Terminal Threads, it reads the local shell environment and local config files. Zed does not copy [API keys from LLM provider settings](./use-api-access.md) into Terminal Threads. +In remote projects, the CLI may read the remote shell environment and remote config files. In local Terminal Threads, it reads the local shell environment and local config files. Gwen does not copy [API keys from LLM provider settings](./use-api-access.md) into Terminal Threads. ## When to Use Terminal Threads {#when-to-use-terminal-threads} diff --git a/docs/src/ai/text-threads.md b/docs/src/ai/text-threads.md index 6dce29008d..25192b0d38 100644 --- a/docs/src/ai/text-threads.md +++ b/docs/src/ai/text-threads.md @@ -1,12 +1,12 @@ --- title: Text Threads (Removed) -description: Text threads have been removed from Zed. Use the Agent Panel for all AI conversations. +description: Text threads have been removed from Gwen. Use the Agent Panel for all AI conversations. redirect_to: ./agent-panel.md --- # Text Threads -Text threads have been removed from Zed. +Text threads have been removed from Gwen. All AI conversations now happen through the [Agent Panel](./agent-panel.md), which supports agentic workflows including tool calls, file editing, terminal access, and [External Agents](./external-agents.md). diff --git a/docs/src/ai/tool-permissions.md b/docs/src/ai/tool-permissions.md index 09bed49a99..a05defb3fe 100644 --- a/docs/src/ai/tool-permissions.md +++ b/docs/src/ai/tool-permissions.md @@ -3,12 +3,12 @@ Configure which [Agent Panel](./agent-panel.md) tools run automatically and which require your approval. For a list of available tools, [see the Tools page](./tools.md). -> **Note:** In Zed v0.224.0 and above, tool approval is controlled by `agent.tool_permissions.default`. +> **Note:** In Gwen v0.224.0 and above, tool approval is controlled by `agent.tool_permissions.default`. > In earlier versions, it was controlled by the `agent.always_allow_tool_actions` boolean (default `false`). ## Quick Start -Use Zed's Settings Editor to [configure tool permissions](zed://settings/agent.tool_permissions), or add rules directly to your settings file: +Use Gwen's Settings Editor to [configure tool permissions](zed://settings/agent.tool_permissions), or add rules directly to your settings file: ```json [settings] { @@ -139,11 +139,11 @@ To auto-approve all tool actions: } ``` -This bypasses confirmation prompts for most tools, but `always_deny`, `always_confirm`, built-in security rules, and paths inside Zed settings directories still prompt or block. +This bypasses confirmation prompts for most tools, but `always_deny`, `always_confirm`, built-in security rules, and paths inside Gwen settings directories still prompt or block. ## Shell Compatibility -For the `terminal` tool, Zed parses chained commands (e.g., `echo hello && rm file`) to check each sub-command against your patterns. +For the `terminal` tool, Gwen parses chained commands (e.g., `echo hello && rm file`) to check each sub-command against your patterns. All supported shells work with tool permission patterns, including sh, bash, zsh, dash, fish, PowerShell 7+, pwsh, cmd, xonsh, csh, tcsh, Nushell, Elvish, and rc (Plan 9). @@ -162,7 +162,7 @@ You can use the "Test Your Rules" checker, available in each individual tool pag ## Built-in Security Rules -Zed includes a small set of hardcoded security rules that **cannot be overridden** by any setting. +Gwen includes a small set of hardcoded security rules that **cannot be overridden** by any setting. These only apply to the **terminal** tool and block recursive deletion of critical directories: - `rm -rf /` and `rm -rf /*` — filesystem root diff --git a/docs/src/ai/tools.md b/docs/src/ai/tools.md index 3b47da1879..4105b063d4 100644 --- a/docs/src/ai/tools.md +++ b/docs/src/ai/tools.md @@ -1,21 +1,21 @@ --- -title: AI Agent Tools - Zed -description: Built-in tools for Zed's AI agent including file editing, code search, terminal commands, web search, skills, and diagnostics. +title: AI Agent Tools - Gwen +description: Built-in tools for Gwen's AI agent including file editing, code search, terminal commands, web search, skills, and diagnostics. --- # Tools -Zed's built-in agent has access to these tools for reading, searching, and editing your codebase. These tools are used in the [Agent Panel](./agent-panel.md) during conversations with AI agents. +Gwen's built-in agent has access to these tools for reading, searching, and editing your codebase. These tools are used in the [Agent Panel](./agent-panel.md) during conversations with AI agents. -The exact tool list can vary by [Agent Profile](./agent-profiles.md), selected model provider, and Zed version. +The exact tool list can vary by [Agent Profile](./agent-profiles.md), selected model provider, and Gwen version. You can configure permissions for tool actions, including situations where they are automatically approved, automatically denied, or require your confirmation on a case-by-case basis. See [Tool Permissions](./tool-permissions.md) for the list of permission-gated tools and details. To add custom tools beyond these built-in ones, see [MCP servers](./mcp.md). -To choose which built-in tools and MCP tools are available in a Zed Agent thread, use [Agent Profiles](./agent-profiles.md). Profiles control tool availability; tool permissions control allow, deny, and confirm behavior. +To choose which built-in tools and MCP tools are available in a Gwen Agent thread, use [Agent Profiles](./agent-profiles.md). Profiles control tool availability; tool permissions control allow, deny, and confirm behavior. -The terminal tool can also run with additional OS-level restrictions when [Zed Agent sandboxing](./sandboxing.md) is enabled. +The terminal tool can also run with additional OS-level restrictions when [Gwen Agent sandboxing](./sandboxing.md) is enabled. ## Read & Search Tools @@ -61,7 +61,7 @@ Searches the web for information, providing results with snippets and links from **Example:** Looking up whether a known bug in a dependency has been patched in a recent release, or finding the current API signature for a third-party library when the local docs are out of date. -> **Note:** The built-in `search_web` tool is only available to [Zed Pro](https://zed.dev/pricing) subscribers using the Zed provider. If you're on a free plan or using a different provider, you can get equivalent functionality by connecting an MCP server that provides web search capabilities. See [MCP servers](./mcp.md) for details. +> **Note:** The built-in `search_web` tool is only available to [Gwen Pro](https://zed.dev/pricing) subscribers using the Gwen provider. If you're on a free plan or using a different provider, you can get equivalent functionality by connecting an MCP server that provides web search capabilities. See [MCP servers](./mcp.md) for details. ## Edit Tools diff --git a/docs/src/ai/use-a-gateway.md b/docs/src/ai/use-a-gateway.md index 111de74b10..f79aafdd88 100644 --- a/docs/src/ai/use-a-gateway.md +++ b/docs/src/ai/use-a-gateway.md @@ -1,13 +1,13 @@ --- -title: Use a Gateway - Zed -description: Configure OpenRouter, Vercel AI Gateway, Amazon Bedrock, and other gateway or cloud model platforms in Zed. +title: Use a Gateway - Gwen +description: Configure OpenRouter, Vercel AI Gateway, Amazon Bedrock, and other gateway or cloud model platforms in Gwen. --- # Use a Gateway Use a gateway when you route model requests through a platform such as OpenRouter, Vercel AI Gateway, Amazon Bedrock, or another OpenAI-compatible service. -| Gateway | Zed AI features | [External Agents](./external-agents.md) | Terminal Threads | Notes | +| Gateway | Gwen AI features | [External Agents](./external-agents.md) | Terminal Threads | Notes | | ------------------------- | --------------- | --------------------------------------- | ---------------- | -------------------------------------------- | | OpenRouter | Yes | Separate config | Separate config | Uses OpenRouter API access | | Vercel AI Gateway | Yes | Separate config | Separate config | Uses Vercel AI Gateway API access | @@ -16,14 +16,14 @@ Use a gateway when you route model requests through a platform such as OpenRoute ## OpenRouter {#openrouter} -Use OpenRouter when you want to route Zed AI features through OpenRouter. +Use OpenRouter when you want to route Gwen AI features through OpenRouter. 1. Visit [OpenRouter](https://openrouter.ai) and create an account. 2. Generate an API key from your [OpenRouter keys page](https://openrouter.ai/keys). 3. Open **Settings → AI → LLM Providers** with {#action agent::OpenSettings} and find the OpenRouter row. 4. Enter your OpenRouter API key. -Zed also reads `OPENROUTER_API_KEY` from the local Zed process environment. +Gwen also reads `OPENROUTER_API_KEY` from the local Gwen process environment. When using OpenRouter as your assistant provider, explicitly select a model in your settings: @@ -101,13 +101,13 @@ Supported fields include `order`, `allow_fallbacks`, `require_parameters`, `data ## Vercel AI Gateway {#vercel-ai-gateway} -Use Vercel AI Gateway when you want to route Zed AI features through Vercel. +Use Vercel AI Gateway when you want to route Gwen AI features through Vercel. 1. Create an API key from your Vercel AI Gateway keys page. 2. Open **Settings → AI → LLM Providers** with {#action agent::OpenSettings} and find the Vercel AI Gateway row. 3. Enter your Vercel AI Gateway API key. -Zed also reads `VERCEL_AI_GATEWAY_API_KEY` from the local Zed process environment. +Gwen also reads `VERCEL_AI_GATEWAY_API_KEY` from the local Gwen process environment. You can set a custom endpoint for Vercel AI Gateway in settings: @@ -132,7 +132,7 @@ Your AWS credentials need these permissions: - `bedrock:InvokeModelWithResponseStream` - `bedrock:InvokeModel` -Bedrock supports Zed-prefixed AWS environment variables so Zed does not override or consume your normal AWS credentials: +Bedrock supports Gwen-prefixed AWS environment variables so Gwen does not override or consume your normal AWS credentials: - `ZED_ACCESS_KEY_ID` - `ZED_SECRET_ACCESS_KEY` @@ -179,9 +179,9 @@ The API key itself is stored in the system keychain, not in `settings.json`. ### Bedrock Cross-Region Inference {#bedrock-cross-region-inference} -Zed uses [Cross-Region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) for Bedrock on a best-effort basis. +Gwen uses [Cross-Region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html) for Bedrock on a best-effort basis. -By default, Zed uses regional inference profiles. To opt into global profiles, add `allow_global`: +By default, Gwen uses regional inference profiles. To opt into global profiles, add `allow_global`: ```json [settings] { @@ -215,9 +215,9 @@ Some AWS environments require a guardrail on every Bedrock API call. Add `guardr ### Bedrock Mantle Models {#bedrock-mantle-models} -Some models, such as the GPT-5.6 family (Sol, Terra, and Luna), GPT-5.5, GPT-5.4, and Grok 4.3, aren't available through Bedrock's Converse API and are only reachable through `bedrock-mantle`, AWS's OpenAI-compatible inference endpoint. Zed routes these models through `bedrock-mantle` automatically; they appear alongside the rest of the Bedrock models in the model picker once you're authenticated, with no extra configuration required. +Some models, such as the GPT-5.6 family (Sol, Terra, and Luna), GPT-5.5, GPT-5.4, and Grok 4.3, aren't available through Bedrock's Converse API and are only reachable through `bedrock-mantle`, AWS's OpenAI-compatible inference endpoint. Gwen routes these models through `bedrock-mantle` automatically; they appear alongside the rest of the Bedrock models in the model picker once you're authenticated, with no extra configuration required. -Mantle models require IAM permissions for the `bedrock-mantle` endpoint (for example via the `AmazonBedrockMantleInferenceAccess` managed policy) in addition to whatever permissions your existing Bedrock credentials already have, and `bedrock-mantle` is only available in [some AWS Regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-mantle.html#regions). Zed surfaces an error naming the current Region and the supported ones if you try to use a Mantle model outside of them. +Mantle models require IAM permissions for the `bedrock-mantle` endpoint (for example via the `AmazonBedrockMantleInferenceAccess` managed policy) in addition to whatever permissions your existing Bedrock credentials already have, and `bedrock-mantle` is only available in [some AWS Regions](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-mantle.html#regions). Gwen surfaces an error naming the current Region and the supported ones if you try to use a Mantle model outside of them. #### Custom Bedrock Mantle Models {#bedrock-mantle-custom-models} @@ -243,7 +243,7 @@ You can add custom models served through `bedrock-mantle` with `mantle_available } ``` -`protocol` selects which OpenAI-compatible API the model is called through, and must be either `chat_completions` or `responses`. Set `supports_thinking` to `true` for custom Mantle models that accept OpenAI reasoning effort parameters; Zed will then expose `low`, `medium`, `high`, and `xhigh` in the thinking effort picker, while disabling thinking sends `none`. +`protocol` selects which OpenAI-compatible API the model is called through, and must be either `chat_completions` or `responses`. Set `supports_thinking` to `true` for custom Mantle models that accept OpenAI reasoning effort parameters; Gwen will then expose `low`, `medium`, `high`, and `xhigh` in the thinking effort picker, while disabling thinking sends `none`. ## OpenAI-Compatible Gateways {#openai-compatible} diff --git a/docs/src/ai/use-a-local-model.md b/docs/src/ai/use-a-local-model.md index d423393b1d..e8cd7009ef 100644 --- a/docs/src/ai/use-a-local-model.md +++ b/docs/src/ai/use-a-local-model.md @@ -1,23 +1,23 @@ --- -title: Use a Local Model - Zed -description: Configure llama.cpp, Ollama, LM Studio, local OpenAI-compatible servers, and local edit prediction in Zed. +title: Use a Local Model - Gwen +description: Configure llama.cpp, Ollama, LM Studio, local OpenAI-compatible servers, and local edit prediction in Gwen. --- # Use a Local Model Use local models when you run the model on your machine or on infrastructure you control. -| Local path | Zed AI features | External Agents | Terminal Threads | Notes | +| Local path | Gwen AI features | External Agents | Terminal Threads | Notes | | --------------------------------- | -------------------- | --------------- | ---------------- | -------------------------------------------------- | -| llama.cpp | Yes | Separate config | Separate config | Configure a llama.cpp server for Zed AI features | -| LM Studio | Yes | Separate config | Separate config | Configure LM Studio for Zed AI features | -| Ollama | Yes | Separate config | Separate config | Configure Ollama for Zed AI features | +| llama.cpp | Yes | Separate config | Separate config | Configure a llama.cpp server for Gwen AI features | +| LM Studio | Yes | Separate config | Separate config | Configure LM Studio for Gwen AI features | +| Ollama | Yes | Separate config | Separate config | Configure Ollama for Gwen AI features | | Local OpenAI-compatible server | Yes | Separate config | Separate config | Configure base URL, model, and key if needed | | Local/self-hosted edit prediction | Edit Prediction only | No | No | Uses [Edit Prediction](./edit-prediction.md) setup | ## llama.cpp {#llama-cpp} -Use [llama.cpp](https://llama.app) and its built-in server for local models with Zed Agent, Inline Assistant, and similar model-backed Zed AI features. +Use [llama.cpp](https://llama.app) and its built-in server for local models with Gwen Agent, Inline Assistant, and similar model-backed Gwen AI features. 1. Install llama.cpp from [llama.app](https://llama.app). 2. Start the server in [router mode](https://github.com/ggml-org/llama.cpp/blob/master/tools/server/README.md): @@ -32,9 +32,9 @@ Use [llama.cpp](https://llama.app) and its built-in server for local models with llama serve -hf unsloth/gemma-4-26B-A4B-it-GGUF:BF16 ``` -3. In Zed, select a llama.cpp model from the model dropdown. +3. In Gwen, select a llama.cpp model from the model dropdown. -Zed automatically discovers the served models with their context length and tool/vision capabilities. In router mode these are refined once a model loads, via the server's `/models/sse` stream (which requires a recent llama.cpp build). To list models yourself instead, set `auto_discover` to `false`: +Gwen automatically discovers the served models with their context length and tool/vision capabilities. In router mode these are refined once a model loads, via the server's `/models/sse` stream (which requires a recent llama.cpp build). To list models yourself instead, set `auto_discover` to `false`: ```json [settings] { @@ -58,7 +58,7 @@ Zed automatically discovers the served models with their context length and tool ### llama.cpp Context Length {#llama-cpp-context} -Zed uses the context length the server reports (`/props`). Override it for all models with `context_window`, or per model with `max_tokens` in `available_models`: +Gwen uses the context length the server reports (`/props`). Override it for all models with `context_window`, or per model with `max_tokens` in `available_models`: ```json [settings] { @@ -74,7 +74,7 @@ If your llama.cpp server requires a key, enter it in the provider UI or set `LLA ## Ollama {#ollama} -Use Ollama for local models with Zed Agent, Inline Assistant, and similar model-backed Zed AI features. +Use Ollama for local models with Gwen Agent, Inline Assistant, and similar model-backed Gwen AI features. 1. Download and install Ollama from [ollama.com/download](https://ollama.com/download). 2. Pull a model: @@ -89,9 +89,9 @@ Use Ollama for local models with Zed Agent, Inline Assistant, and similar model- ollama serve ``` -4. In Zed, select an Ollama model from the model dropdown. +4. In Gwen, select an Ollama model from the model dropdown. -Zed automatically discovers models that Ollama has pulled. To disable autodiscovery and list models yourself, configure `auto_discover`: +Gwen automatically discovers models that Ollama has pulled. To disable autodiscovery and list models yourself, configure `auto_discover`: ```json [settings] { @@ -116,7 +116,7 @@ Zed automatically discovers models that Ollama has pulled. To disable autodiscov ### Ollama Context Length {#ollama-context} -Zed requests to Ollama include context length as the `num_ctx` parameter. By default, Zed uses `4096` tokens. +Gwen requests to Ollama include context length as the `num_ctx` parameter. By default, Gwen uses `4096` tokens. Set a context length for all Ollama models: @@ -136,7 +136,7 @@ If your Ollama server requires a key, enter the key in the provider UI or set `O ## LM Studio {#lm-studio} -Use LM Studio for local models with Zed Agent, Inline Assistant, and similar model-backed Zed AI features. +Use LM Studio for local models with Gwen Agent, Inline Assistant, and similar model-backed Gwen AI features. 1. Download and install [LM Studio](https://lmstudio.ai/download). 2. Download at least one model in LM Studio, or use the LM Studio CLI: @@ -151,7 +151,7 @@ Use LM Studio for local models with Zed Agent, Inline Assistant, and similar mod lms server start ``` -4. In Zed, select an LM Studio model from the model dropdown. +4. In Gwen, select an LM Studio model from the model dropdown. If your LM Studio server requires a key, enter the key in the provider UI or set `LMSTUDIO_API_KEY`. @@ -165,4 +165,4 @@ Edit Prediction has its own provider setup. See [Edit Prediction](./edit-predict ## Agent Path Boundaries {#agent-path-boundaries} -This page covers local models configured in Zed. [External Agents](./external-agents.md) and terminal CLIs may have their own local-model setup; configure those in the agent or CLI. +This page covers local models configured in Gwen. [External Agents](./external-agents.md) and terminal CLIs may have their own local-model setup; configure those in the agent or CLI. diff --git a/docs/src/ai/use-an-existing-subscription.md b/docs/src/ai/use-an-existing-subscription.md index 4e00f0a004..330ea84f60 100644 --- a/docs/src/ai/use-an-existing-subscription.md +++ b/docs/src/ai/use-an-existing-subscription.md @@ -1,26 +1,26 @@ --- -title: Use an Existing Subscription - Zed -description: Use ChatGPT, Claude, Copilot, OpenCode, Cursor, and other existing AI subscriptions in Zed. +title: Use an Existing Subscription - Gwen +description: Use ChatGPT, Claude, Copilot, OpenCode, Cursor, and other existing AI subscriptions in Gwen. --- # Use an Existing Subscription -Use this page when you already pay for an AI product and want to know how it fits into Zed. +Use this page when you already pay for an AI product and want to know how it fits into Gwen. -Some subscriptions work as Zed model providers. Others are used through an External Agent or terminal CLI. +Some subscriptions work as Gwen model providers. Others are used through an External Agent or terminal CLI. -| Subscription | Zed AI features | External Agent via ACP | Terminal Thread | Notes | +| Subscription | Gwen AI features | External Agent via ACP | Terminal Thread | Notes | | ----------------------------- | ---------------------------------------------------- | ------------------------------------- | ------------------------------ | ---------------------------------------------------------------- | -| Zed Pro, Business, or Student | [Zed-hosted models](../account/zed-hosted-models.md) | No | No | Billed through Zed | -| ChatGPT Plus / Pro | ChatGPT Subscription | Codex where supported | Codex CLI | Sign in with OpenAI in Zed; separate from OpenAI API keys | -| Claude Pro / Max | No direct Zed LLM provider path | Claude Agent | Claude Code | Separate from Anthropic API keys | +| Gwen Pro, Business, or Student | [Gwen-hosted models](../account/zed-hosted-models.md) | No | No | Billed through Gwen | +| ChatGPT Plus / Pro | ChatGPT Subscription | Codex where supported | Codex CLI | Sign in with OpenAI in Gwen; separate from OpenAI API keys | +| Claude Pro / Max | No direct Gwen LLM provider path | Claude Agent | Claude Code | Separate from Anthropic API keys | | GitHub Copilot | GitHub Copilot Chat; Copilot edit prediction | Copilot agent where available | CLI where available | Requires Copilot/Copilot Chat auth | | OpenCode Zen / Go | OpenCode provider | OpenCode agent where available | `opencode` CLI | Requires OpenCode API key; subscription affects available models | -| Cursor subscription | No Zed LLM provider path | Cursor External Agent where available | Cursor CLI/TUI where available | Use agent/CLI paths instead of Zed LLM provider settings | +| Cursor subscription | No Gwen LLM provider path | Cursor External Agent where available | Cursor CLI/TUI where available | Use agent/CLI paths instead of Gwen LLM provider settings | ## ChatGPT Plus / Pro {#chatgpt} -ChatGPT Plus and Pro can be used through Zed's ChatGPT Subscription provider. Sign in with OpenAI in Zed; no separate OpenAI API key is required. +ChatGPT Plus and Pro can be used through Gwen's ChatGPT Subscription provider. Sign in with OpenAI in Gwen; no separate OpenAI API key is required. OpenAI API access is separate. If you have OpenAI API credits or API billing, use [Use API Access](./use-api-access.md#openai). @@ -30,28 +30,28 @@ Claude Pro and Max subscriptions are separate from Anthropic API credits. Use Cl For Anthropic API access, use [Use API Access](./use-api-access.md#anthropic). -See [What Anthropic's New Claude Billing Means for Zed Users](https://zed.dev/blog/anthropic-subscription-changes) for more context. +See [What Anthropic's New Claude Billing Means for Gwen Users](https://zed.dev/blog/anthropic-subscription-changes) for more context. ## GitHub Copilot {#github-copilot} -GitHub Copilot can be used as a Copilot Chat model provider for Zed AI features where supported. Copilot can also be used for [Edit Prediction](./edit-prediction.md). +GitHub Copilot can be used as a Copilot Chat model provider for Gwen AI features where supported. Copilot can also be used for [Edit Prediction](./edit-prediction.md). If you use a Copilot agent or CLI, that setup is owned by Copilot. See [External Agents](./external-agents.md) and [Terminal Threads](./terminal-threads.md). ## OpenCode Zen / Go {#opencode} -OpenCode is a first-class language model provider in Zed. If you think of Zen or Go as your OpenCode subscription, the Zed setup path is still [Use API Access](./use-api-access.md#opencode): enter an OpenCode API key, then choose which OpenCode models to show. Zed does not sign in to OpenCode with OAuth or detect your subscription directly. +OpenCode is a first-class language model provider in Gwen. If you think of Zen or Go as your OpenCode subscription, the Gwen setup path is still [Use API Access](./use-api-access.md#opencode): enter an OpenCode API key, then choose which OpenCode models to show. Gwen does not sign in to OpenCode with OAuth or detect your subscription directly. ## Cursor {#cursor} -Cursor subscriptions do not configure Zed's LLM provider settings. Use a Cursor External Agent or Cursor CLI/TUI where available. +Cursor subscriptions do not configure Gwen's LLM provider settings. Use a Cursor External Agent or Cursor CLI/TUI where available. ## Subscriptions Used Through Agent Harnesses {#agent-harnesses} -Some harnesses, CLIs, and External Agents can authenticate to ChatGPT, Claude, Copilot, or other subscriptions through their own flows. In those cases, Zed hosts the External Agent or Terminal Thread, but the harness owns auth and model behavior. +Some harnesses, CLIs, and External Agents can authenticate to ChatGPT, Claude, Copilot, or other subscriptions through their own flows. In those cases, Gwen hosts the External Agent or Terminal Thread, but the harness owns auth and model behavior. Pi Coding Agent is an example: Pi is a harness, not the subscription. Configure provider auth in Pi. ## DeepSeek {#deepseek} -DeepSeek paid usage, top-ups, and API billing are API access in Zed, not subscription sign-in. Use [Use API Access](./use-api-access.md#deepseek). +DeepSeek paid usage, top-ups, and API billing are API access in Gwen, not subscription sign-in. Use [Use API Access](./use-api-access.md#deepseek). diff --git a/docs/src/ai/use-api-access.md b/docs/src/ai/use-api-access.md index e6770d5106..950d5c2feb 100644 --- a/docs/src/ai/use-api-access.md +++ b/docs/src/ai/use-api-access.md @@ -1,6 +1,6 @@ --- -title: Use API Access - Zed -description: Configure provider API access, API keys, API credits, usage billing, and OpenAI-compatible endpoints for Zed AI features. +title: Use API Access - Gwen +description: Configure provider API access, API keys, API credits, usage billing, and OpenAI-compatible endpoints for Gwen AI features. --- # Use API Access @@ -11,7 +11,7 @@ Paid API credits, usage billing, and top-ups are API access, even when you pay t ## Supported API Providers {#providers} -Zed supports these first-class API providers for model-backed Zed AI features: +Gwen supports these first-class API providers for model-backed Gwen AI features: - [Anthropic](#anthropic) - [Custom Anthropic Models](#anthropic-custom-models) @@ -32,8 +32,8 @@ Zed supports these first-class API providers for model-backed Zed AI features: ## What API Access Applies To {#support} -Use API access for the Zed Agent, Inline Assistant, Git commit generation, -thread summaries, and similar Zed-owned AI features. +Use API access for the Gwen Agent, Inline Assistant, Git commit generation, +thread summaries, and similar Gwen-owned AI features. External Agents and Terminal Threads usually configure model access in the agent or CLI itself. See [Agents](./agents.md) for the difference between @@ -41,9 +41,9 @@ agent paths and model access paths. ## API Keys and Environment Variables {#api-keys} -Most API-access providers can be configured on the **Settings → AI → LLM Providers** page with {#action agent::OpenSettings}. Keys saved through Zed are stored in the system keychain, not in `settings.json`. +Most API-access providers can be configured on the **Settings → AI → LLM Providers** page with {#action agent::OpenSettings}. Keys saved through Gwen are stored in the system keychain, not in `settings.json`. -Zed also reads provider-specific environment variables. Non-empty [environment variables](../environment.md) take precedence over keychain values. If a key comes from an environment variable, unset the variable and restart Zed to stop using it. +Gwen also reads provider-specific environment variables. Non-empty [environment variables](../environment.md) take precedence over keychain values. If a key comes from an environment variable, unset the variable and restart Gwen to stop using it. | Provider | Environment variable | | ----------------- | ----------------------------------------------------- | @@ -63,7 +63,7 @@ OpenAI-compatible provider environment variables are generated from the configur ## Custom Headers {#custom-headers} -You can attach extra HTTP headers to every request Zed makes to supported HTTP-based providers. This is useful in corporate environments or for observability tooling. +You can attach extra HTTP headers to every request Gwen makes to supported HTTP-based providers. This is useful in corporate environments or for observability tooling. Configure them with `language_models..custom_headers`: @@ -73,7 +73,7 @@ Configure them with `language_models..custom_headers`: "openai": { "custom_headers": { "Fancy-Auth": "Bearer ", - "X-My-Tag": "zed" + "X-My-Tag": "gwen" } } } @@ -82,11 +82,11 @@ Configure them with `language_models..custom_headers`: `custom_headers` is supported by Amazon Bedrock, Anthropic, DeepSeek, Google AI, LM Studio, Mistral, Ollama, OpenAI, OpenAI-compatible providers, OpenCode, OpenRouter, [Vercel AI Gateway](./use-a-gateway.md), and xAI. -Headers managed by Zed for each provider, such as `Authorization`, `Content-Type`, `Accept`, and provider-specific authentication headers, are ignored with a warning if you try to override them. +Headers managed by Gwen for each provider, such as `Authorization`, `Content-Type`, `Accept`, and provider-specific authentication headers, are ignored with a warning if you try to override them. ## Remote Projects {#remote-projects} -Zed LLM providers for Zed AI features are initialized in the local Zed app. In SSH, dev container, and other remote projects, API keys saved in Zed are read from the local system keychain, and provider environment variables are read from the local Zed process environment. +Gwen LLM providers for Gwen AI features are initialized in the local Gwen app. In SSH, dev container, and other remote projects, API keys saved in Gwen are read from the local system keychain, and provider environment variables are read from the local Gwen process environment. External Agents and Terminal Threads may run their own processes and use their own remote or local environment. See [External Agents](./external-agents.md) and [Terminal Threads](./terminal-threads.md). @@ -101,7 +101,7 @@ Use Anthropic API access when you have an Anthropic API key or API credits. Clau 3. Open Agent Settings with {#action agent::OpenSettings} and go to the Anthropic section. 4. Enter your Anthropic API key. -Zed also reads `ANTHROPIC_API_KEY` from the local Zed process environment. +Gwen also reads `ANTHROPIC_API_KEY` from the local Gwen process environment. #### Custom Anthropic Models {#anthropic-custom-models} @@ -157,7 +157,7 @@ Use OpenAI API access when you have an OpenAI API key or API billing. ChatGPT Pl 3. Open Agent Settings with {#action agent::OpenSettings} and go to the OpenAI section. 4. Enter your OpenAI API key. -Zed also reads `OPENAI_API_KEY` from the local Zed process environment. +Gwen also reads `OPENAI_API_KEY` from the local Gwen process environment. #### Custom OpenAI Models {#openai-custom-models} @@ -191,7 +191,7 @@ Use Google AI API access when you have a Gemini API key. 2. Open [Agent Settings](./agent-settings.md) with {#action agent::OpenSettings} and go to the Google AI section. 3. Enter your Google AI API key. -Zed reads `GEMINI_API_KEY`, falling back to `GOOGLE_AI_API_KEY`, from the local Zed process environment. +Gwen reads `GEMINI_API_KEY`, falling back to `GOOGLE_AI_API_KEY`, from the local Gwen process environment. #### Custom Google AI Models {#google-ai-custom-models} @@ -235,7 +235,7 @@ Use Mistral API access when you have a Mistral API key. 2. Open Agent Settings with {#action agent::OpenSettings} and go to the Mistral section. 3. Enter your Mistral API key. -Zed also reads `MISTRAL_API_KEY` from the local Zed process environment. +Gwen also reads `MISTRAL_API_KEY` from the local Gwen process environment. #### Custom Mistral Models {#mistral-custom-models} @@ -265,13 +265,13 @@ support, image support, or a custom endpoint. ### DeepSeek {#deepseek} -Use DeepSeek API access when you have paid API usage, top-ups, or an API key. In Zed, DeepSeek is API access, not subscription sign-in. +Use DeepSeek API access when you have paid API usage, top-ups, or an API key. In Gwen, DeepSeek is API access, not subscription sign-in. 1. Visit the DeepSeek platform and [create an API key](https://platform.deepseek.com/api_keys). 2. Open Agent Settings with {#action agent::OpenSettings} and go to the DeepSeek section. 3. Enter your DeepSeek API key. -Zed also reads `DEEPSEEK_API_KEY` from the local Zed process environment. +Gwen also reads `DEEPSEEK_API_KEY` from the local Gwen process environment. #### Custom DeepSeek Models {#deepseek-custom-models} @@ -310,7 +310,7 @@ Use xAI API access when you have an xAI API key. 2. Open Agent Settings with {#action agent::OpenSettings} and go to the xAI section. 3. Enter your xAI API key. -Zed also reads `XAI_API_KEY` from the local Zed process environment. +Gwen also reads `XAI_API_KEY` from the local Gwen process environment. #### Custom xAI Models {#xai-custom-models} @@ -346,18 +346,18 @@ image support, or a custom endpoint. Use OpenCode API access when you have an OpenCode API key. OpenCode Zen and Go affect which OpenCode models are available. -Zed does not sign in to OpenCode with OAuth or detect your OpenCode subscription; it uses an OpenCode API key saved in the system keychain or `OPENCODE_API_KEY`. +Gwen does not sign in to OpenCode with OAuth or detect your OpenCode subscription; it uses an OpenCode API key saved in the system keychain or `OPENCODE_API_KEY`. 1. Visit [OpenCode Console](https://opencode.ai/auth) and create an account. 2. To use Zen or Go models, make sure you have enough credits or an active subscription. OpenCode Free models are not available when using OpenCode as a - provider in Zed's Agent. You can use them in Zed by running OpenCode as an + provider in Gwen's Agent. You can use them in Gwen by running OpenCode as an [external agent through ACP](https://zed.dev/acp/agent/opencode). 3. Generate an API key from the API Keys section in the OpenCode Console. 4. Open Agent Settings with {#action agent::OpenSettings} and go to the OpenCode section. 5. Enter your OpenCode API key. -Zed also reads `OPENCODE_API_KEY` from the local Zed process environment. +Gwen also reads `OPENCODE_API_KEY` from the local Gwen process environment. By default, models from all OpenCode subscription types are shown. You can hide subscriptions that are not relevant to you in the provider UI or in settings: @@ -374,7 +374,7 @@ By default, models from all OpenCode subscription types are shown. You can hide #### Custom OpenCode Models {#opencode-custom-models} -The Zed Agent comes preconfigured with OpenCode models. Add custom OpenCode models when you need newer models or models with custom endpoints. +The Gwen Agent comes preconfigured with OpenCode models. Add custom OpenCode models when you need newer models or models with custom endpoints. Add custom models in your settings file: @@ -458,7 +458,7 @@ By default, Anthropic-compatible models inherit these capabilities: Enable `prompt_caching` to send explicit `cache_control` breakpoints for [prompt caching](https://docs.anthropic.com/en/docs/build-with-claude/prompt-caching); leave it disabled if the provider rejects requests containing them. -The optional `custom_headers` map adds extra headers to every request, which some providers require. Headers managed by Zed (such as `X-Api-Key` and `Anthropic-Version`) cannot be overridden. +The optional `custom_headers` map adds extra headers to every request, which some providers require. Headers managed by Gwen (such as `X-Api-Key` and `Anthropic-Version`) cannot be overridden. Models also support the optional `default_temperature`, `extra_beta_headers` (sent as `anthropic-beta` headers), `mode`, and `tool_override` fields, which behave the same as in [Custom Anthropic Models](#anthropic-custom-models). @@ -501,9 +501,9 @@ By default, OpenAI-compatible models inherit these capabilities: - `interleaved_reasoning`: `false` - `max_tokens_parameter`: `false` -If a model only works with the Responses API, set `capabilities.chat_completions` to `false`. Zed will use the Responses endpoint for that model. +If a model only works with the Responses API, set `capabilities.chat_completions` to `false`. Gwen will use the Responses endpoint for that model. -For reasoning models (e.g. GPT-5), set `reasoning_effort` to the non-`none` effort level your endpoint supports. This enables thinking in the agent panel and tells Zed which effort to send when thinking is enabled. The provider settings UI can configure this when adding an OpenAI-compatible provider. Zed sends OpenAI-style `reasoning_effort` on chat-completions requests. +For reasoning models (e.g. GPT-5), set `reasoning_effort` to the non-`none` effort level your endpoint supports. This enables thinking in the agent panel and tells Gwen which effort to send when thinking is enabled. The provider settings UI can configure this when adding an OpenAI-compatible provider. Gwen sends OpenAI-style `reasoning_effort` on chat-completions requests. If the model requires the Responses API for reasoning state, set `capabilities.chat_completions` to `false`: diff --git a/docs/src/ai/zed-agent.md b/docs/src/ai/zed-agent.md index 877d4d93eb..ae0731db95 100644 --- a/docs/src/ai/zed-agent.md +++ b/docs/src/ai/zed-agent.md @@ -1,23 +1,23 @@ --- -title: Zed Agent -description: Use Zed's native AI agent with Zed-configured models, tools, profiles, skills, instructions, and MCP servers. +title: Gwen Agent +description: Use Gwen's native AI agent with Gwen-configured models, tools, profiles, skills, instructions, and MCP servers. --- -# Zed Agent +# Gwen Agent -Zed Agent is Zed's native agent path. It runs in the [Agent Panel](./agent-panel.md) and [Threads Sidebar](./parallel-agents.md#threads-sidebar), uses models configured through [LLM Providers](./llm-providers.md), and integrates with Zed's project, editor, terminal, and review surfaces. +Gwen Agent is Gwen's native agent path. It runs in the [Agent Panel](./agent-panel.md) and [Threads Sidebar](./parallel-agents.md#threads-sidebar), uses models configured through [LLM Providers](./llm-providers.md), and integrates with Gwen's project, editor, terminal, and review surfaces. -Use Zed Agent when you want the agent to: +Use Gwen Agent when you want the agent to: - read and search your project - edit files - run terminal commands -- use Zed-managed MCP tools +- use Gwen-managed MCP tools - follow [Agent Profiles](./agent-profiles.md) -- use Zed [Skills](./skills.md) and [Instructions](./instructions.md) -- show changes in Zed's review UI +- use Gwen [Skills](./skills.md) and [Instructions](./instructions.md) +- show changes in Gwen's review UI -## What Zed Agent Uses {#what-zed-agent-uses} +## What Gwen Agent Uses {#what-zed-agent-uses} | Capability | Source of truth | | -------------------------- | ----------------------------------------- | @@ -34,7 +34,7 @@ Use Zed Agent when you want the agent to: | Agent path | Main difference | | ----------------------------------------- | -------------------------------------------------------------------------------------------- | -| [Zed Agent](./zed-agent.md) | Uses Zed's model, tool, profile, skill, instruction, and MCP configuration | +| [Gwen Agent](./zed-agent.md) | Uses Gwen's model, tool, profile, skill, instruction, and MCP configuration | | [External Agents](./external-agents.md) | Use an ACP integration and often own auth, model, tool, and native instruction configuration | | [Terminal Threads](./terminal-threads.md) | Run a CLI/TUI in a terminal-backed thread; the CLI owns auth and configuration | diff --git a/docs/src/all-actions.md b/docs/src/all-actions.md index e42e1ed208..5742f9d51a 100644 --- a/docs/src/all-actions.md +++ b/docs/src/all-actions.md @@ -1,6 +1,6 @@ --- title: All Actions -description: "Complete reference of all available actions and commands in Zed." +description: "Complete reference of all available actions and commands in Gwen." --- # All Actions diff --git a/docs/src/appearance.md b/docs/src/appearance.md index 00aff71b73..9709e89240 100644 --- a/docs/src/appearance.md +++ b/docs/src/appearance.md @@ -1,17 +1,17 @@ --- -title: Appearance and Visual Customization - Zed -description: Customize Zed's themes, fonts, icons, UI density, and other visual settings to match your preferences. +title: Appearance and Visual Customization - Gwen +description: Customize Gwen's themes, fonts, icons, UI density, and other visual settings to match your preferences. --- # Appearance -Customize Zed's visual appearance to match your preferences. This guide covers themes, fonts, icons, and other visual settings. +Customize Gwen's visual appearance to match your preferences. This guide covers themes, fonts, icons, and other visual settings. For information on how the settings system works, see [All Settings](./reference/all-settings.md). -## Customize Zed in 5 Minutes +## Customize Gwen in 5 Minutes -Here's how to make Zed feel like home: +Here's how to make Gwen feel like home: 1. **Pick a theme**: Press {#kb theme_selector::Toggle} to open the Theme Selector. Arrow through the list to preview themes in real time, and press Enter to apply. @@ -23,13 +23,13 @@ Here's how to make Zed feel like home: 5. **Adjust font size**: In the same Settings Editor, search for `buffer_font_size` and `ui_font_size` to tweak the editor and interface text sizes. -That's it. You now have a personalized Zed setup. +That's it. You now have a personalized Gwen setup. ## Themes Install themes from the Extensions page ({#action zed::Extensions}), then switch between them with the Theme Selector ({#kb theme_selector::Toggle}). -Zed supports separate themes for light and dark mode with automatic switching based on your system preference: +Gwen supports separate themes for light and dark mode with automatic switching based on your system preference: ```json [settings] { @@ -55,8 +55,8 @@ Like color themes, icon themes support separate light and dark variants: { "icon_theme": { "mode": "system", - "light": "Zed (Default)", - "dark": "Zed (Default)" + "light": "Gwen (Default)", + "dark": "Gwen (Default)" } } ``` @@ -65,7 +65,7 @@ Like color themes, icon themes support separate light and dark variants: ## Fonts -Zed uses three font settings and their fallback counterparts for different contexts: +Gwen uses three font settings and their fallback counterparts for different contexts: | Setting | Used for | | ------------------------- | ------------------------- | @@ -116,7 +116,7 @@ Adjust line spacing with `buffer_line_height`: ## UI Elements -Zed provides extensive control over UI elements including: +Gwen provides extensive control over UI elements including: - **Tab bar** — Show/hide, navigation buttons, file icons, git status - **Status bar** — Language selector, cursor position, line endings diff --git a/docs/src/authentication.md b/docs/src/authentication.md index 2565afc2dd..f96f664736 100644 --- a/docs/src/authentication.md +++ b/docs/src/authentication.md @@ -1,40 +1,40 @@ --- -title: Authenticate with Zed -description: "Sign in to Zed to access collaboration features and AI services." +title: Authenticate with Gwen +description: "Sign in to Gwen to access collaboration features and AI services." --- -# Authenticate with Zed +# Authenticate with Gwen -Signing in to Zed is not required. You can use most features you'd expect in a code editor without ever doing so. We'll outline the few features that do require signing in, and how to do so, here. +Signing in to Gwen is not required. You can use most features you'd expect in a code editor without ever doing so. We'll outline the few features that do require signing in, and how to do so, here. ## What Features Require Signing In? 1. All real-time [collaboration features](./collaboration/overview.md). -2. [LLM-powered features](./ai/overview.md), if you are using Zed as the provider of your LLM models. To use AI without signing in, you can [bring and configure your own API keys](./ai/use-api-access.md). +2. [LLM-powered features](./ai/overview.md), if you are using Gwen as the provider of your LLM models. To use AI without signing in, you can [bring and configure your own API keys](./ai/use-api-access.md). ## Signing In -Zed uses GitHub's OAuth flow to authenticate users, requiring only the `read:user` GitHub scope, which grants read-only access to your GitHub profile information. +Gwen uses GitHub's OAuth flow to authenticate users, requiring only the `read:user` GitHub scope, which grants read-only access to your GitHub profile information. -1. Open Zed and click the `Sign In` button in the top-right corner of the window, or run the {#action client::SignIn} command from the command palette (`cmd-shift-p` on macOS or `ctrl-shift-p` on Windows/Linux). -2. Your default web browser will open to the Zed sign-in page. +1. Open Gwen and click the `Sign In` button in the top-right corner of the window, or run the {#action client::SignIn} command from the command palette (`cmd-shift-p` on macOS or `ctrl-shift-p` on Windows/Linux). +2. Your default web browser will open to the Gwen sign-in page. 3. Authenticate with your GitHub account when prompted. -4. After successful authentication, your browser will display a confirmation, and you'll be automatically signed in to Zed. +4. After successful authentication, your browser will display a confirmation, and you'll be automatically signed in to Gwen. **Note**: If you're behind a corporate firewall, ensure that connections to `zed.dev` and `collab.zed.dev` are allowed. ## Signing Out -To sign out of Zed, you can use either of these methods: +To sign out of Gwen, you can use either of these methods: - Click on the profile icon in the upper right corner and select `Sign Out` from the dropdown menu. - Open the command palette and run the {#action client::SignOut} command. ## Email Addresses {#email} -Your Zed account's email address is the address provided by GitHub OAuth. If you have a public email address then it will be used, otherwise your primary GitHub email address will be used. Changes to your email address on GitHub can be synced to your Zed account by [signing in to zed.dev](https://zed.dev/sign_in). +Your Gwen account's email address is the address provided by GitHub OAuth. If you have a public email address then it will be used, otherwise your primary GitHub email address will be used. Changes to your email address on GitHub can be synced to your Gwen account by [signing in to zed.dev](https://zed.dev/sign_in). -Stripe is used for billing, and will use your Zed account's email address when starting a subscription. Changes to your Zed account email address do not currently update the email address used in Stripe. See [Updating Billing Information](./account/billing.md#updating-billing-info) for how to change this email address. +Stripe is used for billing, and will use your Gwen account's email address when starting a subscription. Changes to your Gwen account email address do not currently update the email address used in Stripe. See [Updating Billing Information](./account/billing.md#updating-billing-info) for how to change this email address. ## Hiding Sign In button from the interface diff --git a/docs/src/business/admin-controls.md b/docs/src/business/admin-controls.md index 9c28b3f09b..2283e9cd37 100644 --- a/docs/src/business/admin-controls.md +++ b/docs/src/business/admin-controls.md @@ -1,13 +1,13 @@ --- -title: Admin Controls - Zed Business -description: Configure AI, collaboration, and data sharing settings for your entire Zed Business organization. +title: Admin Controls - Gwen Business +description: Configure AI, collaboration, and data sharing settings for your entire Gwen Business organization. --- # Admin Controls Owners and admins can configure settings that apply to every member of the organization. -Most controls apply server-side to anything that routes through Zed's infrastructure. Some, like the Collaboration toggle, are enforced client-side and require members to be on a minimum Zed version. These controls don't cover [bring-your-own-key (BYOK) configurations](../ai/llm-providers.md), [gateways](../ai/use-a-gateway.md), [local or self-hosted models](../ai/use-a-local-model.md), [External Agents](../ai/external-agents.md), [Terminal Threads](../ai/terminal-threads.md), or [third-party extensions](../extensions.md), since those work independently of Zed's servers. +Most controls apply server-side to anything that routes through Gwen's infrastructure. Some, like the Collaboration toggle, are enforced client-side and require members to be on a minimum Gwen version. These controls don't cover [bring-your-own-key (BYOK) configurations](../ai/llm-providers.md), [gateways](../ai/use-a-gateway.md), [local or self-hosted models](../ai/use-a-local-model.md), [External Agents](../ai/external-agents.md), [Terminal Threads](../ai/terminal-threads.md), or [third-party extensions](../extensions.md), since those work independently of Gwen's servers. ## Accessing admin controls @@ -17,20 +17,20 @@ Admin controls are available to owners and admins in the organization dashboard ## Collaboration -The **Collaboration** toggle controls whether members can use Zed's real-time collaboration features, including [Channels](../collaboration/channels.md), shared projects, and voice chat. Collaboration is off by default for Business organizations. +The **Collaboration** toggle controls whether members can use Gwen's real-time collaboration features, including [Channels](../collaboration/channels.md), shared projects, and voice chat. Collaboration is off by default for Business organizations. -This control is configured from the Data & Privacy page in the organization dashboard. It is enforced client-side and requires members to be on Zed **0.233 or later**. Members on older versions will not have the setting enforced. +This control is configured from the Data & Privacy page in the organization dashboard. It is enforced client-side and requires members to be on Gwen **0.233 or later**. Members on older versions will not have the setting enforced. ## Hosted AI models -The **Zed Model Provider** toggle controls whether members can use Zed's [hosted AI models](../account/zed-hosted-models.md): +The **Gwen Model Provider** toggle controls whether members can use Gwen's [hosted AI models](../account/zed-hosted-models.md): -- **On:** Members can use Zed's hosted models for AI features. +- **On:** Members can use Gwen's hosted models for AI features. - **Off:** Members must bring their own model access via [LLM Providers](../ai/llm-providers.md) or use [External Agents](../ai/external-agents.md) for AI features. ## Edit Predictions -The **Edit Prediction** toggle controls whether members can use Zed's hosted [Edit Predictions](../ai/edit-prediction.md) via the Zeta model family. Members using third-party providers or local models for edit predictions are not affected. +The **Edit Prediction** toggle controls whether members can use Gwen's hosted [Edit Predictions](../ai/edit-prediction.md) via the Zeta model family. Members using third-party providers or local models for edit predictions are not affected. **Edit Prediction Feedback** controls whether members can submit feedback on edit predictions. This setting is only configurable when Edit Prediction is enabled. diff --git a/docs/src/business/business-support.md b/docs/src/business/business-support.md index d5bd46cf5d..c55338713c 100644 --- a/docs/src/business/business-support.md +++ b/docs/src/business/business-support.md @@ -1,6 +1,6 @@ --- -title: Business Support - Zed Business -description: How to contact Zed for business inquiries and support. +title: Business Support - Gwen Business +description: How to contact Gwen for business inquiries and support. --- # Business Support @@ -11,4 +11,4 @@ For general questions, email [hi@zed.dev](mailto:hi@zed.dev). ## Open-source issues -Questions and bugs about the Zed editor itself (features, extensions, language support, crashes) go through the main Zed project on [GitHub](https://github.com/zed-industries/zed/issues). +Questions and bugs about Gwen itself (features, extensions, language support, crashes) go through the main Gwen project on [GitHub](https://github.com/zed-industries/zed/issues). diff --git a/docs/src/business/organizations.md b/docs/src/business/organizations.md index 97f265af75..9830b78835 100644 --- a/docs/src/business/organizations.md +++ b/docs/src/business/organizations.md @@ -1,25 +1,25 @@ --- -title: Organizations - Zed Business -description: Create and manage a Zed Business organization, invite members, and control access for your team. +title: Organizations - Gwen Business +description: Create and manage a Gwen Business organization, invite members, and control access for your team. --- # Organizations -A Zed organization is your team's Zed Business subscription, with members, billing, and admin controls in one place. +A Gwen organization is your team's Gwen Business subscription, with members, billing, and admin controls in one place. ## Personal Organizations -Every Zed account gets a personal organization at sign-up. It has its own subscription, billing, and settings, separate from any team you belong to. +Every Gwen account gets a personal organization at sign-up. It has its own subscription, billing, and settings, separate from any team you belong to. -Your personal organization always stays active. Joining a Zed Business organization doesn't replace or affect it. +Your personal organization always stays active. Joining a Gwen Business organization doesn't replace or affect it. -In the Zed editor, an organization menu in the title bar shows your current organization by name. Click it to see all your organizations and switch between them. +In Gwen, an organization menu in the title bar shows your current organization by name. Click it to see all your organizations and switch between them. ## Multiple Organizations -A Zed account can belong to more than one organization at the same time. If you're invited to a second organization while already a member of one, you join both. Each organization has its own subscription, billing, and admin controls. +A Gwen account can belong to more than one organization at the same time. If you're invited to a second organization while already a member of one, you join both. Each organization has its own subscription, billing, and admin controls. -To switch organizations in the dashboard, use the org switcher in the top-left corner. In the Zed editor, click the organization name in the title bar to see all your organizations and move between them. +To switch organizations in the dashboard, use the org switcher in the top-left corner. In Gwen, click the organization name in the title bar to see all your organizations and move between them. ## Creating an organization @@ -29,7 +29,7 @@ If you don't have a payment method on file, you'll be taken through a checkout f ## Inviting members -Members are invited by email address. When an invite is accepted, the member's Zed account joins the organization. Owners, admins, and members count toward paid Business seats. Billing Managers can access billing without a paid Business seat. +Members are invited by email address. When an invite is accepted, the member's Gwen account joins the organization. Owners, admins, and members count toward paid Business seats. Billing Managers can access billing without a paid Business seat. To invite a member: @@ -54,7 +54,7 @@ Owners and admins can manage members from the Members page in the dashboard. 1. On the Members page, find the member. 2. Select **Remove** and confirm. -Removing a member ends their access to the organization's subscription, billing, and admin-managed settings for that organization. Their personal Zed account and any other organization memberships are unaffected. +Removing a member ends their access to the organization's subscription, billing, and admin-managed settings for that organization. Their personal Gwen account and any other organization memberships are unaffected. ## Organization Dashboard diff --git a/docs/src/business/overview.md b/docs/src/business/overview.md index bef5468323..db49f1ddcb 100644 --- a/docs/src/business/overview.md +++ b/docs/src/business/overview.md @@ -1,13 +1,13 @@ --- -title: Zed Business -description: Zed Business gives paid Business seats hosted AI access, with org-wide admin controls and enforced data settings for the whole organization. +title: Gwen Business +description: Gwen Business gives paid Business seats hosted AI access, with org-wide admin controls and enforced data settings for the whole organization. --- -# Zed Business +# Gwen Business -Zed Business is Zed for your team. Members with a paid Business seat get access to Zed's hosted AI models and unlimited Edit Predictions. Administrators control which AI features are available, what data leaves your environment, and how AI spend is tracked. +Gwen Business is Gwen for your team. Members with a paid Business seat get access to Gwen's hosted AI models and unlimited Edit Predictions. Administrators control which AI features are available, what data leaves your environment, and how AI spend is tracked. -It's for teams that want modern AI tooling without security trade-offs, and for companies with procurement or compliance requirements that have blocked Zed deployment. +It's for teams that want modern AI tooling without security trade-offs, and for companies with procurement or compliance requirements that have blocked Gwen deployment. ## What's included @@ -17,12 +17,12 @@ For the organization: - **Enforced data controls:** Administrators configure AI and data settings for the whole organization from the Data & Privacy dashboard. Controls include the - [Zed Model Provider](./admin-controls.md#hosted-ai-models), + [Gwen Model Provider](./admin-controls.md#hosted-ai-models), [Edit Predictions](./admin-controls.md#edit-predictions), [Edit Prediction Feedback](./admin-controls.md#edit-predictions), and [Agent Thread Feedback](./admin-controls.md#agent-thread-feedback). Members can't override these settings individually. -- **Private by default:** Zed doesn't store your prompts or train on them +- **Private by default:** Gwen doesn't store your prompts or train on them without explicit opt-in. [Data sharing for AI improvement](../ai/ai-improvement.md) is opt-in: members can choose to share but are never enrolled automatically. Administrators can @@ -37,6 +37,6 @@ For the organization: ## Getting started -To set up Zed Business for your team, see [Organizations](./organizations.md). +To set up Gwen Business for your team, see [Organizations](./organizations.md). For pricing, see [Plans & Pricing](../account/plans-and-pricing.md). diff --git a/docs/src/business/privacy.md b/docs/src/business/privacy.md index aeaaf3aa08..db28ce3aeb 100644 --- a/docs/src/business/privacy.md +++ b/docs/src/business/privacy.md @@ -1,24 +1,24 @@ --- -title: Privacy for Business - Zed Business -description: How Zed Business handles data privacy across your organization, including enforced protections for prompts and training data. +title: Privacy for Business - Gwen Business +description: How Gwen Business handles data privacy across your organization, including enforced protections for prompts and training data. --- # Privacy for Business -Zed Business removes the per-member data-sharing options that Free and Pro +Gwen Business removes the per-member data-sharing options that Free and Pro expose. These protections are on by default for every Business organization. Administrators can adjust them from [Admin Controls](./admin-controls.md); individual members can't opt in or out. ## What's enforced by default -For all members of a Zed Business organization: +For all members of a Gwen Business organization: -- **No prompt sharing:** Conversations and prompts are never shared with Zed. +- **No prompt sharing:** Conversations and prompts are never shared with Gwen. Members can't opt into [AI feedback via ratings](../ai/ai-improvement.md#ai-feedback-with-ratings). Administrators can enable Agent Thread Feedback to allow this. -- **No training data sharing:** Code context is never shared with Zed for +- **No training data sharing:** Code context is never shared with Gwen for [Edit Prediction model training](../ai/ai-improvement.md#edit-predictions). Members can't opt in individually. Administrators can enable Edit Prediction Feedback to allow this. @@ -29,14 +29,14 @@ These protections are enforced server-side and apply to all org members. On Free and Pro, data sharing is opt-in: -- Members can rate AI responses, which shares that conversation with Zed. +- Members can rate AI responses, which shares that conversation with Gwen. - Members can opt into Edit Prediction training data collection for open source projects. -Neither option is available to Zed Business members. +Neither option is available to Gwen Business members. ## What data still leaves the organization -These controls cover what Zed stores and trains on. They don't change how AI inference works: when members use Zed's hosted models, prompts and code context are still sent to the relevant provider (Anthropic, OpenAI, Google, etc.) to generate responses. Zed maintains no-training commitments with these providers, and zero-data-retention commitments for all models except [provider-designated models with safety retention](../ai/privacy-and-security.md#provider-safety-retention), such as Anthropic's Covered Models. See [AI Privacy](../ai/privacy-and-security.md#data-retention-and-training) for details. +These controls cover what Gwen stores and trains on. They don't change how AI inference works: when members use Gwen's hosted models, prompts and code context are still sent to the relevant provider (Anthropic, OpenAI, Google, etc.) to generate responses. Gwen maintains no-training commitments with these providers, and zero-data-retention commitments for all models except [provider-designated models with safety retention](../ai/privacy-and-security.md#provider-safety-retention), such as Anthropic's Covered Models. See [AI Privacy](../ai/privacy-and-security.md#data-retention-and-training) for details. [Bring-your-own-key](../ai/llm-providers.md), [gateways](../ai/use-a-gateway.md), [local or self-hosted models](../ai/use-a-local-model.md), [External Agents](../ai/external-agents.md), and [Terminal Threads](../ai/terminal-threads.md) are subject to each provider, gateway, server, agent, or CLI's own terms. @@ -44,8 +44,8 @@ These controls cover what Zed stores and trains on. They don't change how AI inf Administrators have additional options in [Admin Controls](./admin-controls.md): -- Disable Zed-hosted models entirely via the Zed Model Provider toggle, so no - prompts reach Zed's infrastructure +- Disable Gwen-hosted models entirely via the Gwen Model Provider toggle, so no + prompts reach Gwen's infrastructure - Disable Edit Predictions org-wide - Disable Edit Prediction Feedback - Disable Agent Thread Feedback diff --git a/docs/src/collaboration/channels.md b/docs/src/collaboration/channels.md index dc8a5eb833..5abacdb685 100644 --- a/docs/src/collaboration/channels.md +++ b/docs/src/collaboration/channels.md @@ -1,6 +1,6 @@ --- title: Channels -description: "Persistent collaboration rooms in Zed for sharing projects, voice chat, and real-time code editing." +description: "Persistent collaboration rooms in Gwen for sharing projects, voice chat, and real-time code editing." --- # Channels {#channels} @@ -40,7 +40,7 @@ Once you have added someone, they can either join your channel by clicking on it You can mute/unmute your microphone via the microphone icon in the upper right-hand side of the window. -> **Note:** When joining a channel, Zed automatically shares your microphone with other users in the call, if your OS allows it. To start muted, use the [`mute_on_join`](../reference/all-settings.md#calls) setting. +> **Note:** When joining a channel, Gwen automatically shares your microphone with other users in the call, if your OS allows it. To start muted, use the [`mute_on_join`](../reference/all-settings.md#calls) setting. ## Sharing Projects @@ -64,7 +64,7 @@ Collaborators that are currently in that project will be disconnected from the p Each channel has a Markdown notes file associated with it to keep track of current status, new ideas, or to collaborate on building out the design for the feature that you're working on before diving into code. -This works like a shared Markdown document backed by Zed's collaboration service. +This works like a shared Markdown document backed by Gwen's collaboration service. Open channel notes by clicking the document icon to the right of the channel name in the Collaboration Panel. @@ -106,7 +106,7 @@ Share your screen with collaborators in the current channel by clicking on the ` If you have multiple displays, you can choose which one to share via the chevron to the right of the monitor icon. After you've shared your screen, others can click the `Screen` entry under your name in the Collaboration Panel to open a tab that keeps it visible. -If they are following you, Zed will automatically switch between following your cursor in their Zed instance and your screen share, depending on whether you are focused on Zed or another application, like a web browser. +If they are following you, Gwen will automatically switch between following your cursor in their Gwen instance and your screen share, depending on whether you are focused on Gwen or another application, like a web browser. > **Warning:** Collaborators can see your entire screen when sharing. Stop screen sharing when finished. diff --git a/docs/src/collaboration/contacts-and-private-calls.md b/docs/src/collaboration/contacts-and-private-calls.md index 0a96ce87b6..25878d180e 100644 --- a/docs/src/collaboration/contacts-and-private-calls.md +++ b/docs/src/collaboration/contacts-and-private-calls.md @@ -1,6 +1,6 @@ --- title: Contacts and Private Calls -description: "Add contacts and start private collaboration sessions in Zed." +description: "Add contacts and start private collaboration sessions in Gwen." --- # Contacts and Private Calls {#contacts} @@ -11,7 +11,7 @@ Private calls provide ad-hoc collaboration sessions outside of channels. Add con 1. In the Collaboration Panel, click the `+` button next to the `Contacts` section 1. Search for the contact using their GitHub handle.\ - _Note: Your contact must be an existing Zed user who has completed the GitHub authentication sign-in flow._ + _Note: Your contact must be an existing Gwen user who has completed the GitHub authentication sign-in flow._ 1. Your contact will receive a notification. Once they accept, you'll both appear in each other's contact list. diff --git a/docs/src/collaboration/overview.md b/docs/src/collaboration/overview.md index 1022ec683b..7ff8b9ec57 100644 --- a/docs/src/collaboration/overview.md +++ b/docs/src/collaboration/overview.md @@ -1,11 +1,11 @@ --- title: Collaboration -description: "Real-time collaboration in Zed: share projects, edit code together, and communicate with voice chat." +description: "Real-time collaboration in Gwen: share projects, edit code together, and communicate with voice chat." --- # Collaboration {#collaboration} -Zed supports real-time multiplayer editing. Multiple people can work in the same project simultaneously, seeing each other's cursors and edits as they happen. +Gwen supports real-time multiplayer editing. Multiple people can work in the same project simultaneously, seeing each other's cursors and edits as they happen. Open the Collaboration Panel with {#kb collab_panel::ToggleFocus}. You'll need to [sign in](../authentication.md#signing-in) to access collaboration features. @@ -30,7 +30,7 @@ You can select specific input and output audio devices instead of using system d 2. Navigate to **Collaboration** > **Experimental** 3. Use the **Output Audio Device** and **Input Audio Device** dropdowns to select your preferred devices -Changes take effect immediately. If you select a device that becomes unavailable, Zed falls back to system defaults. +Changes take effect immediately. If you select a device that becomes unavailable, Gwen falls back to system defaults. To test your audio configuration, click **Test Audio** in the same section. This opens a window where you can verify your microphone and speaker work correctly with the selected devices. diff --git a/docs/src/command-palette.md b/docs/src/command-palette.md index 789e463d9c..79fc8ae75a 100644 --- a/docs/src/command-palette.md +++ b/docs/src/command-palette.md @@ -1,11 +1,11 @@ --- -title: Command Palette - Zed -description: Access any Zed action from the command palette. Fuzzy search commands, key bindings, and editor actions. +title: Command Palette - Gwen +description: Access any Gwen action from the command palette. Fuzzy search commands, key bindings, and editor actions. --- # Command Palette -The Command Palette is the main way to access actions in Zed. Its keybinding is one of the first shortcuts to learn: {#kb command_palette::Toggle}. +The Command Palette is the main way to access actions in Gwen. Its keybinding is one of the first shortcuts to learn: {#kb command_palette::Toggle}. ![The opened Command Palette](https://zed.dev/img/features/command-palette.jpg) diff --git a/docs/src/completions.md b/docs/src/completions.md index 81c2efa351..6ddcd8100b 100644 --- a/docs/src/completions.md +++ b/docs/src/completions.md @@ -1,18 +1,18 @@ --- -title: Code Completions - Zed -description: Zed's code completions from language servers and edit predictions. Configure autocomplete behavior, snippets, and documentation display. +title: Code Completions - Gwen +description: Gwen's code completions from language servers and edit predictions. Configure autocomplete behavior, snippets, and documentation display. --- # Completions -Zed supports two sources for completions: +Gwen supports two sources for completions: -1. "Code Completions" provided by Language Servers (LSPs) automatically installed by Zed or via [Zed Language Extensions](languages.md). -2. "Edit Predictions" provided by Zed's own Zeta model or by external providers like [GitHub Copilot](#github-copilot). +1. "Code Completions" provided by Language Servers (LSPs) automatically installed by Gwen or via [Gwen Language Extensions](languages.md). +2. "Edit Predictions" provided by Gwen's own Zeta model or by external providers like [GitHub Copilot](#github-copilot). ## Language Server Code Completions {#code-completions} -When there is an appropriate language server available, Zed will provide completions of variable names, functions, and other symbols in the current file. You can disable these by adding the following to your Zed `settings.json` file: +When there is an appropriate language server available, Gwen will provide completions of variable names, functions, and other symbols in the current file. You can disable these by adding the following to your Gwen `settings.json` file: ```json [settings] "show_completions_on_input": false @@ -20,18 +20,18 @@ When there is an appropriate language server available, Zed will provide complet You can manually trigger completions with `ctrl-space` or by triggering the `editor::ShowCompletions` action from the command palette. -> Note: Using `ctrl-space` in Zed requires disabling the macOS global shortcut. +> Note: Using `ctrl-space` in Gwen requires disabling the macOS global shortcut. > Open **System Settings** > **Keyboard** > **Keyboard Shortcut**s > > **Input Sources** and uncheck **Select the previous input source**. For more information, see: - [Configuring Supported Languages](./configuring-languages.md) -- [List of Zed Supported Languages](./languages.md) +- [List of Gwen Supported Languages](./languages.md) ## Edit Predictions {#edit-predictions} -Zed has built-in support for predicting multiple edits at a time [via Zeta](https://huggingface.co/zed-industries/zeta), Zed's open-source and open-data model. +Gwen has built-in support for predicting multiple edits at a time [via Zeta](https://huggingface.co/zed-industries/zeta), Gwen's open-source and open-data model. Edit predictions appear as you type, and most of the time, you can accept them by pressing `tab`. -See the [edit predictions documentation](./ai/edit-prediction.md) for more information on how to setup and configure Zed's edit predictions. +See the [edit predictions documentation](./ai/edit-prediction.md) for more information on how to setup and configure Gwen's edit predictions. diff --git a/docs/src/configuring-languages.md b/docs/src/configuring-languages.md index b7958214bf..ed736419d9 100644 --- a/docs/src/configuring-languages.md +++ b/docs/src/configuring-languages.md @@ -1,11 +1,11 @@ --- -title: Language Server and Tree-sitter Config - Zed -description: Configure language support in Zed with Tree-sitter for syntax highlighting and LSP for diagnostics, completion, and formatting. +title: Language Server and Tree-sitter Config - Gwen +description: Configure language support in Gwen with Tree-sitter for syntax highlighting and LSP for diagnostics, completion, and formatting. --- # Configuring Supported Languages -Zed's language support is built on two technologies: +Gwen's language support is built on two technologies: 1. **Tree-sitter** handles syntax highlighting and structure-based features like the outline panel. 2. **Language Server Protocol (LSP)** provides semantic features: code completion, diagnostics, go-to-definition, and refactoring. @@ -16,7 +16,7 @@ For a list of supported languages, see [Supported Languages](./languages.md). To ## Language-specific Settings -Zed allows you to override global settings for individual languages. These custom configurations are defined in your `settings.json` file under the `languages` key. +Gwen allows you to override global settings for individual languages. These custom configurations are defined in your `settings.json` file under the `languages` key. Here's an example of language-specific settings: @@ -56,7 +56,7 @@ These settings allow you to maintain specific coding styles across different lan ## File Associations -Zed automatically detects file types based on their extensions, but you can customize these associations to fit your workflow. +Gwen automatically detects file types based on their extensions, but you can customize these associations to fit your workflow. To set up custom file associations, use the [`file_types`](./reference/all-settings.md#file-types) setting in your `settings.json`: @@ -68,7 +68,7 @@ To set up custom file associations, use the [`file_types`](./reference/all-setti } ``` -This configuration tells Zed to: +This configuration tells Gwen to: - Treat `.c` files as C++ instead of C - Recognize files named "MyLockFile" as TOML @@ -78,11 +78,11 @@ You can use glob patterns for more flexible matching, allowing you to handle com ## Working with Language Servers -Language servers are a crucial part of Zed's intelligent coding features, providing capabilities like auto-completion, go-to-definition, and real-time error checking. +Language servers are a crucial part of Gwen's intelligent coding features, providing capabilities like auto-completion, go-to-definition, and real-time error checking. ### What are Language Servers? -Language servers implement the Language Server Protocol (LSP), which standardizes communication between the editor and language-specific tools. This allows Zed to support advanced features for multiple programming languages without implementing each feature separately. +Language servers implement the Language Server Protocol (LSP), which standardizes communication between the editor and language-specific tools. This allows Gwen to support advanced features for multiple programming languages without implementing each feature separately. Some key features provided by language servers include: @@ -95,20 +95,20 @@ Some key features provided by language servers include: ### Managing Language Servers -Zed simplifies language server management for users: +Gwen simplifies language server management for users: -1. Automatic Download: When you open a file with a matching file type, Zed automatically downloads the appropriate language server. Zed may prompt you to install an extension for known file types. +1. Automatic Download: When you open a file with a matching file type, Gwen automatically downloads the appropriate language server. Gwen may prompt you to install an extension for known file types. 2. Storage Location: - - macOS: `~/Library/Application Support/Zed/languages` - - Linux: `$XDG_DATA_HOME/zed/languages`, `$FLATPAK_XDG_DATA_HOME/zed/languages`, or `$HOME/.local/share/zed/languages` + - macOS: `~/Library/Application Support/Gwen/languages` + - Linux: `$XDG_DATA_HOME/gwen/languages`, `$FLATPAK_XDG_DATA_HOME/gwen/languages`, or `$HOME/.local/share/gwen/languages` -3. Automatic Updates: Zed keeps your language servers up-to-date, ensuring you always have the latest features and improvements. +3. Automatic Updates: Gwen keeps your language servers up-to-date, ensuring you always have the latest features and improvements. ### Choosing Language Servers -Some languages in Zed offer multiple language server options. You might have multiple extensions installed that bundle language servers targeting the same language, potentially leading to overlapping capabilities. To ensure you get the functionality you prefer, Zed allows you to prioritize which language servers are used and in what order. +Some languages in Gwen offer multiple language server options. You might have multiple extensions installed that bundle language servers targeting the same language, potentially leading to overlapping capabilities. To ensure you get the functionality you prefer, Gwen allows you to prioritize which language servers are used and in what order. You can specify your preference using the `language_servers` setting: @@ -170,12 +170,12 @@ Top-level entries are the default for all languages: a language-specific value a ### Toolchains Some language servers need to be configured with a current "toolchain", which is an installation of a specific version of a programming language compiler or/and interpreter, which can possibly include a full set of dependencies of a project. -An example of what Zed considers a toolchain is a virtual environment in Python. -Not all languages in Zed support toolchain discovery and selection, but for those that do, you can specify the toolchain from a toolchain picker (via {#action toolchain::Select}). To learn more about toolchains in Zed, see [`toolchains`](./toolchains.md). +An example of what Gwen considers a toolchain is a virtual environment in Python. +Not all languages in Gwen support toolchain discovery and selection, but for those that do, you can specify the toolchain from a toolchain picker (via {#action toolchain::Select}). To learn more about toolchains in Gwen, see [`toolchains`](./toolchains.md). ### Configuring Language Servers -When configuring language servers in your `settings.json`, autocomplete suggestions include all available LSP adapters recognized by Zed, not only those currently active for loaded languages. This helps you discover and configure language servers before opening files that use them. +When configuring language servers in your `settings.json`, autocomplete suggestions include all available LSP adapters recognized by Gwen, not only those currently active for loaded languages. This helps you discover and configure language servers before opening files that use them. Many language servers accept custom configuration options. You can set these in the `lsp` section of your `settings.json`: @@ -195,14 +195,14 @@ This example configures the Rust Analyzer to use Clippy for additional linting w #### Nested objects -When configuring language server options in Zed, it's important to use nested objects rather than dot-delimited strings. This is particularly relevant when working with more complex configurations. Let's look at a real-world example using the TypeScript language server: +When configuring language server options in Gwen, it's important to use nested objects rather than dot-delimited strings. This is particularly relevant when working with more complex configurations. Let's look at a real-world example using the TypeScript language server: Suppose you want to configure the following settings for TypeScript: - Enable strict null checks - Set the target ECMAScript version to ES2020 -Here's how you would structure these settings in Zed's `settings.json`: +Here's how you would structure these settings in Gwen's `settings.json`: ```json [settings] "lsp": { @@ -259,7 +259,7 @@ Most of the servers would rely on this way of configuring only. } ``` -Apart from the LSP-related server configuration options, certain servers in Zed allow configuring the way binary is launched by Zed. +Apart from the LSP-related server configuration options, certain servers in Gwen allow configuring the way binary is launched by Gwen. Language servers are automatically downloaded or launched if found in your path, if you wish to specify an explicit alternate binary you can specify that in settings: @@ -291,15 +291,15 @@ You can toggle language server support globally or per-language: } ``` -This disables the language server for Markdown files, which can be useful for performance in large documentation projects. You can configure this globally in your `~/.config/zed/settings.json` or inside a `.zed/settings.json` in your project directory. +This disables the language server for Markdown files, which can be useful for performance in large documentation projects. You can configure this globally in your `~/.config/gwen/settings.json` or inside a `.zed/settings.json` in your project directory. ## Formatting and Linting -Zed provides support for code formatting and linting to maintain consistent code style and catch potential issues early. +Gwen provides support for code formatting and linting to maintain consistent code style and catch potential issues early. ### Configuring Formatters -Zed supports both built-in and external formatters. See [`formatter`](./reference/all-settings.md#formatter) docs for more. You can configure formatters globally or per-language in your `settings.json`: +Gwen supports both built-in and external formatters. See [`formatter`](./reference/all-settings.md#formatter) docs for more. You can configure formatters globally or per-language in your `settings.json`: ```json [settings] "languages": { @@ -333,7 +333,7 @@ To disable formatting for a specific language: ### Setting Up Linters -Linting in Zed is typically handled by language servers. Many language servers allow you to configure linting rules: +Linting in Gwen is typically handled by language servers. Many language servers allow you to configure linting rules: ```json [settings] "lsp": { @@ -363,7 +363,7 @@ To run linter fixes automatically on save: ### Formatting Selections -Zed supports formatting only the selected text via {#action editor::FormatSelections} ({#kb editor::FormatSelections}). How +Gwen supports formatting only the selected text via {#action editor::FormatSelections} ({#kb editor::FormatSelections}). How this works depends on the configured formatter: - The action is only shown when the active formatter can actually format ranges for at least one @@ -380,7 +380,7 @@ this works depends on the configured formatter: ### Integrating Formatting and Linting -Zed allows you to run both formatting and linting on save. Here's an example that uses Prettier for formatting and ESLint for linting JavaScript files: +Gwen allows you to run both formatting and linting on save. Here's an example that uses Prettier for formatting and ESLint for linting JavaScript files: ```json [settings] "languages": { @@ -405,17 +405,17 @@ Zed allows you to run both formatting and linting on save. Here's an example tha If you encounter issues with formatting or linting: -1. Check Zed's log file for error messages (Use the command palette: {#action zed::OpenLog}) +1. Check Gwen's log file for error messages (Use the command palette: {#action zed::OpenLog}) 2. Ensure external tools (formatters, linters) are correctly installed and in your PATH -3. Verify configurations in both Zed settings and language-specific config files (e.g., `.eslintrc`, `.prettierrc`) +3. Verify configurations in both Gwen settings and language-specific config files (e.g., `.eslintrc`, `.prettierrc`) ## Syntax Highlighting and Themes -Zed offers customization options for syntax highlighting and themes, allowing you to tailor the visual appearance of your code. +Gwen offers customization options for syntax highlighting and themes, allowing you to tailor the visual appearance of your code. ### Customizing Syntax Highlighting -Zed uses Tree-sitter grammars for syntax highlighting. Override the default highlighting using the `theme_overrides` setting. +Gwen uses Tree-sitter grammars for syntax highlighting. Override the default highlighting using the `theme_overrides` setting. This example makes comments italic and changes the color of strings: @@ -449,11 +449,11 @@ Change your theme: } ``` -Create custom themes by creating a JSON file in `~/.config/zed/themes/`. Zed will automatically detect and make available any themes in this directory. +Create custom themes by creating a JSON file in `~/.config/gwen/themes/`. Gwen will automatically detect and make available any themes in this directory. ### Using Theme Extensions -Zed supports theme extensions. Browse and install theme extensions from the Extensions panel ({#kb zed::Extensions}). +Gwen supports theme extensions. Browse and install theme extensions from the Extensions panel ({#kb zed::Extensions}). To create your own theme extension, refer to the [Developing Theme Extensions](./extensions/themes.md) guide. @@ -512,7 +512,7 @@ To rename a symbol across your project: These features depend on the capabilities of the language server for each language. -When renaming a symbol that spans multiple files, Zed will open a preview in a multibuffer. This allows you to review all the changes across your project before applying them. To confirm the rename, simply save the multibuffer. If you decide not to proceed with the rename, you can undo the changes or close the multibuffer without saving. +When renaming a symbol that spans multiple files, Gwen will open a preview in a multibuffer. This allows you to review all the changes across your project before applying them. To confirm the rename, simply save the multibuffer. If you decide not to proceed with the rename, you can undo the changes or close the multibuffer without saving. ### Hover Information @@ -524,7 +524,7 @@ The {#action project_symbols::Toggle} command allows you to search for symbols ( ### Code Completion -Zed provides intelligent code completion suggestions as you type. You can manually trigger completion with the {#action editor::ShowCompletions} command. Use tab|tab or enter|enter to accept suggestions. +Gwen provides intelligent code completion suggestions as you type. You can manually trigger completion with the {#action editor::ShowCompletions} command. Use tab|tab or enter|enter to accept suggestions. ### Diagnostics diff --git a/docs/src/configuring-zed.md b/docs/src/configuring-zed.md index 1ac30b9f33..7267d7bad7 100644 --- a/docs/src/configuring-zed.md +++ b/docs/src/configuring-zed.md @@ -1,17 +1,17 @@ --- -title: Configuring Zed - Settings and Preferences -description: Configure Zed with the Settings Editor, JSON files, and project-specific overrides. Covers all settings options. +title: Configuring Gwen - Settings and Preferences +description: Configure Gwen with the Settings Editor, JSON files, and project-specific overrides. Covers all settings options. --- -# Configuring Zed +# Configuring Gwen -This guide explains how Zed's settings system works, including the Settings Editor, JSON configuration files, and project-specific settings. +This guide explains how Gwen's settings system works, including the Settings Editor, JSON configuration files, and project-specific settings. For visual customization (themes, fonts, icons), see [Appearance](./appearance.md). ## Settings Editor -The **Settings Editor** ({#kb zed::OpenSettings}) is the primary way to configure Zed. It provides a searchable interface where you can browse available settings, see their current values, and make changes. +The **Settings Editor** ({#kb zed::OpenSettings}) is the primary way to configure Gwen. It provides a searchable interface where you can browse available settings, see their current values, and make changes. To open it: @@ -30,9 +30,9 @@ Your user settings apply globally across all projects. Open the file with {#kb z The file is located at: -- macOS: `~/.config/zed/settings.json` -- Linux: `~/.config/zed/settings.json` (or `$XDG_CONFIG_HOME/zed/settings.json`) -- Windows: `%APPDATA%\Zed\settings.json` +- macOS: `~/.config/gwen/settings.json` +- Linux: `~/.config/gwen/settings.json` (or `$XDG_CONFIG_HOME/gwen/settings.json`) +- Windows: `%APPDATA%\Gwen\settings.json` The syntax is JSON with support for `//` comments. @@ -63,7 +63,7 @@ You can also add settings files in subdirectories for more granular control. Settings are applied in layers: -1. **Default settings** — Zed's built-in defaults +1. **Default settings** — Gwen's built-in defaults 2. **User settings** — Your global preferences 3. **Project settings** — Project-specific overrides @@ -71,7 +71,7 @@ Later layers override earlier ones. For object settings (like `terminal`), prope ## Per-file Settings -Zed has some compatibility support for Emacs and Vim [modelines](./modelines.md), so you can set some settings per-file. +Gwen has some compatibility support for Emacs and Vim [modelines](./modelines.md), so you can set some settings per-file. ## Per-Release Channel Overrides @@ -101,7 +101,7 @@ Changes made in the Settings Editor apply across all channels. ## Settings Deep Links -Zed supports deep links that open specific settings directly: +Gwen supports deep links that open specific settings directly: ``` zed://settings/theme diff --git a/docs/src/debugger.md b/docs/src/debugger.md index 4c7c21e5e3..129be8363f 100644 --- a/docs/src/debugger.md +++ b/docs/src/debugger.md @@ -1,21 +1,21 @@ --- -title: Debugger - Zed -description: Debug code in Zed with the Debug Adapter Protocol (DAP). Breakpoints, stepping, variable inspection across multiple languages. +title: Debugger - Gwen +description: Debug code in Gwen with the Debug Adapter Protocol (DAP). Breakpoints, stepping, variable inspection across multiple languages. --- # Debugger -Zed uses the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/) to provide debugging functionality across multiple programming languages. +Gwen uses the [Debug Adapter Protocol (DAP)](https://microsoft.github.io/debug-adapter-protocol/) to provide debugging functionality across multiple programming languages. DAP is a standardized protocol that defines how debuggers, editors, and IDEs communicate with each other. -It allows Zed to support various debuggers without needing to implement language-specific debugging logic. -Zed implements the client side of the protocol, and various _debug adapters_ implement the server side. +It allows Gwen to support various debuggers without needing to implement language-specific debugging logic. +Gwen implements the client side of the protocol, and various _debug adapters_ implement the server side. This protocol enables features like setting breakpoints, stepping through code, inspecting variables, and more, in a consistent manner across different programming languages and runtime environments. ## Supported Languages -To debug code written in a specific language, Zed needs to find a debug adapter for that language. Some debug adapters are provided by Zed without additional setup, and some are provided by [language extensions](./extensions/debugger-extensions.md). The following languages currently have debug adapters available: +To debug code written in a specific language, Gwen needs to find a debug adapter for that language. Some debug adapters are provided by Gwen without additional setup, and some are provided by [language extensions](./extensions/debugger-extensions.md). The following languages currently have debug adapters available: @@ -33,7 +33,7 @@ To debug code written in a specific language, Zed needs to find a debug adapter > If your language isn't listed, you can contribute by adding a debug adapter for it. Check out our [debugger extensions](./extensions/debugger-extensions.md) documentation for more information. -Follow those links for language- and adapter-specific information and examples, or read on for more about Zed's general debugging features that apply to all adapters. +Follow those links for language- and adapter-specific information and examples, or read on for more about Gwen's general debugging features that apply to all adapters. ## Getting Started @@ -60,31 +60,31 @@ For languages that don't provide preconfigured debug tasks (this includes C, C++ Check the documentation for your language for example configurations covering typical use-cases. Once you've added configurations to `.zed/debug.json`, they'll appear in the list in the new process modal. -Zed will also load debug configurations from `.vscode/launch.json`, and show them in the new process modal if no configurations are found in `.zed/debug.json`. +Gwen will also load debug configurations from `.vscode/launch.json`, and show them in the new process modal if no configurations are found in `.zed/debug.json`. #### Global debug configurations -If you run the same launch profiles across multiple projects, you can store them once in your user configuration. Invoke {#action zed::OpenDebugTasks} from the command palette to open the global `debug.json` file; Zed creates it next to your user `settings.json` and keeps it in sync with the debugger UI. The file lives at: +If you run the same launch profiles across multiple projects, you can store them once in your user configuration. Invoke {#action zed::OpenDebugTasks} from the command palette to open the global `debug.json` file; Gwen creates it next to your user `settings.json` and keeps it in sync with the debugger UI. The file lives at: -- **macOS:** `~/Library/Application Support/Zed/debug.json` -- **Linux/BSD:** `$XDG_CONFIG_HOME/zed/debug.json` (falls back to `~/.config/zed/debug.json`) -- **Windows:** `%APPDATA%\Zed\debug.json` +- **macOS:** `~/Library/Application Support/Gwen/debug.json` +- **Linux/BSD:** `$XDG_CONFIG_HOME/gwen/debug.json` (falls back to `~/.config/gwen/debug.json`) +- **Windows:** `%APPDATA%\Gwen\debug.json` Populate this file with the same array of objects you would place in `.zed/debug.json`. Any scenarios defined there are merged into every workspace, so your favorite launch presets appear automatically in the "New Debug Session" dialog. ### Launching & Attaching -The Zed debugger offers two ways to debug your program; you can either _launch_ a new instance of your program or _attach_ to an existing process. +The Gwen debugger offers two ways to debug your program; you can either _launch_ a new instance of your program or _attach_ to an existing process. Which one you choose depends on what you are trying to achieve. -When launching a new instance, Zed (and the underlying debug adapter) can often do a better job at picking up the debug information compared to attaching to an existing process, since it controls the lifetime of a whole program. +When launching a new instance, Gwen (and the underlying debug adapter) can often do a better job at picking up the debug information compared to attaching to an existing process, since it controls the lifetime of a whole program. Running unit tests or a debug build of your application is a good use case for launching. Compared to launching, attaching to an existing process might seem inferior, but that's far from the truth; there are cases where you cannot afford to restart your program, because for example, the bug is not reproducible outside of a production environment or some other circumstances. ## Configuration -Zed requires the `adapter` and `label` fields for all debug tasks. In addition, Zed will use the `build` field to run any necessary setup steps before the debugger starts [(see below)](#build-tasks), and can accept a `tcp_connection` field to connect to an existing process. +Gwen requires the `adapter` and `label` fields for all debug tasks. In addition, Gwen will use the `build` field to run any necessary setup steps before the debugger starts [(see below)](#build-tasks), and can accept a `tcp_connection` field to connect to an existing process. All other fields are provided by the debug adapter and can contain [task variables](./tasks.md#variables). Most adapters support `request`, `program`, and `cwd`: @@ -93,11 +93,11 @@ All other fields are provided by the debug adapter and can contain [task variabl { // The label for the debug configuration and used to identify the debug session inside the debug panel & new process modal "label": "Example Start debugger config", - // The debug adapter that Zed should use to debug the program + // The debug adapter that Gwen should use to debug the program "adapter": "Example adapter name", // Request: - // - launch: Zed will launch the program if specified, or show a debug terminal with the right configuration - // - attach: Zed will attach to a running program to debug it, or when the process_id is not specified, will show a process picker (only supported for node currently) + // - launch: Gwen will launch the program if specified, or show a debug terminal with the right configuration + // - attach: Gwen will attach to a running program to debug it, or when the process_id is not specified, will show a process picker (only supported for node currently) "request": "launch", // The program to debug. This field supports path resolution with ~ or . symbols. "program": "path_to_program", @@ -111,7 +111,7 @@ Check your debug adapter's documentation for more information on the fields it s ### Build tasks -Zed allows embedding a Zed task in the `build` field that is run before the debugger starts. This is useful for setting up the environment or running any necessary setup steps before the debugger starts. +Gwen allows embedding a Gwen task in the `build` field that is run before the debugger starts. This is useful for setting up the environment or running any necessary setup steps before the debugger starts. ```json [debug] [ @@ -144,7 +144,7 @@ Build tasks can also refer to the existing tasks by unsubstituted label: ### Automatic scenario creation -Given a Zed task, Zed can automatically create a scenario for you. Automatic scenario creation also powers our scenario creation from gutter. +Given a Gwen task, Gwen can automatically create a scenario for you. Automatic scenario creation also powers our scenario creation from gutter. Automatic scenario creation is currently supported for Rust, Go, Python, JavaScript, and TypeScript. ## Breakpoints @@ -165,7 +165,7 @@ The debug adapter will then stop whenever an exception of a given kind occurs. W ## Working with Split Panes -When debugging with multiple split panes open, Zed shows the active debug line in one pane and preserves your layout in others. If you have the same file open in multiple panes, the debugger picks a pane where the file is already the active tab—it won't switch tabs in panes where the file is inactive. +When debugging with multiple split panes open, Gwen shows the active debug line in one pane and preserves your layout in others. If you have the same file open in multiple panes, the debugger picks a pane where the file is already the active tab—it won't switch tabs in panes where the file is inactive. Once the debugger picks a pane, it continues using that pane for subsequent breakpoints during the session. If you drag the tab with the active debug line to a different split, the debugger tracks the move and uses the new pane. @@ -177,10 +177,10 @@ The settings for the debugger are grouped under the `debugger` key in `settings. - `dock`: Determines the position of the debug panel in the UI. - `stepping_granularity`: Determines the stepping granularity. -- `save_breakpoints`: Whether the breakpoints should be reused across Zed sessions. +- `save_breakpoints`: Whether the breakpoints should be reused across Gwen sessions. - `button`: Whether to show the debug button in the status bar. - `timeout`: Time in milliseconds until timeout error when connecting to a TCP debug adapter. -- `log_dap_communications`: Whether to log messages between active debug adapters and Zed. +- `log_dap_communications`: Whether to log messages between active debug adapters and Gwen. - `format_dap_log_messages`: Whether to format DAP messages when adding them to the debug adapter logger. ### Dock @@ -243,7 +243,7 @@ The settings for the debugger are grouped under the `debugger` key in `settings. ### Save Breakpoints -- Description: Whether the breakpoints should be saved across Zed sessions. +- Description: Whether the breakpoints should be saved across Gwen sessions. - Default: `true` - Setting: `debugger.save_breakpoints` @@ -315,7 +315,7 @@ Inline value hints can also be toggled from the Editor Controls menu in the edit ### Log Dap Communications -- Description: Whether to log messages between active debug adapters and Zed. (Used for DAP development) +- Description: Whether to log messages between active debug adapters and Gwen. (Used for DAP development) - Default: false - Setting: debugger.log_dap_communications @@ -351,11 +351,11 @@ Inline value hints can also be toggled from the Editor Controls menu in the edit ### Customizing Debug Adapters -- Description: Custom program path and arguments to override how Zed launches a specific debug adapter. +- Description: Custom program path and arguments to override how Gwen launches a specific debug adapter. - Default: Adapter-specific - Setting: `dap.$ADAPTER.binary` and `dap.$ADAPTER.args` -You can pass `binary`, `args`, or both. `binary` should be a path to a _debug adapter_ (like `lldb-dap`) not a _debugger_ (like `lldb` itself). The `args` setting overrides any arguments that Zed would otherwise pass to the adapter. +You can pass `binary`, `args`, or both. `binary` should be a path to a _debug adapter_ (like `lldb-dap`) not a _debugger_ (like `lldb` itself). The `args` setting overrides any arguments that Gwen would otherwise pass to the adapter. ```json [settings] { @@ -379,5 +379,5 @@ The Debugger supports the following theme options: If you're running into problems with the debugger, please [open a GitHub issue](https://github.com/zed-industries/zed/issues/new?template=04_bug_debugger.yml), providing as much context as possible. There are also some features you can use to gather more information about the problem: -- When you have a session running in the debug panel, you can run the {#action dev::CopyDebugAdapterArguments} action to copy a JSON blob to the clipboard that describes how Zed initialized the session. This is especially useful when the session failed to start, and is great context to add if you open a GitHub issue. -- You can also use the {#action dev::OpenDebugAdapterLogs} action to see a trace of all of Zed's communications with debug adapters during the most recent debug sessions. +- When you have a session running in the debug panel, you can run the {#action dev::CopyDebugAdapterArguments} action to copy a JSON blob to the clipboard that describes how Gwen initialized the session. This is especially useful when the session failed to start, and is great context to add if you open a GitHub issue. +- You can also use the {#action dev::OpenDebugAdapterLogs} action to see a trace of all of Gwen's communications with debug adapters during the most recent debug sessions. diff --git a/docs/src/dev-containers.md b/docs/src/dev-containers.md index e3765ab522..386f661629 100644 --- a/docs/src/dev-containers.md +++ b/docs/src/dev-containers.md @@ -1,26 +1,26 @@ --- -title: Dev Containers - Zed -description: Open projects in dev containers with Zed. Reproducible development environments using devcontainer.json configuration. +title: Dev Containers - Gwen +description: Open projects in dev containers with Gwen. Reproducible development environments using devcontainer.json configuration. --- # Dev Containers Dev Containers provide a consistent, reproducible development environment by defining your project's dependencies, tools, and settings in a container configuration. -If your repository includes a `.devcontainer/devcontainer.json` file, Zed can open a project inside a development container. +If your repository includes a `.devcontainer/devcontainer.json` file, Gwen can open a project inside a development container. ## Requirements -- Docker or Podman must be installed and available in your `PATH`. If you use `podman`, you must set the `use_podman` setting in your Zed settings.json to true. +- Docker or Podman must be installed and available in your `PATH`. If you use `podman`, you must set the `use_podman` setting in your Gwen settings.json to true. - Your project must contain a `.devcontainer/devcontainer.json` directory/file. -By default Zed builds dev container images with BuildKit when the `docker buildx` plugin is available. If your Docker-compatible engine lacks an integrated BuildKit (for example, Apple Container accessed through a Docker-API bridge), set `"dev_container_use_buildkit": false` in your settings.json to use the classic Docker builder instead. +By default Gwen builds dev container images with BuildKit when the `docker buildx` plugin is available. If your Docker-compatible engine lacks an integrated BuildKit (for example, Apple Container accessed through a Docker-API bridge), set `"dev_container_use_buildkit": false` in your settings.json to use the classic Docker builder instead. -## Using Dev Containers in Zed +## Using Dev Containers in Gwen ### Automatic prompt -When you open a project that contains the `.devcontainer/devcontainer.json` directory/file, Zed will display a prompt asking whether to open the project inside the dev container. Choosing "Open in Container" will: +When you open a project that contains the `.devcontainer/devcontainer.json` directory/file, Gwen will display a prompt asking whether to open the project inside the dev container. Choosing "Open in Container" will: 1. Build the dev container image (if needed). 2. Launch the container. @@ -28,19 +28,19 @@ When you open a project that contains the `.devcontainer/devcontainer.json` dire ### Manual open -If you dismiss the prompt or want to reopen the project inside a container later, you can use Zed's command palette to run the "Project: Open Remote" command and select the option to open the project in a dev container. +If you dismiss the prompt or want to reopen the project inside a container later, you can use Gwen's command palette to run the "Project: Open Remote" command and select the option to open the project in a dev container. Alternatively, you can reach for the Remote Projects modal (through the {#kb projects::OpenRemote} binding) and choose the "Connect Dev Container" option. ## Editing the dev container configuration -If you modify `.devcontainer/devcontainer.json`, Zed does not currently rebuild or reload the container automatically. After changing configuration: +If you modify `.devcontainer/devcontainer.json`, Gwen does not currently rebuild or reload the container automatically. After changing configuration: - Stop or kill the existing container manually (e.g., via `docker kill `). - Reopen the project in the container. ## Working in a Dev Container -Once connected, Zed operates inside the container environment for tasks, terminals, and language servers. +Once connected, Gwen operates inside the container environment for tasks, terminals, and language servers. Files are linked from your workspace into the container according to the dev container specification. ## Extensions @@ -64,7 +64,7 @@ You can specify extensions in `.devcontainer/devcontainer.json` under the "custo } ``` -Note that extensions load for the Zed session, so these extensions will exist on your local Zed instances as well. +Note that extensions load for the Gwen session, so these extensions will exist on your local Gwen instances as well. ## Known Limitations diff --git a/docs/src/development.md b/docs/src/development.md index 73e77f2a9f..e7e4f06739 100644 --- a/docs/src/development.md +++ b/docs/src/development.md @@ -1,11 +1,11 @@ --- -title: Developing Zed -description: "Guide to building and developing Zed from source." +title: Developing Gwen +description: "Guide to building and developing Gwen from source." --- -# Developing Zed +# Developing Gwen -See the platform-specific instructions for building Zed from source: +See the platform-specific instructions for building Gwen from source: - [macOS](./development/macos.md) - [Linux](./development/linux.md) @@ -13,9 +13,9 @@ See the platform-specific instructions for building Zed from source: ## Keychain access -Zed stores secrets in the system keychain. +Gwen stores secrets in the system keychain. -However, when running a development build of Zed on macOS (and perhaps other +However, when running a development build of Gwen on macOS (and perhaps other platforms) trying to access the keychain results in a lot of keychain prompts that require entering your password over and over. @@ -25,14 +25,14 @@ your password again the next time something changes in the binary. This quickly becomes annoying and impedes development speed. -That is why, by default, when running a development build of Zed an alternative +That is why, by default, when running a development build of Gwen an alternative credential provider is used to bypass the system keychain. > **Note:** This is **only** the case for development builds. For all non-development > release channels the system keychain is always used. If you need to test something out using the real system keychain in a -development build, run Zed with the following environment variable set: +development build, run Gwen with the following environment variable set: ``` ZED_DEVELOPMENT_USE_KEYCHAIN=1 @@ -40,7 +40,7 @@ ZED_DEVELOPMENT_USE_KEYCHAIN=1 ## Performance Measurements -Zed includes a frame time measurement system that can be used to profile how long it takes to render each frame. This is particularly useful when comparing rendering performance between different versions or when optimizing frame rendering code. +Gwen includes a frame time measurement system that can be used to profile how long it takes to render each frame. This is particularly useful when comparing rendering performance between different versions or when optimizing frame rendering code. ### Using ZED_MEASUREMENTS @@ -50,7 +50,7 @@ To enable performance measurements, set the `ZED_MEASUREMENTS` environment varia export ZED_MEASUREMENTS=1 ``` -When enabled, Zed will print frame rendering timing information to stderr, showing how long each frame takes to render. +When enabled, Gwen will print frame rendering timing information to stderr, showing how long each frame takes to render. ### Performance Comparison Workflow @@ -65,12 +65,12 @@ Here's a typical workflow for comparing frame rendering performance between diff 2. **Test the first version:** - Checkout the commit you want to measure - - Run Zed in release mode and use it for 5-10 seconds: `cargo run --release &> version-a` + - Run Gwen in release mode and use it for 5-10 seconds: `cargo run --release &> version-a` 3. **Test the second version:** - Checkout another commit you want to compare - - Run Zed in release mode and use it for 5-10 seconds: `cargo run --release &> version-b` + - Run Gwen in release mode and use it for 5-10 seconds: `cargo run --release &> version-b` 4. **Generate comparison:** @@ -88,7 +88,7 @@ in-depth examples and explanations. ## ETW Profiling on Windows -Zed supports performance profiling with Event Tracing for Windows (ETW) to capture detailed performance data, including CPU, GPU, memory, disk, and file I/O activity. Data is saved to an `.etl` file, which can be opened in standard profiling tools for analysis. +Gwen supports performance profiling with Event Tracing for Windows (ETW) to capture detailed performance data, including CPU, GPU, memory, disk, and file I/O activity. Data is saved to an `.etl` file, which can be opened in standard profiling tools for analysis. ETW recordings may contain personally identifiable or security-sensitive information, such as paths to files and registry keys accessed, as well as process names. Please keep this in mind when sharing traces with others. @@ -97,9 +97,9 @@ ETW recordings may contain personally identifiable or security-sensitive informa Open the command palette and run one of the following: - `zed: record etw trace`: records CPU, GPU, memory, and I/O activity -- `zed: record etw trace with heap tracing`: includes heap allocation data for the Zed process +- `zed: record etw trace with heap tracing`: includes heap allocation data for the Gwen process -Zed will request administrator permission. Once granted, recording will begin. +Gwen will request administrator permission. Once granted, recording will begin. ### Saving or canceling @@ -113,4 +113,4 @@ While a trace is recording, open the command palette and run one of the followin - [CONTRIBUTING.md](https://github.com/zed-industries/zed/blob/main/CONTRIBUTING.md) - [Debugging Crashes](./development/debugging-crashes.md) - [Code of Conduct](https://zed.dev/code-of-conduct) -- [Zed Contributor License](https://zed.dev/cla) +- [Gwen Contributor License](https://zed.dev/cla) diff --git a/docs/src/development/debuggers.md b/docs/src/development/debuggers.md index 3f1705fa42..b6f7fd06b0 100644 --- a/docs/src/development/debuggers.md +++ b/docs/src/development/debuggers.md @@ -1,16 +1,16 @@ --- title: Using a debugger -description: "Guide to using a debugger for Zed development." +description: "Guide to using a debugger for Gwen development." --- # Using a debugger -> This page is not about [configuring Zed's debugger](../debugger.md). -> It covers how to use a debugger while developing Zed itself. +> This page is not about [configuring Gwen's debugger](../debugger.md). +> It covers how to use a debugger while developing Gwen itself. -## Using Zed's built-in debugger +## Using Gwen's built-in debugger -While the Zed project is open you can open the `New Process Modal` and select the `Debug` tab. There you can see two debug configurations to debug Zed with, one for GDB and one for LLDB. Select the configuration you want and Zed will build and launch the binary. +While the Gwen project is open you can open the `New Process Modal` and select the `Debug` tab. There you can see two debug configurations to debug Gwen with, one for GDB and one for LLDB. Select the configuration you want and Gwen will build and launch the binary. GDB is not supported on Apple Silicon Macs. @@ -27,7 +27,7 @@ In release builds, this reduces binary size. Type-level and variable-level debug However, this data matters when you are actively debugging. Without it, debuggers cannot resolve local variables, inspect values, or format output with pretty-printers. -To get the full debugger experience on a release build, compile a Zed binary with full debug info. +To get the full debugger experience on a release build, compile a Gwen binary with full debug info. The simplest way is to use `--config` to override the `debug` field in the root `Cargo.toml` when running `cargo run` or `cargo build`: @@ -56,11 +56,11 @@ cargo build --config 'profile.release.debug="full"' > > **Warning:** Do not commit these changes. -## Running Zed with a shell debugger GDB/LLDB +## Running Gwen with a shell debugger GDB/LLDB ### Background -When you install Rust through rustup (the recommended setup for Zed development; see your platform guide [here](../development.md)), rustup also installs helper scripts for debugging Rust binaries. +When you install Rust through rustup (the recommended setup for Gwen development; see your platform guide [here](../development.md)), rustup also installs helper scripts for debugging Rust binaries. These scripts are `rust-gdb` and `rust-lldb`. @@ -76,31 +76,31 @@ The [linked article](https://michaelwoerister.github.io/2015/03/27/rust-xxdb.htm If you are new to these tools, see the `gdb` docs [here](https://www.gnu.org/software/gdb/) and the `lldb` docs [here](https://lldb.llvm.org/). -### Usage with Zed +### Usage with Gwen -After enabling full debug info and building with `cargo build`, run `rust-gdb` or `rust-lldb` against the compiled Zed binary: +After enabling full debug info and building with `cargo build`, run `rust-gdb` or `rust-lldb` against the compiled Gwen binary: ``` rust-gdb target/debug/zed rust-lldb target/debug/zed ``` -You can also attach to a running Zed process (for example, one started with `cargo run`): +You can also attach to a running Gwen process (for example, one started with `cargo run`): ``` rust-gdb -p rust-lldb -p ``` -`` is the process ID of the Zed instance you want to attach to. +`` is the process ID of the Gwen instance you want to attach to. To find the PID, use your system's process tools, such as Task Manager on Windows or Activity Monitor on macOS. -You can also run `ps aux | grep zed` on macOS and Linux, or `Get-Process | Select-Object Id, ProcessName` in PowerShell on Windows. +You can also run `ps aux | grep gwen` on macOS and Linux, or `Get-Process | Select-Object Id, ProcessName` in PowerShell on Windows. #### Debugging Panics and Crashes -Debuggers are useful for finding the cause of panics and crashes, including in Zed. +Debuggers are useful for finding the cause of panics and crashes, including in Gwen. By default, when a process attached to `gdb` or `lldb` hits an exception such as a panic, the debugger stops at that point so you can inspect program state. @@ -110,4 +110,4 @@ In `lldb`, use `backtrace` with `frame select`. `gdb` provides equivalent comman After the program stops on the exception, you usually cannot continue normal execution. You can still move between stack frames and inspect variables and expressions, which is often enough to identify the crash cause. -You can find additional information on debugging Zed crashes [here](./debugging-crashes.md). +You can find additional information on debugging Gwen crashes [here](./debugging-crashes.md). diff --git a/docs/src/development/debugging-crashes.md b/docs/src/development/debugging-crashes.md index 0d0743b5d2..29be89e75e 100644 --- a/docs/src/development/debugging-crashes.md +++ b/docs/src/development/debugging-crashes.md @@ -1,18 +1,18 @@ --- title: Debugging Crashes -description: "Guide to debugging crashes for Zed development." +description: "Guide to debugging crashes for Gwen development." --- # Debugging Crashes -When Zed panics or crashes, it sends a message to a sidecar process that inspects the editor's memory and creates a [minidump](https://chromium.googlesource.com/breakpad/breakpad/+/master/docs/getting_started_with_breakpad.md#the-minidump-file-format) in `~/Library/Logs/Zed` or `$XDG_DATA_HOME/zed/logs`. You can use this minidump to generate backtraces for all thread stacks. +When Gwen panics or crashes, it sends a message to a sidecar process that inspects the editor's memory and creates a [minidump](https://chromium.googlesource.com/breakpad/breakpad/+/master/docs/getting_started_with_breakpad.md#the-minidump-file-format) in `~/Library/Logs/Gwen` or `$XDG_DATA_HOME/gwen/logs`. You can use this minidump to generate backtraces for all thread stacks. -If telemetry is enabled, Zed uploads these reports when you restart the app. Reports are sent to a [Slack channel](https://zed-industries.slack.com/archives/C0977J9MA1Y) and to [Sentry](https://zed-dev.sentry.io/issues) (both are Zed-staff-only). +If telemetry is enabled, Gwen uploads these reports when you restart the app. Reports are sent to a [Slack channel](https://zed-industries.slack.com/archives/C0977J9MA1Y) and to [Sentry](https://zed-dev.sentry.io/issues) (both are Gwen-staff-only). -These crash reports include useful data, but they are hard to read without spans or symbol information. You can still analyze them locally by downloading source and an unstripped binary (or separate symbols file) for your Zed release, then running: +These crash reports include useful data, but they are hard to read without spans or symbol information. You can still analyze them locally by downloading source and an unstripped binary (or separate symbols file) for your Gwen release, then running: ```sh -zstd -d ~/.local/share/zed/.dmp -o minidump.dmp +zstd -d ~/.local/share/gwen/.dmp -o minidump.dmp minidump-stackwalk minidump.dmp ``` diff --git a/docs/src/development/feature-process.md b/docs/src/development/feature-process.md index ec39c6c4b5..4eb8821b6d 100644 --- a/docs/src/development/feature-process.md +++ b/docs/src/development/feature-process.md @@ -1,6 +1,6 @@ -# Zed's Feature Development Process +# Gwen's Feature Development Process -This is for moderate-to-large features — new UI, behavior changes, or work that cuts across multiple parts of Zed. Small keybindings or settings tweaks don't need all of this. +This is for moderate-to-large features — new UI, behavior changes, or work that cuts across multiple parts of Gwen. Small keybindings or settings tweaks don't need all of this. > **Before you start:** If you're an external contributor, make sure the feature is something the team wants before investing significant effort. Please read the [Contributing Guide](../../../CONTRIBUTING.md) and our [Feature Request Guidelines](https://github.com/zed-industries/zed/discussions/51422) — if there isn't already a GitHub issue with clear staff confirmation, start with a GitHub Discussion. Feature request PRs that skip this process have a _very_ low merge rate. Taking the time to follow our process significantly increases the chances your idea gets picked up and built. @@ -10,7 +10,7 @@ Every feature starts as an idea. Before writing any code, ground it: - **What problem does this solve?** - **What's the evidence?** GitHub issues, Discord requests, thumbs-up counts, blog posts. -- **Is there prior art?** If it's in VS Code, JetBrains, Neovim, or a wildly popular plugin, that's a strong signal. If the idea is more novel, name what it's based on — "This is X, adapted for Zed's multi-buffers" is far more useful than "I think this would be cool." +- **Is there prior art?** If it's in VS Code, JetBrains, Neovim, or a wildly popular plugin, that's a strong signal. If the idea is more novel, name what it's based on — "This is X, adapted for Gwen's multi-buffers" is far more useful than "I think this would be cool." ## 2. What is it? @@ -31,7 +31,7 @@ This is standard across all major code editors: - and has 146 thumbs up on this [github issue](https://github.com). **Decisions:** -We have to decide whether to use the git CLI or a git library. Zed uses a git library but its blame implementation is too slow for a code editor, so we should use the CLI's porcelain interface. +We have to decide whether to use the git CLI or a git library. Gwen uses a git library but its blame implementation is too slow for a code editor, so we should use the CLI's porcelain interface. ## 3. What else does this affect? @@ -46,7 +46,7 @@ Walk through this list before you start building. Not everything will apply: - **Accessibility.** Is it keyboard-navigable? Are focus states clear? - **Platform differences.** Does behavior differ on macOS, Linux, or Windows? - **Performance.** How does it behave with large files or big projects? Are interactions instant? -- **Security.** How does this feature interact with Workspace Trust? Does it open new attack surfaces in Zed? +- **Security.** How does this feature interact with Workspace Trust? Does it open new attack surfaces in Gwen? If your feature touches the **editor** specifically: the editor has a lot of coexisting features — gutter elements, inline blocks, multiple cursors, folding, edit predictions, code intelligence popovers, the minimap. Test your changes with different combinations of them active. Features that work in a normal buffer might need to be disabled in a multi-buffer. diff --git a/docs/src/development/freebsd.md b/docs/src/development/freebsd.md index 6d36bb8404..5051fe1d9a 100644 --- a/docs/src/development/freebsd.md +++ b/docs/src/development/freebsd.md @@ -1,9 +1,9 @@ --- -title: Building Zed for FreeBSD -description: "Guide to building zed for freebsd for Zed development." +title: Building Gwen for FreeBSD +description: "Guide to building Gwen for FreeBSD." --- -# Building Zed for FreeBSD +# Building Gwen for FreeBSD FreeBSD is not currently a supported platform, so this guide is a work in progress. @@ -23,7 +23,7 @@ Clone the [Zed repository](https://github.com/zed-industries/zed). ## Building from source -Once the dependencies are installed, you can build Zed using [Cargo](https://doc.rust-lang.org/cargo/). +Once the dependencies are installed, you can build Gwen using [Cargo](https://doc.rust-lang.org/cargo/). For a debug build of the editor: @@ -47,7 +47,7 @@ cargo run -p cli Building `webrtc-sys` on FreeBSD currently fails due to missing upstream support and unavailable prebuilt binaries. As a result, collaboration features that depend on WebRTC (audio calls and screen sharing) are temporarily disabled. -See [Issue #15309: FreeBSD Support] and [Discussion #29550: Unofficial FreeBSD port for Zed] for more. +See [Issue #15309: FreeBSD Support] and [Discussion #29550: Unofficial FreeBSD port for Gwen] for more. ## Troubleshooting diff --git a/docs/src/development/glossary.md b/docs/src/development/glossary.md index 4b57a30d5b..1edfae26ca 100644 --- a/docs/src/development/glossary.md +++ b/docs/src/development/glossary.md @@ -1,11 +1,11 @@ --- -title: "Zed Development: Glossary" -description: "Guide to zed development: glossary for Zed development." +title: "Gwen Development: Glossary" +description: "Glossary of terms for Gwen development." --- -# Zed Development: Glossary +# Gwen Development: Glossary -This page defines terms and structures used throughout the Zed codebase. +This page defines terms and structures used throughout the Gwen codebase. It is a best-effort list and a work in progress. @@ -14,7 +14,7 @@ TBD: Glossary Improvement Questions: -- Can we generate this list from doc comments throughout zed? +- Can we generate this list from doc comments throughout the codebase? - We should have a section that shows the various UI parts and their names. (Can't do that in the channel.) --> @@ -73,13 +73,13 @@ h_flex() - `Focus`: The place where keystrokes are handled first - `Focus tree`: Path from the place that has the current focus to the UI Root. Example TODO -## Zed UI +## Gwen UI -- `Window`: A struct representing a Zed window in your desktop environment (see image below). You can have multiple windows open. This is mostly passed around for rendering. +- `Window`: A struct representing a Gwen window in your desktop environment (see image below). You can have multiple windows open. This is mostly passed around for rendering. - `Modal`: A UI element that floats on top of the rest of the UI - `Picker`: A struct representing a list of items floating on top of the UI (Modal). You can select an item and confirm. What happens on select or confirm is determined by the picker's delegate. (The 'Modal' in the image below is a picker.) - `PickerDelegate`: A trait used to specialize behavior for a `Picker`. The `Picker` stores the `PickerDelegate` in the field delegate. -- `Center`: The middle of the zed window, the center is split into multiple `Pane`s. In the codebase this is a field on the `Workspace` struct. (see image below). +- `Center`: The middle of the Gwen window, the center is split into multiple `Pane`s. In the codebase this is a field on the `Workspace` struct. (see image below). - `Pane`: An area in the `Center` where we can place items, such as an editor, multi-buffer or terminal (see image below). - `Panel`: An `Entity` implementing the `Panel` trait. Panels can be placed in a `Dock`. In the image below: `ProjectPanel` is in the left dock, `DebugPanel` is in the bottom dock, and `AgentPanel` is in the right dock. `Editor` does not implement `Panel`. - `Dock`: A UI element similar to a `Pane` that can be opened and hidden. Up to three docks can be open at once: left, right, and bottom. A dock contains one or more `Panel`s, not `Pane`s. @@ -91,13 +91,13 @@ h_flex() Screenshot for the Worktree feature -- [Multibuffer](https://zed.dev/docs/multibuffers): A list of Editors, a multi-buffer allows editing multiple files simultaneously. A multi-buffer opens when an operation in Zed returns multiple locations, examples: _search_ or _go to definition_. See project search in the image below. +- [Multibuffer](https://zed.dev/docs/multibuffers): A list of Editors, a multi-buffer allows editing multiple files simultaneously. A multi-buffer opens when an operation in Gwen returns multiple locations, examples: _search_ or _go to definition_. See project search in the image below. Screenshot for the MultiBuffer feature ## Editor -- `Editor`: The text editor type. Most editable surfaces in Zed are an `Editor`, including single-line inputs. Each pane in the image above contains one or more `Editor` instances. +- `Editor`: The text editor type. Most editable surfaces in Gwen are an `Editor`, including single-line inputs. Each pane in the image above contains one or more `Editor` instances. - `Workspace`: The root of the window - `Entry`: A file, dir, pending dir or unloaded dir. - `Buffer`: The in-memory representation of a 'file' together with relevant data such as syntax trees, git status and diagnostics. @@ -106,14 +106,14 @@ h_flex() ## Collab - `Collab session`: Multiple users working in a shared `Project` -- `Upstream client`: The zed client which has shared their workspace -- `Downstream client`: The zed client joining a shared workspace +- `Upstream client`: The Gwen client which has shared their workspace +- `Downstream client`: The Gwen client joining a shared workspace ## Debugger - `DapStore`: Is an entity that manages debugger sessions - `debugger::Session`: An entity that manages the lifecycle of a debug session and communication with DAPs. -- `BreakpointStore`: Is an entity that manages breakpoint states in local and remote instances of Zed +- `BreakpointStore`: Is an entity that manages breakpoint states in local and remote instances of Gwen - `DebugSession`: Manages a debug session's UI and running state - `RunningState`: Directly manages all the views of a debug session - `VariableList`: The variable and watch list view of a debug session diff --git a/docs/src/development/linux.md b/docs/src/development/linux.md index 2edeecd438..761ee3c70a 100644 --- a/docs/src/development/linux.md +++ b/docs/src/development/linux.md @@ -1,9 +1,9 @@ --- -title: Building Zed for Linux -description: "Guide to building zed for linux for Zed development." +title: Building Gwen for Linux +description: "Guide to building Gwen for Linux." --- -# Building Zed for Linux +# Building Gwen for Linux ## Repository @@ -23,7 +23,7 @@ Clone the [Zed repository](https://github.com/zed-industries/zed). ## Building from source -Once the dependencies are installed, you can build Zed using [Cargo](https://doc.rust-lang.org/cargo/). +Once the dependencies are installed, you can build Gwen using [Cargo](https://doc.rust-lang.org/cargo/). For a debug build of the editor: @@ -51,42 +51,42 @@ You can install a local build on your machine with: ./script/install-linux ``` -This builds `zed` and the `cli` in release mode, installs the binary at `~/.local/bin/zed`, and installs `.desktop` files to `~/.local/share`. +This builds `zed` and the `cli` in release mode, installs the binary at `~/.local/bin/gwen`, and installs `.desktop` files to `~/.local/share`. ## Wayland & X11 -Zed supports both X11 and Wayland. By default, we pick whichever we can find at runtime. If you're on Wayland and want to run in X11 mode, use the environment variable `WAYLAND_DISPLAY=''`. +Gwen supports both X11 and Wayland. By default, we pick whichever we can find at runtime. If you're on Wayland and want to run in X11 mode, use the environment variable `WAYLAND_DISPLAY=''`. -## Notes for packaging Zed +## Notes for packaging Gwen -This section is for distribution maintainers packaging Zed. +This section is for distribution maintainers packaging Gwen. ### Technical requirements -Zed has two main binaries: +Gwen has two main binaries: -- You will need to build `crates/cli` and make its binary available in `$PATH` with the name `zed`. -- You will need to build `crates/zed` and put it at `$PATH/to/cli/../../libexec/zed-editor`. For example, if you are going to put the cli at `~/.local/bin/zed` put zed at `~/.local/libexec/zed-editor`. As some linux distributions (notably Arch) discourage the use of `libexec`, you can also put this binary at `$PATH/to/cli/../../lib/zed/zed-editor` (e.g. `~/.local/lib/zed/zed-editor`) instead. -- If you are going to provide a `.desktop` file you can find a template in `crates/zed/resources/zed.desktop.in`, and use `envsubst` to populate it with the values required. This file should also be renamed to `$APP_ID.desktop` so that the file [follows the FreeDesktop standards](https://github.com/zed-industries/zed/issues/12707#issuecomment-2168742761). You should also make this desktop file executable (`chmod 755`). +- You will need to build `crates/cli` and make its binary available in `$PATH` with the name `gwen`. +- You will need to build `crates/zed` and put it at `$PATH/to/cli/../../libexec/gwen`. For example, if you are going to put the cli at `~/.local/bin/gwen` put the editor binary at `~/.local/libexec/gwen`. As some linux distributions (notably Arch) discourage the use of `libexec`, you can also put this binary at `$PATH/to/cli/../../lib/gwen/gwen` (e.g. `~/.local/lib/gwen/gwen`) instead. +- If you are going to provide a `.desktop` file you can find a template in `crates/zed/resources/gwen.desktop.in`, and use `envsubst` to populate it with the values required. This file should also be renamed to `$APP_ID.desktop` so that the file [follows the FreeDesktop standards](https://github.com/zed-industries/zed/issues/12707#issuecomment-2168742761). You should also make this desktop file executable (`chmod 755`). - You will need to ensure that the necessary libraries are installed. You can get the current list by [inspecting the built binary](https://github.com/zed-industries/zed/blob/935cf542aebf55122ce6ed1c91d0fe8711970c82/script/bundle-linux#L65-L67) on your system. - For an example of a complete build script, see [script/bundle-linux](https://github.com/zed-industries/zed/blob/935cf542aebf55122ce6ed1c91d0fe8711970c82/script/bundle-linux). -- You can disable Zed's auto updates and provide instructions for users who try to update Zed manually by building (or running) Zed with the environment variable `ZED_UPDATE_EXPLANATION`. For example: `ZED_UPDATE_EXPLANATION="Please use flatpak to update zed."`. -- Make sure to update the contents of the `crates/zed/RELEASE_CHANNEL` file to 'nightly', 'preview', or 'stable', with no newline. This will cause Zed to use the credentials manager to remember a user's login. +- You can disable Gwen's auto updates and provide instructions for users who try to update Gwen manually by building (or running) Gwen with the environment variable `ZED_UPDATE_EXPLANATION`. For example: `ZED_UPDATE_EXPLANATION="Please use flatpak to update gwen."`. +- Make sure to update the contents of the `crates/zed/RELEASE_CHANNEL` file to 'nightly', 'preview', or 'stable', with no newline. This will cause Gwen to use the credentials manager to remember a user's login. ### Other things to note -Zed moves quickly, and distribution maintainers often have different constraints and priorities. The points below describe current trade-offs: +Gwen moves quickly, and distribution maintainers often have different constraints and priorities. The points below describe current trade-offs: -- Zed is a fast-moving project. We typically publish 2-3 builds per week to address reported issues and ship larger changes. -- There are a couple of other `zed` binaries that may be present on Linux systems ([1](https://openzfs.github.io/openzfs-docs/man/v2.2/8/zed.8.html), [2](https://zed.brimdata.io/docs/commands/zed)). If you want to rename our CLI binary because of these issues, we suggest `zedit`, `zeditor`, or `zed-cli`. -- Zed automatically installs versions of common developer tools, similar to rustup/rbenv/pyenv. This behavior is discussed [here](https://github.com/zed-industries/zed/issues/12589). +- Gwen is a fast-moving project. We typically publish 2-3 builds per week to address reported issues and ship larger changes. +- There are a couple of unrelated `zed` binaries that may be present on Linux systems ([1](https://openzfs.github.io/openzfs-docs/man/v2.2/8/zed.8.html), [2](https://zed.brimdata.io/docs/commands/zed)). The Gwen CLI binary is named `gwen`, so it does not conflict with them. +- Gwen automatically installs versions of common developer tools, similar to rustup/rbenv/pyenv. This behavior is discussed [here](https://github.com/zed-industries/zed/issues/12589). - Users can install extensions locally and from [zed-industries/extensions](https://github.com/zed-industries/extensions). Extensions may install additional tools such as language servers. Planned safety improvements are tracked [here](https://github.com/zed-industries/zed/issues/12358). -- Zed connects to several online services by default (AI, telemetry, collaboration). AI and our telemetry can be disabled by your users with their zed settings or by patching our [default settings file](https://github.com/zed-industries/zed/blob/main/assets/settings/default.json). -- Because of the points above, Zed currently does not work well with sandboxes. See [this discussion](https://github.com/zed-industries/zed/pull/12006#issuecomment-2130421220). +- Gwen connects to several online services by default (AI, telemetry, collaboration). AI and our telemetry can be disabled by your users with their Gwen settings or by patching our [default settings file](https://github.com/zed-industries/zed/blob/main/assets/settings/default.json). +- Because of the points above, Gwen currently does not work well with sandboxes. See [this discussion](https://github.com/zed-industries/zed/pull/12006#issuecomment-2130421220). ## Flatpak -> Zed's current Flatpak integration exits the sandbox on startup. Workflows that rely on Flatpak's sandboxing may not work as expected. +> Gwen's current Flatpak integration exits the sandbox on startup. Workflows that rely on Flatpak's sandboxing may not work as expected. To build & install the Flatpak package locally follow the steps below: @@ -104,24 +104,24 @@ $ sudo apt install heaptrack heaptrack-gui $ cargo install cargo-heaptrack ``` -Then, to build and run Zed with the profiler attached: +Then, to build and run Gwen with the profiler attached: ```sh -$ cargo heaptrack -b zed +$ cargo heaptrack -b gwen ``` -When this zed instance is exited, terminal output will include a command to run `heaptrack_interpret` to convert the `*.raw.zst` profile to a `*.zst` file which can be passed to `heaptrack_gui` for viewing. +When this Gwen instance is exited, terminal output will include a command to run `heaptrack_interpret` to convert the `*.raw.zst` profile to a `*.zst` file which can be passed to `heaptrack_gui` for viewing. ## Perf recording -How to get a flamegraph with resolved symbols from a running Zed instance. -Use this when Zed is using a lot of CPU. It is not useful for hangs. +How to get a flamegraph with resolved symbols from a running Gwen instance. +Use this when Gwen is using a lot of CPU. It is not useful for hangs. ### During the incident - Find the PID (process ID) using: - `ps -eo size,pid,comm | grep zed | sort | head -n 1 | cut -d ' ' -f 2` - Or find the PID of `zed-editor` with the highest RAM usage in something + `ps -eo size,pid,comm | grep gwen | sort | head -n 1 | cut -d ' ' -f 2` + Or find the PID of `gwen` with the highest RAM usage in something like htop/btop/top. - Install perf: @@ -137,7 +137,7 @@ Use this when Zed is using a lot of CPU. It is not useful for hangs. - Get build info: Run zed again and type {#action zed::About} in the command pallet to get the exact commit. -The `perf.data` file can be sent to Zed together with the exact commit. +The `perf.data` file can be sent to Gwen together with the exact commit. ### Later @@ -159,7 +159,7 @@ Alternatively, rebuild the binary with symbols: ``` - Add the symbols to the perf database: - `perf buildid-cache -v -a ` + `perf buildid-cache -v -a ` - Resolve the symbols from the db: `perf inject -i perf.data -o perf_with_symbols.data` diff --git a/docs/src/development/macos.md b/docs/src/development/macos.md index 42f07aa4f2..6ef7da9df3 100644 --- a/docs/src/development/macos.md +++ b/docs/src/development/macos.md @@ -1,9 +1,9 @@ --- -title: Building Zed for macOS -description: "Guide to building zed for macos for Zed development." +title: Building Gwen for macOS +description: "Guide to building Gwen for macOS." --- -# Building Zed for macOS +# Building Gwen for macOS ## Repository @@ -36,9 +36,9 @@ Clone the [Zed repository](https://github.com/zed-industries/zed). brew install cmake ``` -## Building Zed from Source +## Building Gwen from Source -Once you have the dependencies installed, you can build Zed using [Cargo](https://doc.rust-lang.org/cargo/). +Once you have the dependencies installed, you can build Gwen using [Cargo](https://doc.rust-lang.org/cargo/). For a debug build: @@ -60,7 +60,7 @@ cargo test --workspace ## Visual Regression Tests -Zed includes visual regression tests that capture screenshots of real Zed windows and compare them against baseline images. These tests require macOS with Screen Recording permission. +Gwen includes visual regression tests that capture screenshots of real Gwen windows and compare them against baseline images. These tests require macOS with Screen Recording permission. ### Prerequisites @@ -108,18 +108,18 @@ UPDATE_BASELINE=1 cargo run -p zed --bin zed_visual_test_runner --features visua ## Sampling released builds -How to get a symbolicated CPU profile from a released (non-dev) Zed instance. -Use this when Zed is using a lot of CPU. +How to get a symbolicated CPU profile from a released (non-dev) Gwen instance. +Use this when Gwen is using a lot of CPU. Released macOS binaries are stripped of local symbols, so `sample` and Instruments show raw addresses for most frames. The debug symbols for every release are archived: `script/bundle-mac` uploads `zed.dwarf` to Sentry before stripping. ### During the incident -- Run `sample Zed 10 -f zed-sample.txt` (adjust the process name for Preview or Nightly). +- Run `sample Gwen 10 -f gwen-sample.txt` (adjust the process name for Preview or Nightly). - Get the exact build: type {#action zed::About} in the command palette and copy the version and commit. -The `zed-sample.txt` file can be sent to Zed together with the exact version. +The `gwen-sample.txt` file can be sent to Gwen together with the exact version. ### Later @@ -134,8 +134,8 @@ This can be done by Zed staff. To profile a released build on your own machine with full symbols, download the matching `zed.dwarf`, convert it into a `.dSYM` bundle Spotlight can index, and re-run `sample`: ```sh -mkdir -p Zed.dSYM/Contents/Resources/DWARF -cp zed.dwarf Zed.dSYM/Contents/Resources/DWARF/zed +mkdir -p Gwen.dSYM/Contents/Resources/DWARF +cp zed.dwarf Gwen.dSYM/Contents/Resources/DWARF/gwen ``` Frames then resolve automatically, including file and line information. @@ -209,18 +209,18 @@ This error seems to be caused by OS resource constraints. Installing and running ### Avoiding continual rebuilds -If Zed continually rebuilds root crates, you may be opening the Zed codebase itself in your development build. +If Gwen continually rebuilds root crates, you may be opening the Gwen codebase itself in your development build. This causes problems because `cargo run` exports a bunch of environment variables which are picked up by the `rust-analyzer` that runs in the development -build of Zed. These environment variables are in turn passed to `cargo check`, which +build of Gwen. These environment variables are in turn passed to `cargo check`, which invalidates the build cache of some of the crates we depend on. To avoid this, run the built binary against a different project, for example `cargo run ~/path/to/other/project`. ### Speeding up verification -If you build Zed frequently, macOS may keep verifying new builds, which can add a few seconds to each iteration. +If you build Gwen frequently, macOS may keep verifying new builds, which can add a few seconds to each iteration. To fix this, you can: diff --git a/docs/src/development/release-notes.md b/docs/src/development/release-notes.md index fdd9fc9f60..fff388e273 100644 --- a/docs/src/development/release-notes.md +++ b/docs/src/development/release-notes.md @@ -1,6 +1,6 @@ --- title: Release Notes -description: "Guide to release notes for Zed development." +description: "Guide to release notes for Gwen development." --- # Release Notes @@ -17,13 +17,13 @@ Release Notes: On Wednesdays, we run [`get-preview-channel-changes`](https://github.com/zed-industries/zed/blob/main/script/get-preview-channel-changes), which collects `Release Notes` lines from pull requests landing in preview, as described in the [Release](https://zed.dev/docs/development/release-notes) docs. -The script outputs everything below the `Release Notes` line, including metadata such as the pull request author (if they are not a Zed team member) and a link to the pull request. +The script outputs everything below the `Release Notes` line, including metadata such as the pull request author (if they are not a Gwen team member) and a link to the pull request. If you use `N/A`, the script skips your pull request entirely. ## Guidelines for crafting your `Release Notes` line(s) -- A `Release Notes` line should only be written if the user can see or feel the difference in Zed. -- A `Release Notes` line should be written such that a Zed user can understand what the change is. +- A `Release Notes` line should only be written if the user can see or feel the difference in Gwen. +- A `Release Notes` line should be written such that a Gwen user can understand what the change is. Don't assume a user knows technical editor developer lingo; phrase your change in language they understand as a user of a text editor. - If you want to include technical details about your pull request for other team members to see, do so above the `Release Notes` line. - Changes to docs should be labeled as `N/A`. diff --git a/docs/src/development/windows.md b/docs/src/development/windows.md index 2b85d9a6ca..cff49e03e8 100644 --- a/docs/src/development/windows.md +++ b/docs/src/development/windows.md @@ -1,9 +1,9 @@ --- -title: Building Zed for Windows -description: "Guide to building zed for windows for Zed development." +title: Building Gwen for Windows +description: "Guide to building Gwen for Windows." --- -# Building Zed for Windows +# Building Gwen for Windows > The following commands may be executed in any shell. @@ -23,7 +23,7 @@ Clone the [Zed repository](https://github.com/zed-industries/zed). > Starting with Visual Studio 2026 (or MSVC 14.50), you need to install optional components `MSVC Build Tools for x64/x86 (Latest)` and `C++ Spectre-mitigated libraries for x64/x86 (Latest MSVC)`, since Microsoft has decoupled the MSVC version from the Visual Studio version. The traditional naming format `MSVC v*** - VS YYYY C++ x64/x86 ...` will no longer be applicable to newer MSVC toolchain. See [this blog](https://devblogs.microsoft.com/cppblog/new-release-cadence-and-support-lifecycle-for-msvc-build-tools/) for more details. -If you cannot compile Zed, make sure a Visual Studio installation includes at least the following components: +If you cannot compile Gwen, make sure a Visual Studio installation includes at least the following components: ```json { @@ -95,7 +95,7 @@ After this, restart the `postgresql` service. Press `Win`+`R` to open the Run di ## Building from source -Once you have the dependencies installed, you can build Zed using [Cargo](https://doc.rust-lang.org/cargo/). +Once you have the dependencies installed, you can build Gwen using [Cargo](https://doc.rust-lang.org/cargo/). For a debug build: @@ -115,11 +115,11 @@ And to run the tests: cargo test --workspace ``` -> **Note:** Visual regression tests are currently macOS-only and require Screen Recording permission. See [Building Zed for macOS](./macos.md#visual-regression-tests) for details. +> **Note:** Visual regression tests are currently macOS-only and require Screen Recording permission. See [Building Gwen for macOS](./macos.md#visual-regression-tests) for details. ## Installing from msys2 -Zed does not support unofficial MSYS2 Zed packages built for Mingw-w64. Please report any issues you may have with [mingw-w64-zed](https://packages.msys2.org/base/mingw-w64-zed) to [msys2/MINGW-packages/issues](https://github.com/msys2/MINGW-packages/issues?q=is%3Aissue+is%3Aopen+zed). +Gwen does not support unofficial MSYS2 Zed packages built for Mingw-w64. Please report any issues you may have with [mingw-w64-zed](https://packages.msys2.org/base/mingw-w64-zed) to [msys2/MINGW-packages/issues](https://github.com/msys2/MINGW-packages/issues?q=is%3Aissue+is%3Aopen+zed). Please refer to [MSYS2 documentation](https://www.msys2.org/docs/ides-editors/#zed) first. @@ -127,7 +127,7 @@ Please refer to [MSYS2 documentation](https://www.msys2.org/docs/ides-editors/#z ### Setting `RUSTFLAGS` env var breaks builds -If you set the `RUSTFLAGS` env var, it will override the `rustflags` settings in `.cargo/config.toml` which is required to properly build Zed. +If you set the `RUSTFLAGS` env var, it will override the `rustflags` settings in `.cargo/config.toml` which is required to properly build Gwen. Because these settings change over time, the resulting build errors may vary from linker failures to other hard-to-diagnose errors. @@ -187,7 +187,7 @@ See this issue for more information [#12041](https://github.com/zed-industries/z ### Invalid RC path selected -Sometimes, depending on the security rules applied to your laptop, you may get the following error while compiling Zed: +Sometimes, depending on the security rules applied to your laptop, you may get the following error while compiling Gwen: ``` error: failed to run custom build command for `zed(C:\Users\USER\src\zed\crates\zed)` @@ -245,20 +245,20 @@ For more information on this, please see [win32 docs](https://learn.microsoft.co ### Graphics issues -#### Zed fails to launch +#### Gwen fails to launch -Zed currently uses Vulkan as its graphics API on Windows. If Zed fails to launch, Vulkan is a common cause. +Gwen currently uses Vulkan as its graphics API on Windows. If Gwen fails to launch, Vulkan is a common cause. -You can check the Zed log at: -`C:\Users\YOU\AppData\Local\Zed\logs\Zed.log` +You can check the Gwen log at: +`C:\Users\YOU\AppData\Local\Gwen\logs\Gwen.log` If you see messages like: -- `Zed failed to open a window: NoSupportedDeviceFound` +- `Gwen failed to open a window: NoSupportedDeviceFound` - `ERROR_INITIALIZATION_FAILED` - `GPU Crashed` - `ERROR_SURFACE_LOST_KHR` Vulkan may not be working correctly on your system. Updating GPU drivers often resolves this. -If there's nothing Vulkan-related in the logs and you happen to have Bandicam installed, try uninstalling it. Zed is currently not compatible with Bandicam. +If there's nothing Vulkan-related in the logs and you happen to have Bandicam installed, try uninstalling it. Gwen is currently not compatible with Bandicam. diff --git a/docs/src/diagnostics.md b/docs/src/diagnostics.md index ad7e5a9660..3c2bc83a15 100644 --- a/docs/src/diagnostics.md +++ b/docs/src/diagnostics.md @@ -1,15 +1,15 @@ --- -title: Diagnostics - Errors and Warnings in Zed -description: View and navigate errors, warnings, and code diagnostics from language servers in Zed. +title: Diagnostics - Errors and Warnings in Gwen +description: View and navigate errors, warnings, and code diagnostics from language servers in Gwen. --- # Diagnostics -Zed gets its diagnostics from the language servers and supports both push and pull variants of the LSP which makes it compatible with all existing language servers. +Gwen gets its diagnostics from the language servers and supports both push and pull variants of the LSP which makes it compatible with all existing language servers. # Regular diagnostics -By default, Zed displays all diagnostics as underlined text in the editor and the scrollbar. +By default, Gwen displays all diagnostics as underlined text in the editor and the scrollbar. Editor diagnostics could be filtered with the @@ -34,7 +34,7 @@ Or, `editor::GoToDiagnostic` and `editor::GoToPreviousDiagnostic` could be used # Inline diagnostics (Error lens) -Zed supports showing diagnostics as a lens to the right of the code. +Gwen supports showing diagnostics as a lens to the right of the code. This is disabled by default, but can either be temporarily turned on (or off) using the editor menu, or permanently, using the ```json [settings] diff --git a/docs/src/editing-code.md b/docs/src/editing-code.md index 9f177c7a59..49cc5acee1 100644 --- a/docs/src/editing-code.md +++ b/docs/src/editing-code.md @@ -1,11 +1,11 @@ --- -title: Editing Code in Zed -description: Core code editing features in Zed including multi-cursor, refactoring, code actions, and language server integration. +title: Editing Code in Gwen +description: Core code editing features in Gwen including multi-cursor, refactoring, code actions, and language server integration. --- # Editing Code -Zed provides tools to help you write and modify code efficiently. This section covers the core editing features that work alongside your language server. +Gwen provides tools to help you write and modify code efficiently. This section covers the core editing features that work alongside your language server. ## What's in This Section @@ -17,7 +17,7 @@ Zed provides tools to help you write and modify code efficiently. This section c ## How These Features Work Together -When you're editing code, Zed combines input from multiple sources: +When you're editing code, Gwen combines input from multiple sources: 1. **Language servers** provide completions, diagnostics, and quick fixes based on your project's types and structure 2. **[Edit predictions](./ai/edit-prediction.md)** suggest multi-character or multi-line changes as you type diff --git a/docs/src/environment.md b/docs/src/environment.md index 538134694a..6f96f1fda2 100644 --- a/docs/src/environment.md +++ b/docs/src/environment.md @@ -1,53 +1,53 @@ --- -title: Environment Variables - Zed -description: How Zed detects and uses environment variables. Shell integration, dotenv support, and troubleshooting. +title: Environment Variables - Gwen +description: How Gwen detects and uses environment variables. Shell integration, dotenv support, and troubleshooting. --- # Environment Variables -_**Note**: The following only applies to Zed 0.152.0 and later._ +_**Note**: The following only applies to Gwen 0.152.0 and later._ -Multiple features in Zed are affected by environment variables: +Multiple features in Gwen are affected by environment variables: - [Tasks](./tasks.md) - [Built-in terminal](./terminal.md) - Look-up of language servers - Language servers -To make the best use of these features, it helps to understand where Zed gets environment variables and how it uses them. +To make the best use of these features, it helps to understand where Gwen gets environment variables and how it uses them. -## Where does Zed get its environment variables from? +## Where does Gwen get its environment variables from? -How Zed starts affects which environment variables it can use. That includes launching from the macOS Dock, a Linux window manager, or the `zed` CLI. +How Gwen starts affects which environment variables it can use. That includes launching from the macOS Dock, a Linux window manager, or the `gwen` CLI. ### Launched from the CLI -If Zed is opened via the CLI (`zed`), it will inherit the environment variables from the surrounding shell session. +If Gwen is opened via the CLI (`gwen`), it will inherit the environment variables from the surrounding shell session. That means if you do ``` $ export MY_ENV_VAR=hello -$ zed . +$ gwen . ``` -the environment variable `MY_ENV_VAR` is now available inside Zed. For example, in the built-in terminal. +the environment variable `MY_ENV_VAR` is now available inside Gwen. For example, in the built-in terminal. -Starting with Zed 0.152.0, the CLI `zed` will _always_ pass along its environment to Zed, regardless of whether a Zed instance was previously running or not. Prior to Zed 0.152.0 this was not the case and only the first Zed instance would inherit the environment variables. +Starting with Gwen 0.152.0, the CLI `gwen` will _always_ pass along its environment to Gwen, regardless of whether a Gwen instance was previously running or not. Prior to Gwen 0.152.0 this was not the case and only the first Gwen instance would inherit the environment variables. ### Launched via window manager, Dock, or launcher -When Zed has been launched via the macOS Dock, or a GNOME or KDE icon on Linux, or an application launcher like Alfred or Raycast, it has no surrounding shell environment from which to inherit its environment variables. +When Gwen has been launched via the macOS Dock, or a GNOME or KDE icon on Linux, or an application launcher like Alfred or Raycast, it has no surrounding shell environment from which to inherit its environment variables. -To still have a useful environment, Zed spawns a login shell in the user's home directory and reads its environment. This environment is then set on the Zed _process_, so all Zed windows and projects inherit it. +To still have a useful environment, Gwen spawns a login shell in the user's home directory and reads its environment. This environment is then set on the Gwen _process_, so all Gwen windows and projects inherit it. -Since that can lead to problems for users who need different environment variables per project (for example with `direnv`, `asdf`, or `mise`), Zed spawns another login shell when opening a project. This second shell runs in the project's directory. The environment from that shell is _not_ set on the process, because opening a new project would otherwise change the environment for all Zed windows. Instead, that environment is stored and passed along when running tasks, opening terminals, or spawning language servers. +Since that can lead to problems for users who need different environment variables per project (for example with `direnv`, `asdf`, or `mise`), Gwen spawns another login shell when opening a project. This second shell runs in the project's directory. The environment from that shell is _not_ set on the process, because opening a new project would otherwise change the environment for all Gwen windows. Instead, that environment is stored and passed along when running tasks, opening terminals, or spawning language servers. ## Where and how are environment variables used? There are two sets of environment variables: -1. Environment variables of the Zed process +1. Environment variables of the Gwen process 2. Environment variables stored per project The variables from (1) are always used, since they are stored on the process itself and every spawned process (tasks, terminals, language servers, ...) will inherit them by default. @@ -58,7 +58,7 @@ The variables from (2) are used explicitly, depending on the feature. Tasks are spawned with a combined environment. In order of precedence (low to high, with the last overwriting the first): -- the Zed process environment +- the Gwen process environment - if the project was opened from the CLI: the CLI environment - if the project was not opened from the CLI: the project environment variables obtained by running a login shell in the project's root folder - optional, explicitly configured environment in settings @@ -67,7 +67,7 @@ Tasks are spawned with a combined environment. In order of precedence (low to hi Built-in terminals, like tasks, are spawned with a combined environment. In order of precedence (low to high): -- the Zed process environment +- the Gwen process environment - if the project was opened from the CLI: the CLI environment - if the project was not opened from the CLI: the project environment variables obtained by running a login shell in the project's root folder - optional, explicitly configured environment in settings @@ -82,16 +82,16 @@ For some languages the language server adapters lookup the binary in the user's - C - TypeScript -For this look-up, Zed uses the following environment: +For this look-up, Gwen uses the following environment: - if the project was opened from the CLI: the CLI environment - if the project was not opened from the CLI: the project environment variables obtained by running a login shell in the project's root folder ### Language servers -After looking up a language server, Zed starts it. +After looking up a language server, Gwen starts it. -These language server processes always inherit Zed's process environment. But, depending on the language server look-up, additional environment variables might be set or overwrite the process environment. +These language server processes always inherit Gwen's process environment. But, depending on the language server look-up, additional environment variables might be set or overwrite the process environment. - If the language server was found in the project environment's `$PATH`, then that project environment is passed along to the language server process. Where the project environment comes from depends on how the project was opened (via CLI or not). See the previous section on language server look-up. -- If the language server was not found in the project environment, Zed tries to install and start it globally. In that case, the process inherits Zed's process environment and, if the project was opened via CLI, the CLI environment. +- If the language server was not found in the project environment, Gwen tries to install and start it globally. In that case, the process inherits Gwen's process environment and, if the project was opened via CLI, the CLI environment. diff --git a/docs/src/extensions.md b/docs/src/extensions.md index 4bb627584e..0987039f00 100644 --- a/docs/src/extensions.md +++ b/docs/src/extensions.md @@ -1,11 +1,11 @@ --- title: Extensions -description: "Extend Zed with themes, language support, AI tools, and more through the extension system." +description: "Extend Gwen with themes, language support, AI tools, and more through the extension system." --- # Extensions -Zed lets you add new functionality using user-defined extensions. +Gwen lets you add new functionality using user-defined extensions. - [Installing Extensions](./extensions/installing-extensions.md) - [Extension Capabilities](./extensions/capabilities.md) diff --git a/docs/src/extensions/agent-servers.md b/docs/src/extensions/agent-servers.md index 8c4d5af205..5fe7ded0f8 100644 --- a/docs/src/extensions/agent-servers.md +++ b/docs/src/extensions/agent-servers.md @@ -1,9 +1,9 @@ --- title: Agent Server Extensions -description: "Agent Server Extensions for Zed extensions." +description: "Agent Server Extensions for Gwen extensions." --- # Agent Server Extensions -As of Zed `v1.5.0`, ACP extensions have been deprecated in favor of [the ACP Registry](https://agentclientprotocol.com/registry). +As of Gwen `v1.5.0`, ACP extensions have been deprecated in favor of [the ACP Registry](https://agentclientprotocol.com/registry). You can learn more about it in [the release blog post](https://zed.dev/blog/acp-registry). diff --git a/docs/src/extensions/capabilities.md b/docs/src/extensions/capabilities.md index 852803f889..6896bc6785 100644 --- a/docs/src/extensions/capabilities.md +++ b/docs/src/extensions/capabilities.md @@ -1,11 +1,11 @@ --- title: Extension Capabilities -description: "Extension Capabilities for Zed extensions." +description: "Extension Capabilities for Gwen extensions." --- # Extension Capabilities -The operations that Zed extensions are able to perform are governed by a capability system. +The operations that Gwen extensions are able to perform are governed by a capability system. ## Restricting capabilities diff --git a/docs/src/extensions/debugger-extensions.md b/docs/src/extensions/debugger-extensions.md index 08d9511907..abe5e33732 100644 --- a/docs/src/extensions/debugger-extensions.md +++ b/docs/src/extensions/debugger-extensions.md @@ -1,6 +1,6 @@ --- title: Debugger Extensions -description: "Debugger Extensions for Zed extensions." +description: "Debugger Extensions for Gwen extensions." --- # Debugger Extensions @@ -67,7 +67,7 @@ Put another way, it is supposed to answer the question: "Given a program, a list ## Defining Debug Locators -Zed offers an automatic way to create debug scenarios with _debug locators_. +Gwen offers an automatic way to create debug scenarios with _debug locators_. A locator locates the debug target and figures out how to spawn a debug session for it. Thanks to locators, we can automatically convert existing user tasks (e.g. `cargo run`) and convert them into debug scenarios (e.g. `cargo build` followed by spawning a debugger with `target/debug/my_program` as the program to debug). > Your extension can define its own debug locators even if it does not expose a debug adapter. We strongly recommend doing so when your extension already exposes language tasks, as it allows users to spawn a debug session without having to manually configure the debug adapter. @@ -113,7 +113,7 @@ Note however that you do _not_ need to go through a 2-phase resolution; if you c ## Available Extensions -See DAP servers published as extensions [on Zed's site](https://zed.dev/extensions?filter=debug-adapters). +See DAP servers published as extensions [on Gwen's site](https://zed.dev/extensions?filter=debug-adapters). Review their repositories to see common implementation patterns and structure. diff --git a/docs/src/extensions/developing-extensions.md b/docs/src/extensions/developing-extensions.md index 44b293154f..0bbce5cf03 100644 --- a/docs/src/extensions/developing-extensions.md +++ b/docs/src/extensions/developing-extensions.md @@ -1,11 +1,11 @@ --- title: Developing Extensions -description: "Create Zed extensions: languages, themes, debuggers, and more." +description: "Create Gwen extensions: languages, themes, debuggers, and more." --- # Developing Extensions {#developing-extensions} -Zed extensions are Git repositories containing an `extension.toml` manifest. They can provide languages, themes, debuggers, snippets, and MCP servers. +Gwen extensions are Git repositories containing an `extension.toml` manifest. They can provide languages, themes, debuggers, snippets, and MCP servers. ## Extension Features {#extension-features} @@ -20,23 +20,23 @@ Extensions can provide: ## Developing an Extension Locally -Before starting to develop an extension for Zed, be sure to [install Rust via rustup](https://www.rust-lang.org/tools/install). +Before starting to develop an extension for Gwen, be sure to [install Rust via rustup](https://www.rust-lang.org/tools/install). -> Zed uses the `wasm32-wasip2` Rust target to compile extensions. If Rust is installed via rustup, Zed will install the target automatically. If Rust is installed another way (e.g., via Homebrew or Nix), you must make the `wasm32-wasip2` target available yourself — for example, by adding it to the `targets` of a Nix rust-overlay or fenix toolchain. +> Gwen uses the `wasm32-wasip2` Rust target to compile extensions. If Rust is installed via rustup, Gwen will install the target automatically. If Rust is installed another way (e.g., via Homebrew or Nix), you must make the `wasm32-wasip2` target available yourself — for example, by adding it to the `targets` of a Nix rust-overlay or fenix toolchain. -Extensions that provide grammars additionally require the [wasi-sdk](https://github.com/WebAssembly/wasi-sdk) to compile Tree-sitter parsers. Zed downloads it automatically, but you can point Zed at an existing installation by setting the `WASI_SDK_PATH` environment variable to its root directory (the one containing `bin/clang`). +Extensions that provide grammars additionally require the [wasi-sdk](https://github.com/WebAssembly/wasi-sdk) to compile Tree-sitter parsers. Gwen downloads it automatically, but you can point Gwen at an existing installation by setting the `WASI_SDK_PATH` environment variable to its root directory (the one containing `bin/clang`). -When developing an extension, you can use it in Zed without needing to publish it by installing it as a _dev extension_. +When developing an extension, you can use it in Gwen without needing to publish it by installing it as a _dev extension_. From the extensions page, click the `Install Dev Extension` button (or the {#action zed::InstallDevExtension} action) and select the directory containing your extension. -If you need to troubleshoot, check Zed.log ({#action zed::OpenLog}) for additional output. For debug output, close and relaunch Zed from the command line with `zed --foreground`, which shows more verbose INFO-level logs. +If you need to troubleshoot, check Gwen.log ({#action zed::OpenLog}) for additional output. For debug output, close and relaunch Gwen from the command line with `gwen --foreground`, which shows more verbose INFO-level logs. If you already have the published version of the extension installed, the published version will be uninstalled prior to the installation of the dev extension. After successful installation, the `Extensions` page will indicate that the upstream extension is "Overridden by dev extension". -## Directory Structure of a Zed Extension +## Directory Structure of a Gwen Extension -A Zed extension is a Git repository that contains an `extension.toml`. This file must contain some +A Gwen extension is a Git repository that contains an `extension.toml`. This file must contain some basic information about the extension: ```toml @@ -49,7 +49,7 @@ description = "Example extension" repository = "https://github.com/your-name/my-zed-extension" ``` -In addition to this, there are several other optional files and directories that can be used to add functionality to a Zed extension. An example directory structure of an extension that provides all capabilities is as follows: +In addition to this, there are several other optional files and directories that can be used to add functionality to a Gwen extension. An example directory structure of an extension that provides all capabilities is as follows: ``` my-extension/ @@ -87,7 +87,7 @@ crate-type = ["cdylib"] zed_extension_api = "0.1.0" ``` -Use the latest version of the [`zed_extension_api`](https://crates.io/crates/zed_extension_api) available on crates.io. Make sure it's still [compatible with Zed versions](https://github.com/zed-industries/zed/blob/main/crates/extension_api#compatible-zed-versions) you want to support. +Use the latest version of the [`zed_extension_api`](https://crates.io/crates/zed_extension_api) available on crates.io. Make sure it's still [compatible with Gwen versions](https://github.com/zed-industries/zed/blob/main/crates/extension_api#compatible-zed-versions) you want to support. In the `src/lib.rs` file in your Rust crate you will need to define a struct for your extension and implement the `Extension` trait, as well as use the `register_extension!` macro to register your extension: @@ -109,4 +109,4 @@ zed::register_extension!(MyExtension); ### Debugging your Rust extension -`stdout`/`stderr` is forwarded directly to the Zed process. In order to see `println!`/`dbg!` output from your extension, you can start Zed in your terminal with a `--foreground` flag. +`stdout`/`stderr` is forwarded directly to the Gwen process. In order to see `println!`/`dbg!` output from your extension, you can start Gwen in your terminal with a `--foreground` flag. diff --git a/docs/src/extensions/icon-themes.md b/docs/src/extensions/icon-themes.md index 8af82d201d..3fe05016f5 100644 --- a/docs/src/extensions/icon-themes.md +++ b/docs/src/extensions/icon-themes.md @@ -1,11 +1,11 @@ --- title: Icon Themes -description: "Icon Themes for Zed extensions." +description: "Icon Themes for Gwen extensions." --- # Icon Themes -Extensions may provide icon themes to change the icons Zed uses for folders and files. +Extensions may provide icon themes to change the icons Gwen uses for folders and files. ## Example extension diff --git a/docs/src/extensions/installing-extensions.md b/docs/src/extensions/installing-extensions.md index e7af107f00..cce40205a8 100644 --- a/docs/src/extensions/installing-extensions.md +++ b/docs/src/extensions/installing-extensions.md @@ -1,19 +1,19 @@ --- title: Installing Extensions -description: "Browse, install, and manage extensions from the Zed Extension Gallery." +description: "Browse, install, and manage extensions from the Gwen Extension Gallery." --- # Installing Extensions {#installing-extensions} -Extensions add functionality to Zed, including languages, themes, and AI tools. Browse and install them from the Extension Gallery. +Extensions add functionality to Gwen, including languages, themes, and AI tools. Browse and install them from the Extension Gallery. -Open the Extension Gallery with {#kb zed::Extensions}, or select "Zed > Extensions" from the menu bar. +Open the Extension Gallery with {#kb zed::Extensions}, or select "Gwen > Extensions" from the menu bar. ## Installation Location -- On macOS, extensions are installed in `~/Library/Application Support/Zed/extensions`. -- On Linux, they are installed in either `$XDG_DATA_HOME/zed/extensions` or `~/.local/share/zed/extensions`. -- On Windows, the directory is `%LOCALAPPDATA%\Zed\extensions`. +- On macOS, extensions are installed in `~/Library/Application Support/Gwen/extensions`. +- On Linux, they are installed in either `$XDG_DATA_HOME/gwen/extensions` or `~/.local/share/gwen/extensions`. +- On Windows, the directory is `%LOCALAPPDATA%\Gwen\extensions`. This directory contains two subdirectories: diff --git a/docs/src/extensions/languages.md b/docs/src/extensions/languages.md index c0157c1760..653540a18e 100644 --- a/docs/src/extensions/languages.md +++ b/docs/src/extensions/languages.md @@ -1,11 +1,11 @@ --- title: Language Extensions -description: "Overview of programming language support in Zed, including built-in and extension-based languages." +description: "Overview of programming language support in Gwen, including built-in and extension-based languages." --- # Language Extensions -Language support in Zed has several components: +Language support in Gwen has several components: - Language metadata and configuration - Grammar @@ -14,7 +14,7 @@ Language support in Zed has several components: ## Language Metadata -Each language supported by Zed must be defined in a subdirectory inside the `languages` directory of your extension. +Each language supported by Gwen must be defined in a subdirectory inside the `languages` directory of your extension. This subdirectory must contain a file called `config.toml` file with the following structure: @@ -31,8 +31,8 @@ line_comments = ["# "] - `line_comments` is an array of strings that are used to identify line comments in the language. This is used for the `editor::ToggleComments` keybind: {#kb editor::ToggleComments} for toggling lines of code. - `tab_size` defines the indentation/tab size used for this language (default is `4`). - `hard_tabs` whether to indent with tabs (`true`) or spaces (`false`, the default). -- `first_line_pattern` is a regular expression that can be used alongside `path_suffixes` (above) or `file_types` in settings to match files that should use this language. For example, Zed uses this to identify Shell Scripts by matching [shebang lines](https://github.com/zed-industries/zed/blob/main/crates/languages/src/bash/config.toml) in the first line of a script. -- `debuggers` is an array of strings that are used to identify debuggers in the language. When launching a debugger's `New Process Modal`, Zed will order available debuggers by the order of entries in this array. +- `first_line_pattern` is a regular expression that can be used alongside `path_suffixes` (above) or `file_types` in settings to match files that should use this language. For example, Gwen uses this to identify Shell Scripts by matching [shebang lines](https://github.com/zed-industries/zed/blob/main/crates/languages/src/bash/config.toml) in the first line of a script. +- `debuggers` is an array of strings that are used to identify debuggers in the language. When launching a debugger's `New Process Modal`, Gwen will order available debuggers by the order of entries in this array. diff --git a/docs/src/languages/erlang.md b/docs/src/languages/erlang.md index d215dd12bd..d117e1f4a1 100644 --- a/docs/src/languages/erlang.md +++ b/docs/src/languages/erlang.md @@ -1,6 +1,6 @@ --- title: Erlang -description: "Configure Erlang language support in Zed, including language servers, formatting, and debugging." +description: "Configure Erlang language support in Gwen, including language servers, formatting, and debugging." --- # Erlang diff --git a/docs/src/languages/fish.md b/docs/src/languages/fish.md index 6421feb7a7..90ee3d25a3 100644 --- a/docs/src/languages/fish.md +++ b/docs/src/languages/fish.md @@ -1,18 +1,18 @@ --- title: Fish -description: "Configure Fish language support in Zed, including language servers, formatting, and debugging." +description: "Configure Fish language support in Gwen, including language servers, formatting, and debugging." --- # Fish -Fish language support in Zed is provided by the community-maintained [Fish extension](https://github.com/hasit/zed-fish). +Fish language support in Gwen is provided by the community-maintained [Fish extension](https://github.com/hasit/zed-fish). Report issues to: [https://github.com/hasit/zed-fish/issues](https://github.com/hasit/zed-fish/issues) - Tree-sitter: [ram02z/tree-sitter-fish](https://github.com/ram02z/tree-sitter-fish) ### Formatting -Zed supports auto-formatting fish code using external tools like [`fish_indent`](https://fishshell.com/docs/current/cmds/fish_indent.html), which is included with fish. +Gwen supports auto-formatting fish code using external tools like [`fish_indent`](https://fishshell.com/docs/current/cmds/fish_indent.html), which is included with fish. 1. Ensure `fish_indent` is available in your path and check the version: @@ -21,7 +21,7 @@ which fish_indent fish_indent --version ``` -2. Configure Zed to automatically format fish code with `fish_indent`: +2. Configure Gwen to automatically format fish code with `fish_indent`: ```json [settings] "languages": { diff --git a/docs/src/languages/gdscript.md b/docs/src/languages/gdscript.md index 7943997c4e..764633e3cb 100644 --- a/docs/src/languages/gdscript.md +++ b/docs/src/languages/gdscript.md @@ -1,11 +1,11 @@ --- title: GDScript -description: "Configure GDScript language support in Zed, including language servers, formatting, and debugging." +description: "Configure GDScript language support in Gwen, including language servers, formatting, and debugging." --- # GDScript -Godot [GDScript](https://gdscript.com/) language support in Zed is provided by the community-maintained [GDScript extension](https://github.com/GDQuest/zed-gdscript). +Godot [GDScript](https://gdscript.com/) language support in Gwen is provided by the community-maintained [GDScript extension](https://github.com/GDQuest/zed-gdscript). Report issues to: [https://github.com/GDQuest/zed-gdscript/issues](https://github.com/GDQuest/zed-gdscript/issues) - Tree-sitter: [PrestonKnopp/tree-sitter-gdscript](https://github.com/PrestonKnopp/tree-sitter-gdscript) and [PrestonKnopp/tree-sitter-godot-resource](https://github.com/PrestonKnopp/tree-sitter-godot-resource) @@ -24,7 +24,7 @@ You will need: - Exec Path: `/path/to/zed` - Exec Flags: `{project} {file}:{line}:{col}` - Use External Editor: "✅ On" -2. Open any \*.gd file through Godot and Zed will launch. +2. Open any \*.gd file through Godot and Gwen will launch. ## Usage diff --git a/docs/src/languages/gleam.md b/docs/src/languages/gleam.md index af19b77886..88754b6f1e 100644 --- a/docs/src/languages/gleam.md +++ b/docs/src/languages/gleam.md @@ -1,6 +1,6 @@ --- title: Gleam -description: "Configure Gleam language support in Zed, including language servers, formatting, and debugging." +description: "Configure Gleam language support in Gwen, including language servers, formatting, and debugging." --- # Gleam diff --git a/docs/src/languages/glsl.md b/docs/src/languages/glsl.md index abf84513ec..641a1e2448 100644 --- a/docs/src/languages/glsl.md +++ b/docs/src/languages/glsl.md @@ -1,6 +1,6 @@ --- title: GLSL -description: "Configure GLSL language support in Zed, including language servers, formatting, and debugging." +description: "Configure GLSL language support in Gwen, including language servers, formatting, and debugging." --- # GLSL diff --git a/docs/src/languages/go.md b/docs/src/languages/go.md index c7ed310b3b..5b7a827b7d 100644 --- a/docs/src/languages/go.md +++ b/docs/src/languages/go.md @@ -1,11 +1,11 @@ --- title: Go -description: "Configure Go language support in Zed, including language servers, formatting, and debugging." +description: "Configure Go language support in Gwen, including language servers, formatting, and debugging." --- # Go -Go support is available natively in Zed. +Go support is available natively in Gwen. - Tree-sitter: [tree-sitter/tree-sitter-go](https://github.com/tree-sitter/tree-sitter-go) - Language Server: [golang/tools/tree/master/gopls](https://github.com/golang/tools/tree/master/gopls) @@ -44,7 +44,7 @@ If `gopls` is not found you will likely need to add `export PATH="$PATH:$HOME/go ## Inlay Hints -Zed sets the following initialization options for inlay hints: +Gwen sets the following initialization options for inlay hints: ```json "hints": { @@ -58,7 +58,7 @@ Zed sets the following initialization options for inlay hints: } ``` -to make the language server send back inlay hints when Zed has them enabled in the settings. +to make the language server send back inlay hints when Gwen has them enabled in the settings. Use @@ -80,7 +80,7 @@ See [gopls inlayHints documentation](https://github.com/golang/tools/blob/master ## Code Lens -Zed enables the `test` code lens for `gopls` by default. This shows "run test" and "run benchmark" links above `Test` and `Benchmark` functions in `*_test.go` files. To use them, enable the `code_lens` setting: +Gwen enables the `test` code lens for `gopls` by default. This shows "run test" and "run benchmark" links above `Test` and `Benchmark` functions in `*_test.go` files. To use them, enable the `code_lens` setting: ```json [settings] { @@ -113,7 +113,7 @@ See [gopls code lenses documentation](https://go.dev/gopls/codelenses) for more ## Debugging -Zed supports zero-configuration debugging of Go tests and entry points (`func main`) using Delve. Run {#action debugger::Start} ({#kb debugger::Start}) to see a contextual list of these preconfigured debug tasks. +Gwen supports zero-configuration debugging of Go tests and entry points (`func main`) using Delve. Run {#action debugger::Start} ({#kb debugger::Start}) to see a contextual list of these preconfigured debug tasks. For more control, you can add debug configurations to `.zed/debug.json`. See below for examples. @@ -198,7 +198,7 @@ and the "build" command should build that. ### Attaching to an existing instance of Delve -You might find yourself needing to connect to an existing instance of Delve that's not necessarily running on your machine; in such case, you can use `tcp_arguments` to instrument Zed's connection to Delve. +You might find yourself needing to connect to an existing instance of Delve that's not necessarily running on your machine; in such case, you can use `tcp_arguments` to instrument Gwen's connection to Delve. ```json [debug] [ @@ -217,7 +217,7 @@ You might find yourself needing to connect to an existing instance of Delve that ] ``` -In such case Zed won't spawn a new instance of Delve, as it opts to use an existing one. The consequence of this is that _there will be no terminal_ in Zed; you have to interact with the Delve instance directly, as it handles stdin/stdout of the debuggee. +In such case Gwen won't spawn a new instance of Delve, as it opts to use an existing one. The consequence of this is that _there will be no terminal_ in Gwen; you have to interact with the Delve instance directly, as it handles stdin/stdout of the debuggee. ## Go Mod diff --git a/docs/src/languages/groovy.md b/docs/src/languages/groovy.md index e43dddba43..3af30457a5 100644 --- a/docs/src/languages/groovy.md +++ b/docs/src/languages/groovy.md @@ -1,11 +1,11 @@ --- title: Groovy -description: "Configure Groovy language support in Zed, including language servers, formatting, and debugging." +description: "Configure Groovy language support in Gwen, including language servers, formatting, and debugging." --- # Groovy -Groovy language support in Zed is provided by the community-maintained [Groovy extension](https://github.com/valentinegb/zed-groovy). +Groovy language support in Gwen is provided by the community-maintained [Groovy extension](https://github.com/valentinegb/zed-groovy). Report issues to: [https://github.com/valentinegb/zed-groovy/issues](https://github.com/valentinegb/zed-groovy/issues) - Tree-sitter: [murtaza64/tree-sitter-groovy](https://github.com/murtaza64/tree-sitter-groovy) diff --git a/docs/src/languages/haskell.md b/docs/src/languages/haskell.md index 258eab1fd6..d8dcd3bf79 100644 --- a/docs/src/languages/haskell.md +++ b/docs/src/languages/haskell.md @@ -1,6 +1,6 @@ --- title: Haskell -description: "Configure Haskell language support in Zed, including language servers, formatting, and debugging." +description: "Configure Haskell language support in Gwen, including language servers, formatting, and debugging." --- # Haskell @@ -22,7 +22,7 @@ which haskell-language-server-wrapper ## Configuring HLS -If you need to configure haskell-language-server (hls) you can add configuration options to your Zed settings.json: +If you need to configure haskell-language-server (hls) you can add configuration options to your Gwen settings.json: ```json [settings] { diff --git a/docs/src/languages/helm.md b/docs/src/languages/helm.md index c5fed53d27..9ef90963cc 100644 --- a/docs/src/languages/helm.md +++ b/docs/src/languages/helm.md @@ -1,11 +1,11 @@ --- title: Helm -description: "Configure Helm language support in Zed, including language servers, formatting, and debugging." +description: "Configure Helm language support in Gwen, including language servers, formatting, and debugging." --- # Helm -Support for Helm in Zed is provided by the community-maintained [Helm extension](https://github.com/cabrinha/helm.zed). +Support for Helm in Gwen is provided by the community-maintained [Helm extension](https://github.com/cabrinha/helm.zed). - Tree-sitter: [tree-sitter-go-template](https://github.com/ngalaiko/tree-sitter-go-template/tree/master) - Language Server: [mrjosh/helm-ls](https://github.com/mrjosh/helm-ls) diff --git a/docs/src/languages/html.md b/docs/src/languages/html.md index adb19899bd..14603be20a 100644 --- a/docs/src/languages/html.md +++ b/docs/src/languages/html.md @@ -1,6 +1,6 @@ --- title: HTML -description: "Configure HTML language support in Zed, including language servers, formatting, and debugging." +description: "Configure HTML language support in Gwen, including language servers, formatting, and debugging." --- # HTML @@ -22,7 +22,7 @@ This extension is automatically installed, but if you do not want to use it, you ## Formatting -By default Zed uses [Prettier](https://prettier.io/) for formatting HTML. +By default Gwen uses [Prettier](https://prettier.io/) for formatting HTML. Configure formatting in Settings ({#kb zed::OpenSettings}) under Languages > HTML, or add to your settings file: @@ -48,7 +48,7 @@ To use the `vscode-html-language-server` language server auto-formatting instead } ``` -You can customize various [formatting options](https://code.visualstudio.com/docs/languages/html#_formatting) for `vscode-html-language-server` via your Zed `settings.json`: +You can customize various [formatting options](https://code.visualstudio.com/docs/languages/html#_formatting) for `vscode-html-language-server` via your Gwen `settings.json`: ```json [settings] "lsp": { diff --git a/docs/src/languages/java.md b/docs/src/languages/java.md index a9bc465e2e..3226a9b420 100644 --- a/docs/src/languages/java.md +++ b/docs/src/languages/java.md @@ -1,13 +1,13 @@ --- title: Java -description: "Configure Java language support in Zed, including language servers, formatting, and debugging." +description: "Configure Java language support in Gwen, including language servers, formatting, and debugging." --- # Java -Java language support in Zed is provided by: +Java language support in Gwen is provided by: -- Zed Java: [zed-extensions/java](https://github.com/zed-extensions/java) +- Gwen Java: [zed-extensions/java](https://github.com/zed-extensions/java) - Tree-sitter: [tree-sitter/tree-sitter-java](https://github.com/tree-sitter/tree-sitter-java) - Language Server: [eclipse-jdtls/eclipse.jdt.ls](https://github.com/eclipse-jdtls/eclipse.jdt.ls) @@ -30,7 +30,7 @@ You can install by opening {#action zed::Extensions}({#kb zed::Extensions}) and For the majority of users, Java support should work out of the box. -- It is generally recommended to open projects with the Zed-project root at the Java project root folder (where you would commonly have your `pom.xml` or `build.gradle` file). +- It is generally recommended to open projects with the Gwen-project root at the Java project root folder (where you would commonly have your `pom.xml` or `build.gradle` file). - By default the extension will download and run the latest official version of JDTLS for you, but this requires Java version 21 to be available on your system via either the `$JAVA_HOME` environment variable or as a `java(.exe)` executable on your `$PATH`. If your project requires a lower Java version in the environment, you can specify a different JDK to use for running JDTLS via the `java_home` configuration option. @@ -55,7 +55,7 @@ Here is a common `settings.json` including the above mentioned configurations: ## Debugging -Debug support is enabled via our [Fork of Java Debug](https://github.com/zed-industries/java-debug), which the extension will automatically download and start for you. Please refer to the [Debugger Documentation](https://zed.dev/docs/debugger#getting-started) for general information about how debugging works in Zed. +Debug support is enabled via our [Fork of Java Debug](https://github.com/zed-industries/java-debug), which the extension will automatically download and start for you. Please refer to the [Debugger Documentation](https://zed.dev/docs/debugger#getting-started) for general information about how debugging works in Gwen. To get started with Java, click the `edit debug.json` button in the Debug menu, and replace the contents of the file with the following: @@ -80,9 +80,9 @@ You should then be able to start a new Debug Session with the "Launch Debugger" ## Launch Scripts (aka Tasks) in Windows -This extension provides tasks for running your application and tests from within Zed via little play buttons next to tests/entry points. However, due to current limitations of Zed's extension interface, we can not provide scripts that will work across Maven and Gradle on both Windows and Unix-compatible systems, so out of the box the launch scripts only work on Mac and Linux. +This extension provides tasks for running your application and tests from within Gwen via little play buttons next to tests/entry points. However, due to current limitations of Gwen's extension interface, we can not provide scripts that will work across Maven and Gradle on both Windows and Unix-compatible systems, so out of the box the launch scripts only work on Mac and Linux. -There is a fairly straightforward fix that you can apply to make it work on Windows by supplying your own task scripts. Please see [this Issue](https://github.com/zed-extensions/java/issues/94) for information on how to do that and read the [Tasks section in Zed's documentation](https://zed.dev/docs/tasks) for more information. +There is a fairly straightforward fix that you can apply to make it work on Windows by supplying your own task scripts. Please see [this Issue](https://github.com/zed-extensions/java/issues/94) for information on how to do that and read the [Tasks section in Gwen's documentation](https://zed.dev/docs/tasks) for more information. ## Advanced Configuration/JDTLS initialization Options @@ -96,7 +96,7 @@ JDTLS provides many configuration options that can be passed via the `initialize // this will be sent to JDTLS as initializationOptions: "initialization_options": { "bundles": [], - // use this if your zed project root folder is not the same as the java project root: + // use this if your Gwen project root folder is not the same as the java project root: "workspaceFolders": ["file:///home/snjeza/Project"], "settings": { "java": { @@ -168,5 +168,5 @@ JDTLS provides many configuration options that can be passed via the `initialize ## See also -[Zed Java Repo](https://github.com/zed-extensions/java) +[Gwen Java Repo](https://github.com/zed-extensions/java) [Eclipse JDTLS Repo](https://github.com/eclipse-jdtls/eclipse.jdt.ls) diff --git a/docs/src/languages/javascript.md b/docs/src/languages/javascript.md index 54d320b1a7..c0d42057bb 100644 --- a/docs/src/languages/javascript.md +++ b/docs/src/languages/javascript.md @@ -1,11 +1,11 @@ --- title: JavaScript -description: "Configure JavaScript language support in Zed, including language servers, formatting, and debugging." +description: "Configure JavaScript language support in Gwen, including language servers, formatting, and debugging." --- # JavaScript -JavaScript support is available natively in Zed. +JavaScript support is available natively in Gwen. - Tree-sitter: [tree-sitter/tree-sitter-javascript](https://github.com/tree-sitter/tree-sitter-javascript) - Language Server: [yioneko/vtsls](https://github.com/yioneko/vtsls) @@ -56,18 +56,18 @@ Configure formatting in Settings ({#kb zed::OpenSettings}) under Languages > Jav ## JSX -Zed supports JSX syntax highlighting out of the box. +Gwen supports JSX syntax highlighting out of the box. In JSX strings, the [`tailwindcss-language-server`](./tailwindcss.md) is used to provide autocompletion for Tailwind CSS classes. ## JSDoc -Zed supports JSDoc syntax in JavaScript and TypeScript comments that match the JSDoc syntax. -Zed uses [tree-sitter/tree-sitter-jsdoc](https://github.com/tree-sitter/tree-sitter-jsdoc) for parsing and highlighting JSDoc. +Gwen supports JSDoc syntax in JavaScript and TypeScript comments that match the JSDoc syntax. +Gwen uses [tree-sitter/tree-sitter-jsdoc](https://github.com/tree-sitter/tree-sitter-jsdoc) for parsing and highlighting JSDoc. ## ESLint -You can configure Zed to format code using `eslint --fix` by running the ESLint code action when formatting. +You can configure Gwen to format code using `eslint --fix` by running the ESLint code action when formatting. Configure code actions on format in Settings ({#kb zed::OpenSettings}) under Languages > JavaScript, or add to your settings file: @@ -231,7 +231,7 @@ To get all the features (autocomplete, linting, etc.) from the [Tailwind CSS lan ## Debugging -Zed supports debugging JavaScript code out of the box with `vscode-js-debug`. +Gwen supports debugging JavaScript code out of the box with `vscode-js-debug`. The following can be debugged without writing additional configuration: - Tasks from `package.json` @@ -243,7 +243,7 @@ Run {#action debugger::Start} ({#kb debugger::Start}) to see a contextual list o > **Note:** Node test is automatically detected when `@types/node` is present in `package.json` (requires Node.js 20+). -As for all languages, configurations from `.vscode/launch.json` are also available for debugging in Zed. +As for all languages, configurations from `.vscode/launch.json` are also available for debugging in Gwen. If your use-case isn't covered by any of these, you can take full control by adding debug configurations to `.zed/debug.json`. See below for example configurations. diff --git a/docs/src/languages/json.md b/docs/src/languages/json.md index dcede99240..56a440690b 100644 --- a/docs/src/languages/json.md +++ b/docs/src/languages/json.md @@ -1,23 +1,23 @@ --- title: JSON -description: "Configure JSON language support in Zed, including language servers, formatting, and debugging." +description: "Configure JSON language support in Gwen, including language servers, formatting, and debugging." --- # JSON -JSON support is available natively in Zed. +JSON support is available natively in Gwen. - Tree-sitter: [tree-sitter/tree-sitter-json](https://github.com/tree-sitter/tree-sitter-json) - Language Server: [zed-industries/json-language-server](https://github.com/zed-industries/json-language-server) ## JSONC -Zed also supports a super-set of JSON called JSONC, which allows single line comments (`//`) in JSON files. +Gwen also supports a super-set of JSON called JSONC, which allows single line comments (`//`) in JSON files. While editing these files you can use `cmd-/` (macOS) or `ctrl-/` (Linux) to toggle comments on the current line or selection. ## JSONC Prettier Formatting -If you use files with the `*.jsonc` extension when using `Format Document` or have `format_on_save` enabled, Zed invokes Prettier as the formatter. Prettier has an [outstanding issue](https://github.com/prettier/prettier/issues/15956) where it will add trailing commas to files with a `jsonc` extension. JSONC files which have a `.json` extension are unaffected. +If you use files with the `*.jsonc` extension when using `Format Document` or have `format_on_save` enabled, Gwen invokes Prettier as the formatter. Prettier has an [outstanding issue](https://github.com/prettier/prettier/issues/15956) where it will add trailing commas to files with a `jsonc` extension. JSONC files which have a `.json` extension are unaffected. To workaround this behavior you can add the following to your `.prettierrc` configuration file: @@ -37,7 +37,7 @@ To workaround this behavior you can add the following to your `.prettierrc` conf ## JSON Language Server -Zed automatically out of the box supports JSON Schema validation of `package.json` and `tsconfig.json` files, but `json-language-server` can use JSON Schema definitions in project files, from the [JSON Schema Store](https://www.schemastore.org) or other publicly available URLs for JSON validation. +Gwen automatically out of the box supports JSON Schema validation of `package.json` and `tsconfig.json` files, but `json-language-server` can use JSON Schema definitions in project files, from the [JSON Schema Store](https://www.schemastore.org) or other publicly available URLs for JSON validation. ### Inline Schema Specification @@ -54,7 +54,7 @@ For example, for a `.luarc.json` for use with [lua-language-server](https://gith ### Schema Specification via Settings -You can associate JSON Schemas with file paths using relative paths in your language server settings. Zed resolves paths relative to your project root: +You can associate JSON Schemas with file paths using relative paths in your language server settings. Gwen resolves paths relative to your project root: ```json [settings] "lsp": { @@ -83,7 +83,7 @@ You can associate JSON Schemas with file paths using relative paths in your lang Paths starting with `./` resolve relative to the worktree root. Paths starting with `~/` expand to your home directory. -You can also pass any of the [supported settings](https://github.com/Microsoft/vscode/blob/main/extensions/json-language-features/server/README.md#settings) to json-language-server by specifying them in your Zed settings.json: +You can also pass any of the [supported settings](https://github.com/Microsoft/vscode/blob/main/extensions/json-language-features/server/README.md#settings) to json-language-server by specifying them in your Gwen settings.json: @@ -66,11 +66,11 @@ A `true` setting will set the target directory to `target/rust-analyzer`. You ca ## Binary -You can configure which `rust-analyzer` binary Zed should use. +You can configure which `rust-analyzer` binary Gwen should use. -By default, Zed will try to find a `rust-analyzer` in your `$PATH` and try to use that. If that binary successfully executes `rust-analyzer --help`, it's used. Otherwise, Zed will fall back to installing its own stable `rust-analyzer` version and use that. +By default, Gwen will try to find a `rust-analyzer` in your `$PATH` and try to use that. If that binary successfully executes `rust-analyzer --help`, it's used. Otherwise, Gwen will fall back to installing its own stable `rust-analyzer` version and use that. -If you want to install a pre-release `rust-analyzer` version instead, you can instruct Zed to do so by setting `pre_release` to `true` in your `settings.json`: +If you want to install a pre-release `rust-analyzer` version instead, you can instruct Gwen to do so by setting `pre_release` to `true` in your `settings.json`: ```json [settings] { @@ -84,7 +84,7 @@ If you want to install a pre-release `rust-analyzer` version instead, you can in } ``` -If you want to disable Zed looking for a `rust-analyzer` binary, you can set `ignore_system_version` to `true` in your `settings.json`: +If you want to disable Gwen looking for a `rust-analyzer` binary, you can set `ignore_system_version` to `true` in your `settings.json`: ```json [settings] { @@ -117,7 +117,7 @@ This `"path"` has to be an absolute path. ## Alternate Targets -If you want rust-analyzer to provide diagnostics for a target other than your current platform (e.g. for windows when running on macOS) you can use the following Zed lsp settings: +If you want rust-analyzer to provide diagnostics for a target other than your current platform (e.g. for windows when running on macOS) you can use the following Gwen lsp settings: ```json [settings] { @@ -141,7 +141,7 @@ rustup target list --installed ## LSP tasks -Zed provides tasks using tree-sitter, but rust-analyzer has an LSP extension method for querying file-related tasks via LSP. +Gwen provides tasks using tree-sitter, but rust-analyzer has an LSP extension method for querying file-related tasks via LSP. This is enabled by default and can be configured as ```json [settings] @@ -164,7 +164,7 @@ TBD: Is it possible to specify RUSTFLAGS? https://github.com/zed-industries/zed/ --> The Rust-analyzer [manual](https://rust-analyzer.github.io/book/) describes various features and configuration options for the rust-analyzer language server. -Rust-analyzer in Zed runs with the default parameters. +Rust-analyzer in Gwen runs with the default parameters. ### Large projects and performance @@ -185,16 +185,16 @@ rust-analyzer.cargo.allTargets (default: true) Pass --all-targets to cargo invocation ``` -Which would mean that every time Zed saves, a `cargo check --workspace --all-targets` command is run, checking the entire project (workspace), lib, doc, test, bin, bench and [other targets](https://doc.rust-lang.org/cargo/reference/cargo-targets.html). +Which would mean that every time Gwen saves, a `cargo check --workspace --all-targets` command is run, checking the entire project (workspace), lib, doc, test, bin, bench and [other targets](https://doc.rust-lang.org/cargo/reference/cargo-targets.html). While that works fine on small projects, it does not scale well. -The alternatives would be to use [tasks](../tasks.md), as Zed already provides a `cargo check --workspace --all-targets` task and the ability to cmd/ctrl-click on the terminal output to navigate to the error, and limit or turn off the check on save feature entirely. +The alternatives would be to use [tasks](../tasks.md), as Gwen already provides a `cargo check --workspace --all-targets` task and the ability to cmd/ctrl-click on the terminal output to navigate to the error, and limit or turn off the check on save feature entirely. Check on save feature is responsible for returning part of the diagnostics based on cargo check output, so turning it off will limit rust-analyzer with its own [diagnostics](https://rust-analyzer.github.io/book/diagnostics.html). Consider more `rust-analyzer.cargo.` and `rust-analyzer.check.` and `rust-analyzer.diagnostics.` settings from the manual for more fine-grained configuration. -Here's a snippet for Zed settings.json (the language server will restart automatically after the `lsp.rust-analyzer` section is edited and saved): +Here's a snippet for Gwen settings.json (the language server will restart automatically after the `lsp.rust-analyzer` section is edited and saved): ```json [settings] { @@ -299,7 +299,7 @@ There's a way to get custom completion items from rust-analyzer, that will trans ## Debugging -Zed supports debugging Rust binaries and tests out of the box with `CodeLLDB` and `GDB`. Run {#action debugger::Start} ({#kb debugger::Start}) to launch one of these preconfigured debug tasks. +Gwen supports debugging Rust binaries and tests out of the box with `CodeLLDB` and `GDB`. Run {#action debugger::Start} ({#kb debugger::Start}) to launch one of these preconfigured debug tasks. For more control, you can add debug configurations to `.zed/debug.json`. See the examples below. @@ -327,7 +327,7 @@ For more control, you can add debug configurations to `.zed/debug.json`. See the ### Automatically locate a debug target based on build command -When you use `cargo build` or `cargo test` as the build command, Zed can infer the path to the output binary. +When you use `cargo build` or `cargo test` as the build command, Gwen can infer the path to the output binary. ```json [debug] [ diff --git a/docs/src/languages/scala.md b/docs/src/languages/scala.md index d0b2b1f3e7..2e1cb6cd02 100644 --- a/docs/src/languages/scala.md +++ b/docs/src/languages/scala.md @@ -1,11 +1,11 @@ --- title: Scala -description: "Configure Scala language support in Zed, including language servers, formatting, and debugging." +description: "Configure Scala language support in Gwen, including language servers, formatting, and debugging." --- # Scala -Scala language support in Zed is provided by the community-maintained [Scala extension](https://github.com/scalameta/metals-zed). +Scala language support in Gwen is provided by the community-maintained [Scala extension](https://github.com/scalameta/metals-zed). Report issues to: [https://github.com/scalameta/metals-zed/issues](https://github.com/scalameta/metals-zed/issues) - Tree-sitter: [tree-sitter/tree-sitter-scala](https://github.com/tree-sitter/tree-sitter-scala) @@ -30,5 +30,5 @@ Behavior of the Metals language server can be controlled with: You can place these files in the root of your project or specify their location in the Metals configuration. See [Metals User Configuration](https://scalameta.org/metals/docs/editors/user-configuration) for more. diff --git a/docs/src/languages/scheme.md b/docs/src/languages/scheme.md index 975c09d94e..244f6e72a1 100644 --- a/docs/src/languages/scheme.md +++ b/docs/src/languages/scheme.md @@ -1,6 +1,6 @@ --- title: Scheme -description: "Configure Scheme language support in Zed, including language servers, formatting, and debugging." +description: "Configure Scheme language support in Gwen, including language servers, formatting, and debugging." --- # Scheme diff --git a/docs/src/languages/sh.md b/docs/src/languages/sh.md index b122274673..adb2b1b619 100644 --- a/docs/src/languages/sh.md +++ b/docs/src/languages/sh.md @@ -1,11 +1,11 @@ --- title: Shell Script -description: "Configure Shell Script language support in Zed, including language servers, formatting, and debugging." +description: "Configure Shell Script language support in Gwen, including language servers, formatting, and debugging." --- # Shell Scripts -Shell Scripts (bash, zsh, dash, sh) are supported natively by Zed. +Shell Scripts (bash, zsh, dash, sh) are supported natively by Gwen. - Tree-sitter: [tree-sitter/tree-sitter-bash](https://github.com/tree-sitter/tree-sitter-bash) @@ -24,7 +24,7 @@ Configure settings in Settings ({#kb zed::OpenSettings}) under Languages > Shell ### Formatting -Zed supports auto-formatting Shell Scripts using external tools like [`shfmt`](https://github.com/mvdan/sh). +Gwen supports auto-formatting Shell Scripts using external tools like [`shfmt`](https://github.com/mvdan/sh). 1. Install `shfmt`: @@ -63,5 +63,5 @@ shfmt --version ## See also: -- [Zed Docs: Language Support: Bash](./bash.md) -- [Zed Docs: Language Support: Fish](./fish.md) +- [Gwen Docs: Language Support: Bash](./bash.md) +- [Gwen Docs: Language Support: Fish](./fish.md) diff --git a/docs/src/languages/sml.md b/docs/src/languages/sml.md index 4edb306dcf..17b9a2d6de 100644 --- a/docs/src/languages/sml.md +++ b/docs/src/languages/sml.md @@ -1,6 +1,6 @@ --- title: Standard ML -description: "Configure Standard ML language support in Zed, including language servers, formatting, and debugging." +description: "Configure Standard ML language support in Gwen, including language servers, formatting, and debugging." --- # Standard ML @@ -17,7 +17,7 @@ Standard ML support is available through the community-maintained [Standard ML e ## Project setup -For projects with more than one source file, Millet expects a single root group file. Create a `millet.toml` in the directory you open in Zed: +For projects with more than one source file, Millet expects a single root group file. Create a `millet.toml` in the directory you open in Gwen: ```toml version = 1 diff --git a/docs/src/languages/sql.md b/docs/src/languages/sql.md index 693b5de55e..c84633b8b1 100644 --- a/docs/src/languages/sql.md +++ b/docs/src/languages/sql.md @@ -1,6 +1,6 @@ --- title: SQL -description: "Configure SQL language support in Zed, including language servers, formatting, and debugging." +description: "Configure SQL language support in Gwen, including language servers, formatting, and debugging." --- # SQL @@ -11,7 +11,7 @@ SQL files are handled by the [SQL Extension](https://github.com/zed-extensions/s ### Formatting -Zed supports auto-formatting SQL using external tools like [`sql-formatter`](https://github.com/sql-formatter-org/sql-formatter). +Gwen supports auto-formatting SQL using external tools like [`sql-formatter`](https://github.com/sql-formatter-org/sql-formatter). 1. Install `sql-formatter`: @@ -43,7 +43,7 @@ sql-formatter --version Substitute your preferred [SQL Dialect] for `mysql` above (`duckdb`, `hive`, `mariadb`, `postgresql`, `redshift`, `snowflake`, `sqlite`, `spark`, etc). -You can add this to Zed project settings (`.zed/settings.json`) or via your Zed user settings (`~/.config/zed/settings.json`). +You can add this to Gwen project settings (`.zed/settings.json`) or via your Gwen user settings (`~/.config/gwen/settings.json`). ### Advanced Formatting @@ -58,7 +58,7 @@ Sql-formatter also allows more precise control by providing [sql-formatter confi } ``` -When using a `.sql-formatter.json` file you can use a simplified Zed settings configuration: +When using a `.sql-formatter.json` file you can use a simplified Gwen settings configuration: ```json [settings] { diff --git a/docs/src/languages/svelte.md b/docs/src/languages/svelte.md index 3d8c03d4bd..6aecd670b8 100644 --- a/docs/src/languages/svelte.md +++ b/docs/src/languages/svelte.md @@ -1,6 +1,6 @@ --- title: Svelte -description: "Configure Svelte language support in Zed, including language servers, formatting, and debugging." +description: "Configure Svelte language support in Gwen, including language servers, formatting, and debugging." --- # Svelte @@ -29,7 +29,7 @@ You can modify how certain styles, such as directives and modifiers, appear in a ## Inlay Hints -When inlay hints are enabled in Zed, to make the language server send them back, Zed sets the following initialization options: +When inlay hints are enabled in Gwen, to make the language server send them back, Gwen sets the following initialization options: ```json "inlayHints": { diff --git a/docs/src/languages/swift.md b/docs/src/languages/swift.md index b53b0744b9..89f1a4e7ea 100644 --- a/docs/src/languages/swift.md +++ b/docs/src/languages/swift.md @@ -1,11 +1,11 @@ --- title: Swift -description: "Configure Swift language support in Zed, including language servers, formatting, and debugging." +description: "Configure Swift language support in Gwen, including language servers, formatting, and debugging." --- # Swift -Swift language support in Zed is provided by the community-maintained [Swift extension](https://github.com/zed-extensions/swift). +Swift language support in Gwen is provided by the community-maintained [Swift extension](https://github.com/zed-extensions/swift). Report issues to: [https://github.com/zed-extensions/swift/issues](https://github.com/zed-extensions/swift/issues) - Tree-sitter: [alex-pinkus/tree-sitter-swift](https://github.com/alex-pinkus/tree-sitter-swift) @@ -19,7 +19,7 @@ You can modify the behavior of SourceKit LSP by creating a `.sourcekit-lsp/confi ## Debugging The Swift extension provides a debug adapter for debugging Swift code. -Zed's name for the adapter (in the UI and `debug.json`) is `Swift`, and under the hood it uses [`lldb-dap`](https://github.com/swiftlang/llvm-project/blob/next/lldb/tools/lldb-dap/README.md), as provided by the Swift toolchain. +Gwen's name for the adapter (in the UI and `debug.json`) is `Swift`, and under the hood it uses [`lldb-dap`](https://github.com/swiftlang/llvm-project/blob/next/lldb/tools/lldb-dap/README.md), as provided by the Swift toolchain. The extension tries to find an `lldb-dap` binary using `swiftly`, using `xcrun`, and by searching `$PATH`, in that order of preference. The extension doesn't attempt to download `lldb-dap` if it's not found. diff --git a/docs/src/languages/tailwindcss.md b/docs/src/languages/tailwindcss.md index 2c95d85a6c..bcc4b17563 100644 --- a/docs/src/languages/tailwindcss.md +++ b/docs/src/languages/tailwindcss.md @@ -1,15 +1,15 @@ --- title: Tailwind CSS -description: "Configure Tailwind CSS language support in Zed, including language servers, formatting, and debugging." +description: "Configure Tailwind CSS language support in Gwen, including language servers, formatting, and debugging." --- # Tailwind CSS -Zed has built-in support for Tailwind CSS autocomplete, linting, and hover previews. +Gwen has built-in support for Tailwind CSS autocomplete, linting, and hover previews. - Language Server: [tailwindlabs/tailwindcss-intellisense](https://github.com/tailwindlabs/tailwindcss-intellisense) -Languages which can be used with Tailwind CSS in Zed: +Languages which can be used with Tailwind CSS in Gwen: - [Astro](./astro.md#using-the-tailwind-css-language-server-with-astro) - [CSS](./css.md) @@ -47,7 +47,7 @@ Refer to [the Tailwind CSS language server settings docs](https://github.com/tai ### Using Tailwind CSS Mode in CSS Files -Zed includes support for the Tailwind CSS language mode, which provides full CSS IntelliSense support even when using Tailwind-specific at-rules like `@apply`, `@layer`, and `@theme`. +Gwen includes support for the Tailwind CSS language mode, which provides full CSS IntelliSense support even when using Tailwind-specific at-rules like `@apply`, `@layer`, and `@theme`. Configure language servers in Settings ({#kb zed::OpenSettings}) under Languages > CSS, or add to your settings file: ```json [settings] @@ -68,7 +68,7 @@ The `tailwindcss-intellisense-css` language server serves as an alternative to t ### Prettier Plugin -Zed supports Prettier out of the box, which means that if you have the [Tailwind CSS Prettier plugin](https://github.com/tailwindlabs/prettier-plugin-tailwindcss) installed, adding it to your Prettier configuration will make it work automatically: +Gwen supports Prettier out of the box, which means that if you have the [Tailwind CSS Prettier plugin](https://github.com/tailwindlabs/prettier-plugin-tailwindcss) installed, adding it to your Prettier configuration will make it work automatically: ```json // .prettierrc diff --git a/docs/src/languages/terraform.md b/docs/src/languages/terraform.md index a7e12b6818..289eb0bb5f 100644 --- a/docs/src/languages/terraform.md +++ b/docs/src/languages/terraform.md @@ -1,6 +1,6 @@ --- title: Terraform -description: "Configure Terraform language support in Zed, including language servers, formatting, and debugging." +description: "Configure Terraform language support in Gwen, including language servers, formatting, and debugging." --- # Terraform diff --git a/docs/src/languages/toml.md b/docs/src/languages/toml.md index df4f2cb948..ffb584006f 100644 --- a/docs/src/languages/toml.md +++ b/docs/src/languages/toml.md @@ -1,6 +1,6 @@ --- title: TOML -description: "Configure TOML language support in Zed, including language servers, formatting, and debugging." +description: "Configure TOML language support in Gwen, including language servers, formatting, and debugging." --- # TOML diff --git a/docs/src/languages/typescript.md b/docs/src/languages/typescript.md index 0262129a60..bb8ad9f15a 100644 --- a/docs/src/languages/typescript.md +++ b/docs/src/languages/typescript.md @@ -1,11 +1,11 @@ --- title: TypeScript -description: "Configure TypeScript language support in Zed, including language servers, formatting, and debugging." +description: "Configure TypeScript language support in Gwen, including language servers, formatting, and debugging." --- # TypeScript -TypeScript and TSX support are available natively in Zed. +TypeScript and TSX support are available natively in Gwen. - Tree-sitter: [tree-sitter/tree-sitter-typescript](https://github.com/tree-sitter/tree-sitter-typescript) - Language Server: [yioneko/vtsls](https://github.com/yioneko/vtsls) @@ -18,7 +18,7 @@ TBD: Document the difference between Language servers ## Language servers -By default Zed uses [vtsls](https://github.com/yioneko/vtsls) for TypeScript, TSX, and JavaScript files. +By default Gwen uses [vtsls](https://github.com/yioneko/vtsls) for TypeScript, TSX, and JavaScript files. Configure language servers in Settings ({#kb zed::OpenSettings}) under Languages > TypeScript/TSX/JavaScript, or add to your settings file: ```json [settings] @@ -99,9 +99,9 @@ To get all the features (autocomplete, linting, etc.) from the [Tailwind CSS lan ## Inlay Hints -Zed sets the following initialization options to make the language server send back inlay hints (that is, when Zed has inlay hints enabled in the settings). +Gwen sets the following initialization options to make the language server send back inlay hints (that is, when Gwen has inlay hints enabled in the settings). -You can override these settings in your Zed `settings.json` when using `typescript-language-server`: +You can override these settings in your Gwen `settings.json` when using `typescript-language-server`: ```json [settings] { @@ -191,7 +191,7 @@ When using `vtsls`: ## Code Lens -Zed enables references and implementations code lenses for `vtsls` by default. These show reference counts and implementation counts above functions, classes, and interfaces. To use them, enable the `code_lens` setting: +Gwen enables references and implementations code lenses for `vtsls` by default. These show reference counts and implementation counts above functions, classes, and interfaces. To use them, enable the `code_lens` setting: ```json [settings] { @@ -236,7 +236,7 @@ You can override the default code lens settings in your `settings.json`: ## Debugging -Zed supports debugging TypeScript code out of the box with `vscode-js-debug`. +Gwen supports debugging TypeScript code out of the box with `vscode-js-debug`. The following can be debugged without writing additional configuration: - Tasks from `package.json` @@ -248,7 +248,7 @@ Run {#action debugger::Start} ({#kb debugger::Start}) to see a contextual list o > **Note:** Node test is automatically detected when `@types/node` is present in `package.json` (requires Node.js 20+). -As for all languages, configurations from `.vscode/launch.json` are also available for debugging in Zed. +As for all languages, configurations from `.vscode/launch.json` are also available for debugging in Gwen. If your use-case isn't covered by any of these, you can take full control by adding debug configurations to `.zed/debug.json`. See below for example configurations. @@ -283,5 +283,5 @@ Given an externally-run web server (e.g., with `npx serve` or `npx live-server`) ## See also -- [Zed Yarn documentation](./yarn.md) for a walkthrough of configuring your project to use Yarn. -- [Zed Deno documentation](./deno.md) +- [Gwen Yarn documentation](./yarn.md) for a walkthrough of configuring your project to use Yarn. +- [Gwen Deno documentation](./deno.md) diff --git a/docs/src/languages/uiua.md b/docs/src/languages/uiua.md index 889c57e619..d70e6f43c4 100644 --- a/docs/src/languages/uiua.md +++ b/docs/src/languages/uiua.md @@ -1,6 +1,6 @@ --- title: Uiua -description: "Configure Uiua language support in Zed, including language servers, formatting, and debugging." +description: "Configure Uiua language support in Gwen, including language servers, formatting, and debugging." --- # Uiua diff --git a/docs/src/languages/vue.md b/docs/src/languages/vue.md index 3c2336119d..aea0fe453b 100644 --- a/docs/src/languages/vue.md +++ b/docs/src/languages/vue.md @@ -1,6 +1,6 @@ --- title: Vue -description: "Configure Vue language support in Zed, including language servers, formatting, and debugging." +description: "Configure Vue language support in Gwen, including language servers, formatting, and debugging." --- # Vue @@ -19,7 +19,7 @@ the TypeScript SDK inside that directory. This may not always be true; for example, when working in a project that uses Yarn PnP, there is no `node_modules`. For editor support, the [documented](https://yarnpkg.com/getting-started/editor-sdks) approach is to run something like -`yarn dlx @yarnpkg/sdks`. In that case, you can provide the following initialization options in your Zed settings: +`yarn dlx @yarnpkg/sdks`. In that case, you can provide the following initialization options in your Gwen settings: ```json { diff --git a/docs/src/languages/xml.md b/docs/src/languages/xml.md index 250657b3bb..831ead0996 100644 --- a/docs/src/languages/xml.md +++ b/docs/src/languages/xml.md @@ -1,6 +1,6 @@ --- title: XML -description: "Configure XML language support in Zed, including language servers, formatting, and debugging." +description: "Configure XML language support in Gwen, including language servers, formatting, and debugging." --- # XML @@ -11,7 +11,7 @@ XML support is available through the [XML extension](https://github.com/sweetppr ## Configuration -If you have additional file extensions that are not being automatically recognized as XML just add them to [file_types](../reference/all-settings.md#file-types) in your Zed settings: +If you have additional file extensions that are not being automatically recognized as XML just add them to [file_types](../reference/all-settings.md#file-types) in your Gwen settings: ```json [settings] "file_types": { diff --git a/docs/src/languages/yaml.md b/docs/src/languages/yaml.md index b82e14d64b..c9b01ef750 100644 --- a/docs/src/languages/yaml.md +++ b/docs/src/languages/yaml.md @@ -1,20 +1,20 @@ --- title: YAML -description: "Configure YAML language support in Zed, including language servers, formatting, and debugging." +description: "Configure YAML language support in Gwen, including language servers, formatting, and debugging." --- # YAML -YAML support is available natively in Zed. +YAML support is available natively in Gwen. - Tree-sitter: [zed-industries/tree-sitter-yaml](https://github.com/zed-industries/tree-sitter-yaml) - Language Server: [redhat-developer/yaml-language-server](https://github.com/redhat-developer/yaml-language-server) ## Configuration -You can configure various [yaml-language-server settings](https://github.com/redhat-developer/yaml-language-server?tab=readme-ov-file#language-server-settings) by adding them to your Zed settings.json in a `yaml-language-server` block under the `lsp` key. +You can configure various [yaml-language-server settings](https://github.com/redhat-developer/yaml-language-server?tab=readme-ov-file#language-server-settings) by adding them to your Gwen settings.json in a `yaml-language-server` block under the `lsp` key. -You can configure custom YAML schemas using relative paths. Zed resolves paths relative to your project root: +You can configure custom YAML schemas using relative paths. Gwen resolves paths relative to your project root: ```json [settings] "lsp": { @@ -42,7 +42,7 @@ Note, settings keys must be nested, so `yaml.keyOrdering` becomes `{"yaml": { "k ## Formatting -By default, Zed uses Prettier for formatting YAML files. +By default, Gwen uses Prettier for formatting YAML files. ### Prettier Formatting diff --git a/docs/src/languages/yara.md b/docs/src/languages/yara.md index a1487a7ddb..351a1d9a14 100644 --- a/docs/src/languages/yara.md +++ b/docs/src/languages/yara.md @@ -1,6 +1,6 @@ --- title: YARA -description: "Configure YARA language support in Zed, including language servers, formatting, and debugging." +description: "Configure YARA language support in Gwen, including language servers, formatting, and debugging." --- # YARA diff --git a/docs/src/languages/yarn.md b/docs/src/languages/yarn.md index 399d8bdd9d..78dee02796 100644 --- a/docs/src/languages/yarn.md +++ b/docs/src/languages/yarn.md @@ -1,6 +1,6 @@ --- title: Yarn -description: "Configure Yarn language support in Zed, including language servers, formatting, and debugging." +description: "Configure Yarn language support in Gwen, including language servers, formatting, and debugging." --- # Yarn diff --git a/docs/src/languages/zig.md b/docs/src/languages/zig.md index 666b21253f..358c5d7df1 100644 --- a/docs/src/languages/zig.md +++ b/docs/src/languages/zig.md @@ -1,6 +1,6 @@ --- title: Zig -description: "Configure Zig language support in Zed, including language servers, formatting, and debugging." +description: "Configure Zig language support in Gwen, including language servers, formatting, and debugging." --- # Zig diff --git a/docs/src/linux.md b/docs/src/linux.md index 9c4871bc24..4235dc5a50 100644 --- a/docs/src/linux.md +++ b/docs/src/linux.md @@ -1,25 +1,25 @@ --- -title: Zed on Linux -description: "The installation script on the download page is the fastest way to install Zed:" +title: Gwen on Linux +description: "The installation script on the download page is the fastest way to install Gwen:" --- -# Zed on Linux +# Gwen on Linux ## Standard Installation -The installation script on the [download](https://zed.dev/download) page is the fastest way to install Zed: +The installation script on the [download](https://zed.dev/download) page is the fastest way to install Gwen: ```sh curl -f https://zed.dev/install.sh | sh ``` -We also offer a preview build of Zed which receives updates about a week ahead of stable. You can install it with: +We also offer a preview build of Gwen which receives updates about a week ahead of stable. You can install it with: ```sh curl -f https://zed.dev/install.sh | ZED_CHANNEL=preview sh ``` -The Zed installed by the script works best on systems that: +The Gwen installed by the script works best on systems that: - have a Vulkan compatible GPU available (for example Linux on an M-series MacBook) - have a system-wide glibc @@ -34,9 +34,9 @@ You will need to build from source for: - Redhat Enterprise Linux 8.x, Rocky Linux 8, AlmaLinux 8, Amazon Linux 2 on all architectures - Redhat Enterprise Linux 9.x, Rocky Linux 9.3, AlmaLinux 8, Amazon Linux 2023 on aarch64 (x86_x64 OK) -## Other ways to install Zed on Linux +## Other ways to install Gwen on Linux -Zed is open source, and [you can install from source](./development/linux.md). +Gwen is open source, and [you can install from source](./development/linux.md). ### Installing via a package manager @@ -60,13 +60,13 @@ See [Repology](https://repology.org/project/zed-editor/versions) for a current l When installing a third-party package please be aware that it may not be completely up to date and may be slightly different from the Zed we package (a common change is to rename the binary to `zedit` or `zeditor` to avoid conflicting with other packages). -We'd love your help making Zed available for everyone. If Zed is not yet available for your package manager, and you would like to fix that, we have some notes on [how to do it](./development/linux.md#notes-for-packaging-zed). +We'd love your help making Gwen available for everyone. If Gwen is not yet available for your package manager, and you would like to fix that, we have some notes on [how to do it](./development/linux.md#notes-for-packaging-gwen). -The packages in this section provide binary installs for Zed but are not official packages within the associated distributions. These packages are maintained by community members and as such a higher level of caution should be taken when installing them. +The packages in this section provide binary installs for Gwen but are not official packages within the associated distributions. These packages are maintained by community members and as such a higher level of caution should be taken when installing them. ### Downloading manually -If you'd prefer, you can install Zed by downloading our pre-built .tar.gz. This is the same artifact that our install script uses, but you can customize the location of your installation by modifying the instructions below: +If you'd prefer, you can install Gwen by downloading our pre-built .tar.gz. This is the same artifact that our install script uses, but you can customize the location of your installation by modifying the instructions below: Download the `.tar.gz` file: @@ -75,73 +75,73 @@ Download the `.tar.gz` file: - [zed-linux-aarch64.tar.gz](https://cloud.zed.dev/releases/stable/latest/download?asset=zed&arch=aarch64&os=linux&source=docs) ([preview](https://cloud.zed.dev/releases/preview/latest/download?asset=zed&arch=aarch64&os=linux&source=docs)) -Then ensure that the `zed` binary in the tarball is on your path. The easiest way is to unpack the tarball and create a symlink: +Then ensure that the `gwen` binary in the tarball is on your path. The easiest way is to unpack the tarball and create a symlink: ```sh mkdir -p ~/.local -# extract zed to ~/.local/zed.app/ +# extract the Gwen tarball to ~/.local/gwen.app/ tar -xvf .tar.gz -C ~/.local -# link the zed binary to ~/.local/bin (or another directory in your $PATH) -ln -sf ~/.local/zed.app/bin/zed ~/.local/bin/zed +# link the gwen binary to ~/.local/bin (or another directory in your $PATH) +ln -sf ~/.local/gwen.app/bin/gwen ~/.local/bin/gwen ``` If you'd like integration with an XDG-compatible desktop environment, you will also need to install the `.desktop` file: ```sh -install -D ~/.local/zed.app/share/applications/dev.zed.Zed.desktop -t ~/.local/share/applications -sed -i "s|Icon=zed|Icon=$HOME/.local/zed.app/share/icons/hicolor/512x512/apps/zed.png|g" ~/.local/share/applications/dev.zed.Zed.desktop -sed -i "s|Exec=zed|Exec=$HOME/.local/zed.app/bin/zed|g" ~/.local/share/applications/dev.zed.Zed.desktop +install -D ~/.local/gwen.app/share/applications/com.yrkaierx.Gwen.desktop -t ~/.local/share/applications +sed -i "s|Icon=gwen|Icon=$HOME/.local/gwen.app/share/icons/hicolor/512x512/apps/gwen.png|g" ~/.local/share/applications/com.yrkaierx.Gwen.desktop +sed -i "s|Exec=gwen|Exec=$HOME/.local/gwen.app/bin/gwen|g" ~/.local/share/applications/com.yrkaierx.Gwen.desktop ``` -## Uninstalling Zed +## Uninstalling Gwen ### Standard Uninstall -If Zed was installed using the default installation script, it can be uninstalled by supplying the `--uninstall` flag to the `zed` shell command: +If Gwen was installed using the default installation script, it can be uninstalled by supplying the `--uninstall` flag to the `gwen` shell command: ```sh -zed --uninstall +gwen --uninstall ``` -Note that this will uninstall the Zed variant that the symlink points to. If you have multiple, parallel installations (such as both Stable and Preview), then you should instead use its absolute path as described further down in this section. +Note that this will uninstall the Gwen variant that the symlink points to. If you have multiple, parallel installations (such as both Stable and Preview), then you should instead use its absolute path as described further down in this section. -If there are no errors, the shell will then prompt you whether you'd like to keep your preferences or delete them. After making a choice, you should see a message that Zed was successfully uninstalled. +If there are no errors, the shell will then prompt you whether you'd like to keep your preferences or delete them. After making a choice, you should see a message that Gwen was successfully uninstalled. -In the case that the `zed` shell command was not found in your PATH, you can try one of the following commands: +In the case that the `gwen` shell command was not found in your PATH, you can try one of the following commands: ```sh -$HOME/.local/bin/zed --uninstall +$HOME/.local/bin/gwen --uninstall ``` or the absolute path to your installation, such as ```sh -$HOME/.local/zed.app/bin/zed --uninstall +$HOME/.local/gwen.app/bin/gwen --uninstall ``` -The first case might fail if a symlink was not properly established between `$HOME/.local/bin/zed` and `$HOME/.local/zed.app/bin/zed`, or if the symlink was overwritten by having parallel installations of different versions of Zed. But the second command should always work as long as Zed was installed to its default location. +The first case might fail if a symlink was not properly established between `$HOME/.local/bin/gwen` and `$HOME/.local/gwen.app/bin/gwen`, or if the symlink was overwritten by having parallel installations of different versions of Gwen. But the second command should always work as long as Gwen was installed to its default location. -If Zed was installed to a different location (such as the `zed-preview.app` variant), you must invoke the `zed` binary stored in that installation directory and pass the `--uninstall` flag to it in the same format as the previous commands. +If Gwen was installed to a different location (such as the `gwen-preview.app` variant), you must invoke the `gwen` binary stored in that installation directory and pass the `--uninstall` flag to it in the same format as the previous commands. ### Package Manager -If Zed was installed using a package manager, please consult the documentation for that package manager on how to uninstall a package. +If Gwen was installed using a package manager, please consult the documentation for that package manager on how to uninstall a package. ## Troubleshooting -Linux works on a large variety of systems configured in many different ways. We primarily test Zed on a vanilla Ubuntu setup, as it is the most common distribution our users use. That said, we do expect it to work on a wide variety of machines. +Linux works on a large variety of systems configured in many different ways. We primarily test Gwen on a vanilla Ubuntu setup, as it is the most common distribution our users use. That said, we do expect it to work on a wide variety of machines. -### Zed fails to start +### Gwen fails to start -If you see an error like "/lib64/libc.so.6: version 'GLIBC_2.29' not found" it means that your distribution's version of glibc is too old. You can either upgrade your system, or [install Zed from source](./development/linux.md). +If you see an error like "/lib64/libc.so.6: version 'GLIBC_2.29' not found" it means that your distribution's version of glibc is too old. You can either upgrade your system, or [install Gwen from source](./development/linux.md). ### Graphics issues -#### Zed fails to open windows +#### Gwen fails to open windows -Zed requires a GPU to run effectively. Under the hood, we use [Vulkan](https://www.vulkan.org/) to communicate with your GPU. If you are seeing problems with performance, or Zed fails to load, it is possible that Vulkan is the culprit. +Gwen requires a GPU to run effectively. Under the hood, we use [Vulkan](https://www.vulkan.org/) to communicate with your GPU. If you are seeing problems with performance, or Gwen fails to load, it is possible that Vulkan is the culprit. -If you see a notification saying `Zed failed to open a window: NoSupportedDeviceFound` this means that Vulkan cannot find a compatible GPU. You can try running [vkcube](https://github.com/krh/vkcube) (usually available as part of the `vulkaninfo` or `vulkan-tools` package on various distributions) to try to troubleshoot where the issue is coming from like so: +If you see a notification saying `Gwen failed to open a window: NoSupportedDeviceFound` this means that Vulkan cannot find a compatible GPU. You can try running [vkcube](https://github.com/krh/vkcube) (usually available as part of the `vulkaninfo` or `vulkan-tools` package on various distributions) to try to troubleshoot where the issue is coming from like so: ``` vkcube @@ -151,27 +151,27 @@ vkcube This should output a line describing your current graphics setup and show a rotating cube. If this does not work, you should be able to fix it by installing Vulkan compatible GPU drivers, however in some cases there is no Vulkan support yet. -You can find out which graphics card Zed is using by looking in the Zed log (`~/.local/share/zed/logs/Zed.log`) for `Using GPU: ...`. +You can find out which graphics card Gwen is using by looking in the Gwen log (`~/.local/share/gwen/logs/Gwen.log`) for `Using GPU: ...`. If you see errors like `ERROR_INITIALIZATION_FAILED` or `GPU Crashed` or `ERROR_SURFACE_LOST_KHR` then you may be able to work around this by installing different drivers for your GPU, or by selecting a different GPU to run on. (See [#14225](https://github.com/zed-industries/zed/issues/14225)) On some systems the file `/etc/prime-discrete` can be used to enforce the use of a discrete GPU using [PRIME](https://wiki.archlinux.org/title/PRIME). Depending on the details of your setup, you may need to change the contents of this file to "on" (to force discrete graphics) or "off" (to force integrated graphics). -On others, you may be able to set the environment variable `DRI_PRIME=1` when running Zed to force the use of the discrete GPU. +On others, you may be able to set the environment variable `DRI_PRIME=1` when running Gwen to force the use of the discrete GPU. If you're using an AMD GPU, you might get a 'Broken Pipe' error. Try using the RADV or Mesa drivers. (See [#13880](https://github.com/zed-industries/zed/issues/13880)) -If you are using `amdvlk`, the default open-source AMD graphics driver, you may find that Zed consistently fails to launch. This is a known issue for some users, for example on Omarchy (see issue [#28851](https://github.com/zed-industries/zed/issues/28851)). To fix this, you will need to use a different driver. We recommend removing the `amdvlk` and `lib32-amdvlk` packages and installing `vulkan-radeon` instead (see issue [#14141](https://github.com/zed-industries/zed/issues/14141)). +If you are using `amdvlk`, the default open-source AMD graphics driver, you may find that Gwen consistently fails to launch. This is a known issue for some users, for example on Omarchy (see issue [#28851](https://github.com/zed-industries/zed/issues/28851)). To fix this, you will need to use a different driver. We recommend removing the `amdvlk` and `lib32-amdvlk` packages and installing `vulkan-radeon` instead (see issue [#14141](https://github.com/zed-industries/zed/issues/14141)). For more information, the [Arch guide to Vulkan](https://wiki.archlinux.org/title/Vulkan) has some good steps that translate well to most distributions. -#### Forcing Zed to use a specific GPU +#### Forcing Gwen to use a specific GPU -There are a few different ways to force Zed to use a specific GPU: +There are a few different ways to force Gwen to use a specific GPU: ##### Option A -You can use the `ZED_DEVICE_ID={device_id}` environment variable to specify the device ID of the GPU you wish to have Zed use. +You can use the `ZED_DEVICE_ID={device_id}` environment variable to specify the device ID of the GPU you wish to have Gwen use. You can obtain the device ID of your GPU by running `lspci -nn | grep VGA` which will output each GPU on one line like: @@ -179,17 +179,17 @@ You can obtain the device ID of your GPU by running `lspci -nn | grep VGA` which 08:00.0 VGA compatible controller [0300]: NVIDIA Corporation GA104 [GeForce RTX 3070] [10de:2484] (rev a1) ``` -where the device ID here is `2484`. This value is in hexadecimal, so to force Zed to use this specific GPU you would set the environment variable like so: +where the device ID here is `2484`. This value is in hexadecimal, so to force Gwen to use this specific GPU you would set the environment variable like so: ``` -ZED_DEVICE_ID=0x2484 zed +ZED_DEVICE_ID=0x2484 gwen ``` Make sure to export the variable if you choose to define it globally in a `.bashrc` or similar. ##### Option B -If you are using Mesa, you can run `MESA_VK_DEVICE_SELECT=list zed --foreground` to get a list of available GPUs and then export `MESA_VK_DEVICE_SELECT=xxxx:yyyy` to choose a specific device. Furthermore, you can fallback to xwayland with an additional export of `WAYLAND_DISPLAY=""`. +If you are using Mesa, you can run `MESA_VK_DEVICE_SELECT=list gwen --foreground` to get a list of available GPUs and then export `MESA_VK_DEVICE_SELECT=xxxx:yyyy` to choose a specific device. Furthermore, you can fallback to xwayland with an additional export of `WAYLAND_DISPLAY=""`. ##### Option C @@ -197,28 +197,28 @@ Using [vkdevicechooser](https://github.com/jiriks74/vkdevicechooser). #### Reporting graphics issues -If Vulkan is configured correctly, and Zed is still not working for you, please [file an issue](https://github.com/zed-industries/zed) with as much information as possible. +If Vulkan is configured correctly, and Gwen is still not working for you, please [file an issue](https://github.com/zed-industries/zed) with as much information as possible. -When reporting issues where Zed fails to start due to graphics initialization errors on GitHub, it can be impossible to run the {#action zed::CopySystemSpecsIntoClipboard} command like we instruct you to in our issue template. We provide an alternative way to collect the system specs specifically for this situation. +When reporting issues where Gwen fails to start due to graphics initialization errors on GitHub, it can be impossible to run the {#action zed::CopySystemSpecsIntoClipboard} command like we instruct you to in our issue template. We provide an alternative way to collect the system specs specifically for this situation. -Passing the `--system-specs` flag to Zed like +Passing the `--system-specs` flag to Gwen like ```sh -zed --system-specs +gwen --system-specs ``` will print the system specs to the terminal like so. It is strongly recommended to copy the output verbatim into the issue on GitHub, as it uses markdown formatting to ensure the output is readable. -Additionally, it is extremely beneficial to provide the contents of your Zed log when reporting such issues. The log is usually located at `~/.local/share/zed/logs/Zed.log`. The recommended process for producing a helpful log file is as follows: +Additionally, it is extremely beneficial to provide the contents of your Gwen log when reporting such issues. The log is usually located at `~/.local/share/gwen/logs/Gwen.log`. The recommended process for producing a helpful log file is as follows: ```sh -truncate -s 0 ~/.local/share/zed/logs/Zed.log # Clear the log file -ZED_LOG=wgpu=info zed . -cat ~/.local/share/zed/logs/Zed.log +truncate -s 0 ~/.local/share/gwen/logs/Gwen.log # Clear the log file +ZED_LOG=wgpu=info gwen . +cat ~/.local/share/gwen/logs/Gwen.log # copy the output ``` -Or, if you have the Zed cli setup, you can do +Or, if you have the Gwen cli setup, you can do ```sh ZED_LOG=wgpu=info /path/to/zed/cli --foreground . @@ -230,10 +230,10 @@ It is also highly recommended when pasting the log into a github issue, to do so > **_Note_**: The whitespace in the template is important, and will cause incorrect formatting if not preserved. ```` -
Zed Log +
Gwen Log ``` -{zed log contents} +{gwen log contents} ```
@@ -252,31 +252,31 @@ These features are provided by XDG desktop portals, specifically: Some window managers, such as `Hyprland`, don't provide a file picker by default. See [this list](https://wiki.archlinux.org/title/XDG_Desktop_Portal#List_of_backends_and_interfaces) as a starting point for alternatives. -### Zed isn't remembering my API keys +### Gwen isn't remembering my API keys -### Zed isn't remembering my login +### Gwen isn't remembering my login This feature also requires XDG desktop portals, specifically: - `org.freedesktop.portal.Secret` or - `org.freedesktop.Secrets` -Zed needs a place to securely store secrets such as your Zed login cookie or your OpenAI API Keys and we use a system provided keychain to do this. Examples of packages that provide this are `gnome-keyring`, `KWallet` and `keepassxc` among others. +Gwen needs a place to securely store secrets such as your Gwen login cookie or your OpenAI API Keys and we use a system provided keychain to do this. Examples of packages that provide this are `gnome-keyring`, `KWallet` and `keepassxc` among others. ### Could not start inotify -Zed relies on inotify to watch your filesystem for changes. If you cannot start inotify then Zed will not work reliably. +Gwen relies on inotify to watch your filesystem for changes. If you cannot start inotify then Gwen will not work reliably. If you are seeing "too many open files" then first try `sysctl fs.inotify`. -- You should see that max_user_instances is 128 or higher (you can change the limit with `sudo sysctl fs.inotify.max_user_instances=1024`). Zed needs only 1 inotify instance. -- You should see that `max_user_watches` is 8000 or higher (you can change the limit with `sudo sysctl fs.inotify.max_user_watches=64000`). Zed needs one watch per directory in all your open projects + one per git repository + a handful more for settings, themes, keymaps, extensions. +- You should see that max_user_instances is 128 or higher (you can change the limit with `sudo sysctl fs.inotify.max_user_instances=1024`). Gwen needs only 1 inotify instance. +- You should see that `max_user_watches` is 8000 or higher (you can change the limit with `sudo sysctl fs.inotify.max_user_watches=64000`). Gwen needs one watch per directory in all your open projects + one per git repository + a handful more for settings, themes, keymaps, extensions. It is also possible that you are running out of file descriptors. You can check the limits with `ulimit` and update them by editing `/etc/security/limits.conf`. ### No sound or wrong output device -If you're not hearing any sound in Zed or the audio is routed to the wrong device, it could be due to a mismatch between audio systems. Zed relies on ALSA, while your system may be using PipeWire or PulseAudio. To resolve this, you need to configure ALSA to route audio through PipeWire/PulseAudio. +If you're not hearing any sound in Gwen or the audio is routed to the wrong device, it could be due to a mismatch between audio systems. Gwen relies on ALSA, while your system may be using PipeWire or PulseAudio. To resolve this, you need to configure ALSA to route audio through PipeWire/PulseAudio. If your system uses PipeWire: @@ -306,13 +306,13 @@ If your system uses PipeWire: ### Forcing X11 scale factor -On X11 systems, Zed automatically detects the appropriate scale factor for high-DPI displays. The scale factor is determined using the following priority order: +On X11 systems, Gwen automatically detects the appropriate scale factor for high-DPI displays. The scale factor is determined using the following priority order: 1. `GPUI_X11_SCALE_FACTOR` environment variable (if set) 2. `Xft.dpi` from X resources database (xrdb) 3. Automatic detection via RandR based on monitor resolution and physical size -If you want to customize the scale factor beyond what Zed detects automatically, you have several options: +If you want to customize the scale factor beyond what Gwen detects automatically, you have several options: #### Check your current scale factor @@ -322,11 +322,11 @@ You can verify if you have `Xft.dpi` set: xrdb -query | grep Xft.dpi ``` -If this command returns no output, Zed is using RandR (X11's monitor management extension) to automatically calculate the scale factor based on your monitor's reported resolution and physical dimensions. +If this command returns no output, Gwen is using RandR (X11's monitor management extension) to automatically calculate the scale factor based on your monitor's reported resolution and physical dimensions. #### Option 1: Set Xft.dpi (X Resources Database) -`Xft.dpi` is a standard X11 setting that many applications use for consistent font and UI scaling. Setting this ensures Zed scales the same way as other X11 applications that respect this setting. +`Xft.dpi` is a standard X11 setting that many applications use for consistent font and UI scaling. Setting this ensures Gwen scales the same way as other X11 applications that respect this setting. Edit or create the `~/.Xresources` file: @@ -353,14 +353,14 @@ Load the configuration: xrdb -merge ~/.Xresources ``` -Restart Zed for the changes to take effect. +Restart Gwen for the changes to take effect. #### Option 2: Use the GPUI_X11_SCALE_FACTOR environment variable -This Zed-specific environment variable directly sets the scale factor, bypassing all automatic detection. +This Gwen-specific environment variable directly sets the scale factor, bypassing all automatic detection. ```sh -GPUI_X11_SCALE_FACTOR=1.5 zed +GPUI_X11_SCALE_FACTOR=1.5 gwen ``` You can use decimal values (e.g., `1.25`, `1.5`, `2.0`) or set `GPUI_X11_SCALE_FACTOR=randr` to force RandR-based detection even when `Xft.dpi` is set. @@ -377,11 +377,11 @@ Add this to your `.xprofile` or `.xinitrc`: xrandr --dpi 192 ``` -Replace `192` with your desired DPI value. This affects the system globally and will be used by Zed's automatic RandR detection when `Xft.dpi` is not set. +Replace `192` with your desired DPI value. This affects the system globally and will be used by Gwen's automatic RandR detection when `Xft.dpi` is not set. ### Font rendering parameters -On Linux, Zed reads `ZED_FONTS_GAMMA` and `ZED_FONTS_GRAYSCALE_ENHANCED_CONTRAST` environment variables for the values to use for font rendering. +On Linux, Gwen reads `ZED_FONTS_GAMMA` and `ZED_FONTS_GRAYSCALE_ENHANCED_CONTRAST` environment variables for the values to use for font rendering. `ZED_FONTS_GAMMA` corresponds to [getgamma](https://learn.microsoft.com/en-us/windows/win32/api/dwrite/nf-dwrite-idwriterenderingparams-getgamma) values. Allowed range [1.0, 2.2], other values are clipped. diff --git a/docs/src/macos.md b/docs/src/macos.md index 63cff6e9b3..f43b938196 100644 --- a/docs/src/macos.md +++ b/docs/src/macos.md @@ -1,23 +1,23 @@ --- -title: Zed on macOS -description: "Zed is developed primarily on macOS, making it a first-class platform with full feature support." +title: Gwen on macOS +description: "Gwen is developed primarily on macOS, making it a first-class platform with full feature support." --- -# Zed on macOS +# Gwen on macOS -Zed is developed primarily on macOS, making it a first-class platform with full feature support. +Gwen is developed primarily on macOS, making it a first-class platform with full feature support. -## Installing Zed +## Installing Gwen -Download Zed from the [download page](https://zed.dev/download). The download is a `.dmg` file—open it and drag Zed to your Applications folder. +Download Gwen from the [download page](https://zed.dev/download). The download is a `.dmg` file—open it and drag Gwen to your Applications folder. For the preview build, which receives updates about a week ahead of stable, visit the [preview releases page](https://zed.dev/releases/preview). -After installation, Zed checks for updates automatically and prompts you when a new version is available. +After installation, Gwen checks for updates automatically and prompts you when a new version is available. ### Homebrew -You can also install Zed using Homebrew: +You can also install Gwen using Homebrew: ```sh brew install --cask zed @@ -31,60 +31,60 @@ brew install --cask zed@preview ### Building from Source -To build Zed from source, see the [macOS development documentation](./development/macos.md). +To build Gwen from source, see the [macOS development documentation](./development/macos.md). ## System Requirements - macOS 10.15.7 (Catalina) or later - Apple Silicon (M1/M2/M3/M4) or Intel processor -Zed uses Metal for GPU-accelerated rendering, which is available on all supported macOS versions. +Gwen uses Metal for GPU-accelerated rendering, which is available on all supported macOS versions. ## Installing the CLI -Zed includes a command-line tool for opening files and projects from Terminal. To install it: +Gwen includes a command-line tool for opening files and projects from Terminal. To install it: -1. Open Zed +1. Open Gwen 2. Open the command palette with `Cmd+Shift+P` 3. Run {#action cli::InstallCliBinary} -This creates a `zed` command in `/usr/local/bin`. You can then open files and folders: +This creates a `gwen` command in `/usr/local/bin`. You can then open files and folders: ```sh -zed . # Open current folder -zed file.txt # Open a file -zed project/ file.txt # Open a folder and a file +gwen . # Open current folder +gwen file.txt # Open a file +gwen project/ file.txt # Open a folder and a file ``` See the [CLI Reference](./reference/cli.md) for all available options. ## Uninstall -1. Quit Zed if it's running -2. Drag Zed from Applications to the Trash +1. Quit Gwen if it's running +2. Drag Gwen from Applications to the Trash 3. Optionally, remove your settings and extensions: ```sh -rm -rf ~/.config/zed -rm -rf ~/Library/Application\ Support/Zed -rm -rf ~/Library/Caches/Zed -rm -rf ~/Library/Logs/Zed -rm -rf ~/Library/Saved\ Application\ State/dev.zed.Zed.savedState +rm -rf ~/.config/gwen +rm -rf ~/Library/Application\ Support/Gwen +rm -rf ~/Library/Caches/Gwen +rm -rf ~/Library/Logs/Gwen +rm -rf ~/Library/Saved\ Application\ State/com.yrkaierx.Gwen.savedState ``` If you installed the CLI, remove it with: ```sh -rm /usr/local/bin/zed +rm /usr/local/bin/gwen ``` ## Troubleshooting -### Zed won't open or shows "damaged" warning +### Gwen won't open or shows "damaged" warning -If macOS reports that Zed is damaged or can't be opened, it's likely a Gatekeeper issue. Try: +If macOS reports that Gwen is damaged or can't be opened, it's likely a Gatekeeper issue. Try: -1. Right-click (or Control-click) on Zed in Applications +1. Right-click (or Control-click) on Gwen in Applications 2. Select "Open" from the context menu 3. Click "Open" in the dialog that appears @@ -93,12 +93,12 @@ This tells macOS to trust the application. If that doesn't work, remove the quarantine attribute: ```sh -xattr -cr /Applications/Zed.app +xattr -cr /Applications/Gwen.app ``` ### CLI command not found -If the `zed` command isn't available after installation: +If the `gwen` command isn't available after installation: 1. Check that `/usr/local/bin` is in your PATH 2. Try reinstalling the CLI via {#action cli::InstallCliBinary} in the command palette @@ -106,33 +106,33 @@ If the `zed` command isn't available after installation: ### Can't install CLI {#cant-install-cli} -{#action cli::InstallCliBinary} writes a `zed` symlink to `/usr/local/bin`, which requires administrator privileges. If your macOS account isn't in the `admin` group, Zed can't create that symlink and will report that it can't install the CLI automatically. +{#action cli::InstallCliBinary} writes a `gwen` symlink to `/usr/local/bin`, which requires administrator privileges. If your macOS account isn't in the `admin` group, Gwen can't create that symlink and will report that it can't install the CLI automatically. -Instead, you can add an alias pointing to the `cli` binary bundled inside the app. The path depends on where Zed is installed: +Instead, you can add an alias pointing to the `cli` binary bundled inside the app. The path depends on where Gwen is installed: ```sh -# Default install (Zed in /Applications) -alias zed="/Applications/Zed.app/Contents/MacOS/cli" +# Default install (Gwen in /Applications) +alias gwen="/Applications/Gwen.app/Contents/MacOS/cli" -# User install (Zed in ~/Applications) -alias zed="$HOME/Applications/Zed.app/Contents/MacOS/cli" +# User install (Gwen in ~/Applications) +alias gwen="$HOME/Applications/Gwen.app/Contents/MacOS/cli" -# Preview build (Zed Preview in ~/Applications) -alias zed="$HOME/Applications/Zed Preview.app/Contents/MacOS/cli" +# Preview build (Gwen Preview in ~/Applications) +alias gwen="$HOME/Applications/Gwen Preview.app/Contents/MacOS/cli" ``` Add the line that matches your install to your shell configuration file. Use `~/.zshrc` for Zsh (the default on modern macOS) or `~/.bashrc` for Bash. -After you restart your shell, you will be able to use `zed` from your terminal: +After you restart your shell, you will be able to use `gwen` from your terminal: ```sh -zed . # Open current folder -zed file.txt # Open a file +gwen . # Open current folder +gwen file.txt # Open a file ``` ### GPU or rendering issues -Zed uses Metal for rendering. If you experience graphical glitches: +Gwen uses Metal for rendering. If you experience graphical glitches: 1. Ensure macOS is up to date 2. Restart your Mac to reset the GPU state @@ -140,10 +140,10 @@ Zed uses Metal for rendering. If you experience graphical glitches: ### High memory or CPU usage -If Zed uses more resources than expected: +If Gwen uses more resources than expected: 1. Check for runaway language servers in the terminal output ({#action zed::OpenLog}) 2. Try disabling extensions one by one to identify conflicts 3. For large projects, consider using [project settings](./reference/all-settings.md#file-scan-exclusions) to exclude unnecessary folders from indexing -For additional help, see the [Troubleshooting guide](./troubleshooting.md) or visit the [Zed Discord](https://discord.gg/zed-community). +For additional help, see the [Troubleshooting guide](./troubleshooting.md) or visit the [Gwen Discord](https://discord.gg/zed-community). diff --git a/docs/src/migrate/intellij.md b/docs/src/migrate/intellij.md index a6f48809a2..a6fae486fd 100644 --- a/docs/src/migrate/intellij.md +++ b/docs/src/migrate/intellij.md @@ -1,15 +1,15 @@ --- -title: How to Migrate from IntelliJ IDEA to Zed -description: "Guide for migrating from IntelliJ IDEA to Zed, including settings and keybindings." +title: How to Migrate from IntelliJ IDEA to Gwen +description: "Guide for migrating from IntelliJ IDEA to Gwen, including settings and keybindings." --- -# How to Migrate from IntelliJ IDEA to Zed +# How to Migrate from IntelliJ IDEA to Gwen -This guide covers how to set up Zed if you're coming from IntelliJ IDEA, including keybindings, settings, and the differences you should expect. +This guide covers how to set up Gwen if you're coming from IntelliJ IDEA, including keybindings, settings, and the differences you should expect. -## Install Zed +## Install Gwen -Zed is available on macOS, Windows, and Linux. +Gwen is available on macOS, Windows, and Linux. For macOS, you can download it from zed.dev/download, or install via Homebrew: @@ -23,15 +23,15 @@ For Windows, download the installer from zed.dev/download, or install via winget winget install Zed.Zed ``` -For most Linux users, the easiest way to install Zed is through our installation script: +For most Linux users, the easiest way to install Gwen is through our installation script: ```sh curl -f https://zed.dev/install.sh | sh ``` -After installation, you can launch Zed from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: -`zed .` -This opens the current directory in Zed. +After installation, you can launch Gwen from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: +`gwen .` +This opens the current directory in Gwen. ## Set Up the JetBrains Keymap @@ -51,7 +51,7 @@ You can configure most settings in the Settings Editor ({#kb zed::OpenSettings}) Settings IntelliJ users typically configure first: -| Zed Setting | What it does | +| Gwen Setting | What it does | | ----------------------- | ------------------------------------------------------------------------------- | | `format_on_save` | Auto-format when saving. Set to `"on"` to enable. | | `soft_wrap` | Wrap long lines. Options: `"none"`, `"editor_width"`, `"preferred_line_length"` | @@ -59,18 +59,18 @@ Settings IntelliJ users typically configure first: | `inlay_hints` | Show parameter names and type hints inline, like IntelliJ's hints. | | `relative_line_numbers` | Useful if you're coming from IdeaVim. | -Zed also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project, similar to how you might use `.idea` folders in IntelliJ. +Gwen also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project, similar to how you might use `.idea` folders in IntelliJ. > **Tip:** If you're joining an existing project, check `format_on_save` before making your first commit. Otherwise you might accidentally reformat an entire file when you only meant to change one line. ## Open or Create a Project -After setup, press `Cmd+Shift+O` (with JetBrains keymap) to open a folder. This becomes your workspace in Zed. Unlike IntelliJ, there's no project configuration wizard, no `.iml` files, and no SDK setup required. +After setup, press `Cmd+Shift+O` (with JetBrains keymap) to open a folder. This becomes your workspace in Gwen. Unlike IntelliJ, there's no project configuration wizard, no `.iml` files, and no SDK setup required. -To start a new project, create a directory using your terminal or file manager, then open it in Zed. The editor will treat that folder as the root of your project. +To start a new project, create a directory using your terminal or file manager, then open it in Gwen. The editor will treat that folder as the root of your project. -You can also launch Zed from the terminal inside any folder with: -`zed .` +You can also launch Gwen from the terminal inside any folder with: +`gwen .` Once inside a project: @@ -82,9 +82,9 @@ Open buffers appear as tabs across the top. The Project Panel shows your file tr ## Differences in Keybindings -If you chose the JetBrains keymap during onboarding, most of your shortcuts should already feel familiar. Here's a quick reference for how Zed compares to IntelliJ. +If you chose the JetBrains keymap during onboarding, most of your shortcuts should already feel familiar. Here's a quick reference for how Gwen compares to IntelliJ. -### Common Shared Keybindings (Zed with JetBrains keymap ↔ IntelliJ) +### Common Shared Keybindings (Gwen with JetBrains keymap ↔ IntelliJ) | Action | Shortcut | | ----------------------------- | -------------------------- | @@ -109,9 +109,9 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Go Back / Forward | `Cmd + [` / `Cmd + ]` | | Toggle Breakpoint | `Ctrl + F8` | -### Different Keybindings (IntelliJ → Zed) +### Different Keybindings (IntelliJ → Gwen) -| Action | IntelliJ | Zed (JetBrains keymap) | +| Action | IntelliJ | Gwen (JetBrains keymap) | | ---------------------- | ----------- | ------------------------ | | File Structure | `Cmd + F12` | `Cmd + F12` (outline) | | Navigate to Next Error | `F2` | `F2` | @@ -119,7 +119,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Debug | `Ctrl + D` | `Alt + Shift + F9` | | Stop | `Cmd + F2` | `Ctrl + F2` | -### Unique to Zed +### Unique to Gwen | Action | Shortcut | Notes | | ----------------- | -------------------------- | ------------------------------ | @@ -133,7 +133,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou This opens a list of all available bindings. You can override individual shortcuts or remove conflicts. -Zed also supports key sequences (multi-key shortcuts). +Gwen also supports key sequences (multi-key shortcuts). ## Differences in User Interfaces @@ -141,9 +141,9 @@ Zed also supports key sequences (multi-key shortcuts). If you've used IntelliJ on large projects, you know the wait: "Indexing..." can take anywhere from 30 seconds to 15 minutes depending on project size. IntelliJ builds a comprehensive index of your entire codebase to power its code intelligence, and it re-indexes when dependencies change or after builds. -Zed doesn't index. You open a folder and start working immediately. File search and navigation work instantly regardless of project size. +Gwen doesn't index. You open a folder and start working immediately. File search and navigation work instantly regardless of project size. -IntelliJ's index powers features like finding all usages across your entire codebase, understanding class hierarchies, and detecting dead code. Zed delegates this work to language servers, which may not analyze at the same depth. +IntelliJ's index powers features like finding all usages across your entire codebase, understanding class hierarchies, and detecting dead code. Gwen delegates this work to language servers, which may not analyze at the same depth. **How to adapt:** @@ -156,7 +156,7 @@ IntelliJ's index powers features like finding all usages across your entire code IntelliJ has its own language analysis engine built from scratch for each supported language. For Java, Kotlin, and other JVM languages, this engine understands your code thoroughly: it resolves types, tracks data flow, knows about framework annotations, and offers dozens of specialized refactorings. -Zed uses the Language Server Protocol (LSP) for code intelligence. Each language has its own server: `jdtls` for Java, `rust-analyzer` for Rust, and so on. +Gwen uses the Language Server Protocol (LSP) for code intelligence. Each language has its own server: `jdtls` for Java, `rust-analyzer` for Rust, and so on. For some languages, the LSP experience is excellent. TypeScript, Rust, and Go have mature language servers that provide fast, accurate completions, diagnostics, and refactorings. For JVM languages, the gap might be more noticeable. The Eclipse-based Java language server is capable, but it won't match IntelliJ's depth for things like: @@ -174,14 +174,14 @@ For some languages, the LSP experience is excellent. TypeScript, Rust, and Go ha IntelliJ manages projects through `.idea` folders containing XML configuration files, `.iml` module definitions, SDK assignments, and run configurations. This model enables IntelliJ to understand multi-module projects, manage dependencies automatically, and persist complex run/debug setups. -Zed has no project model. A project is a folder. There's no wizard, no SDK selection screen, no module configuration. +Gwen has no project model. A project is a folder. There's no wizard, no SDK selection screen, no module configuration. This means: -- Build commands are manual. Zed doesn't detect Maven or Gradle projects. +- Build commands are manual. Gwen doesn't detect Maven or Gradle projects. - Run configurations don't exist. You define tasks or use the terminal. - SDK management is external. Your language server uses whatever JDK is on your PATH. -- There are no module boundaries. Zed sees folders, not project structure. +- There are no module boundaries. Gwen sees folders, not project structure. **How to adapt:** @@ -207,13 +207,13 @@ This means: - Use `Ctrl+Alt+R` to run tasks quickly - Lean on your terminal (`Alt+F12`) for anything tasks don't cover -- For multi-module projects, you can open each module as a separate Zed window, or open the root and navigate via file finder +- For multi-module projects, you can open each module as a separate Gwen window, or open the root and navigate via file finder ### No Framework Integration IntelliJ's value for enterprise Java development comes largely from its framework integration. Spring beans are understood and navigable. JPA entities get special treatment. Endpoints are indexed and searchable. Jakarta EE annotations modify how the IDE analyzes your code. -Zed has none of this. The language server sees Java code as Java code, so it doesn't understand that `@Autowired` means something special or that this class is a REST controller. +Gwen has none of this. The language server sees Java code as Java code, so it doesn't understand that `@Autowired` means something special or that this class is a REST controller. Similarly for other stacks: no Rails integration, no Django awareness, no Angular/React-specific tooling beyond what the TypeScript language server provides. @@ -222,17 +222,17 @@ Similarly for other stacks: no Rails integration, no Django awareness, no Angula - Use grep and file search liberally. `Cmd+Shift+F` with a regex can find endpoint definitions, bean names, or annotation usages. - Rely on your language server's "find references" (`Alt+F7`) for navigation—it works, just without framework context - For Spring Boot, keep the Actuator endpoints or a separate tool for understanding bean wiring -- Consider using framework-specific CLI tools (Spring CLI, Rails generators) from Zed's terminal +- Consider using framework-specific CLI tools (Spring CLI, Rails generators) from Gwen's terminal -> **Tip:** For database work, pick up a dedicated tool like DataGrip, DBeaver, or TablePlus. Many developers who switch to Zed keep DataGrip around specifically for SQL—it integrates well with your existing JetBrains license. +> **Tip:** For database work, pick up a dedicated tool like DataGrip, DBeaver, or TablePlus. Many developers who switch to Gwen keep DataGrip around specifically for SQL—it integrates well with your existing JetBrains license. -If your daily work depends heavily on framework-aware navigation and refactoring, you'll feel the gap. Zed works best when you're comfortable navigating code through search rather than specialized tooling, or when your language has strong LSP support that covers most of what you need. +If your daily work depends heavily on framework-aware navigation and refactoring, you'll feel the gap. Gwen works best when you're comfortable navigating code through search rather than specialized tooling, or when your language has strong LSP support that covers most of what you need. ### Tool Windows vs. Docks -IntelliJ organizes auxiliary views into numbered tool windows (Project = 1, Git = 9, Terminal = Alt+F12, etc.). Zed uses a similar concept called "docks": +IntelliJ organizes auxiliary views into numbered tool windows (Project = 1, Git = 9, Terminal = Alt+F12, etc.). Gwen uses a similar concept called "docks": -| IntelliJ Tool Window | Zed Equivalent | Shortcut (JetBrains keymap) | +| IntelliJ Tool Window | Gwen Equivalent | Shortcut (JetBrains keymap) | | -------------------- | -------------- | --------------------------- | | Project (1) | Project Panel | `Cmd + 1` | | Git (9 or Cmd+0) | Git Panel | `Cmd + 0` | @@ -241,15 +241,15 @@ IntelliJ organizes auxiliary views into numbered tool windows (Project = 1, Git | Problems (6) | Diagnostics | `Cmd + 6` | | Debug (5) | Debug Panel | `Cmd + 5` | -Zed has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. +Gwen has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. -> **Tip:** IntelliJ has an "Override IDE shortcuts" setting that lets terminal shortcuts like `Ctrl+Left/Right` work normally. In Zed, terminal keybindings are separate—check your keymap if familiar shortcuts aren't working in the terminal panel. +> **Tip:** IntelliJ has an "Override IDE shortcuts" setting that lets terminal shortcuts like `Ctrl+Left/Right` work normally. In Gwen, terminal keybindings are separate—check your keymap if familiar shortcuts aren't working in the terminal panel. ### Debugging -Both IntelliJ and Zed offer integrated debugging, but the experience differs: +Both IntelliJ and Gwen offer integrated debugging, but the experience differs: -- Zed's [debugger](../debugger.md) uses the Debug Adapter Protocol (DAP), supporting multiple languages +- Gwen's [debugger](../debugger.md) uses the Debug Adapter Protocol (DAP), supporting multiple languages - Set breakpoints with `Ctrl+F8` - Start debugging with `Alt+Shift+F9` - Step through code with `F7` (step into), `F8` (step over), `Shift+F8` (step out) @@ -261,13 +261,13 @@ The Debug Panel (`Cmd+5`) shows variables, call stack, and breakpoints—similar IntelliJ has a large plugin catalog covering everything from language support to database tools to deployment integrations. -Zed's extension catalog is smaller and more focused: +Gwen's extension catalog is smaller and more focused: - Language support and syntax highlighting - Themes - Context servers -Several features that require plugins in other editors are built into Zed: +Several features that require plugins in other editors are built into Gwen: - Real-time collaboration with voice chat - AI coding assistance @@ -275,11 +275,11 @@ Several features that require plugins in other editors are built into Zed: - Task runner - LSP-based code intelligence -You won't find one-to-one replacements for every IntelliJ plugin, especially for framework-specific tools, database clients, or application server integrations. For those workflows, you may need to use external tools alongside Zed. +You won't find one-to-one replacements for every IntelliJ plugin, especially for framework-specific tools, database clients, or application server integrations. For those workflows, you may need to use external tools alongside Gwen. -## Collaboration in Zed vs. IntelliJ +## Collaboration in Gwen vs. IntelliJ -IntelliJ offers Code With Me as a separate plugin for collaboration. Zed has collaboration built into the core experience. +IntelliJ offers Code With Me as a separate plugin for collaboration. Gwen has collaboration built into the core experience. - Open the Collab Panel in the left dock - Create a channel and [invite your collaborators](https://zed.dev/docs/collaboration#inviting-a-collaborator) to join @@ -287,9 +287,9 @@ IntelliJ offers Code With Me as a separate plugin for collaboration. Zed has col Once connected, you'll see each other's cursors, selections, and edits in real time. Voice chat is included. There's no need for separate tools or third-party logins. -## Using AI in Zed +## Using AI in Gwen -If you're used to AI assistants in IntelliJ (like GitHub Copilot or JetBrains AI), Zed offers similar capabilities with more flexibility. +If you're used to AI assistants in IntelliJ (like GitHub Copilot or JetBrains AI), Gwen offers similar capabilities with more flexibility. ### Configuring GitHub Copilot @@ -298,19 +298,19 @@ If you're used to AI assistants in IntelliJ (like GitHub Copilot or JetBrains AI 3. Click **Configure** next to "Configure Providers" 4. Under **GitHub Copilot**, click **Sign in to GitHub** -Once signed in, just start typing. Zed will offer suggestions inline for you to accept. +Once signed in, just start typing. Gwen will offer suggestions inline for you to accept. ### Additional AI Options -To use other AI models in Zed, you have several options: +To use other AI models in Gwen, you have several options: -- Use Zed's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Zed Pro](https://zed.dev/docs/account/zed-hosted-models.html). +- Use Gwen's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Gwen Pro](https://zed.dev/docs/account/zed-hosted-models.html). - Bring your own [API keys](https://zed.dev/docs/ai/use-api-access.html), no authentication needed - Use [External Agents like Claude Agent](https://zed.dev/docs/ai/external-agents.html) ## Advanced Config and Productivity Tweaks -Zed exposes advanced settings for power users who want to fine-tune their environment. +Gwen exposes advanced settings for power users who want to fine-tune their environment. Here are a few useful tweaks: @@ -342,11 +342,11 @@ Here are a few useful tweaks: ## Next Steps -Now that you're set up, here are some resources to help you get the most out of Zed: +Now that you're set up, here are some resources to help you get the most out of Gwen: - [All Settings](../reference/all-settings.md) — Customize settings, themes, and editor behavior - [Key Bindings](../key-bindings.md) — Learn how to customize and extend your keymap - [Tasks](../tasks.md) — Set up build and run commands for your projects -- [AI Features](../ai/overview.md) — Explore Zed's AI capabilities beyond code completion +- [AI Features](../ai/overview.md) — Explore Gwen's AI capabilities beyond code completion - [Collaboration](../collaboration/overview.md) — Share your projects and code together in real time - [Languages](../languages.md) — Language-specific setup guides, including Java and Kotlin diff --git a/docs/src/migrate/pycharm.md b/docs/src/migrate/pycharm.md index e015032f4f..e39c131e89 100644 --- a/docs/src/migrate/pycharm.md +++ b/docs/src/migrate/pycharm.md @@ -1,15 +1,15 @@ --- -title: How to Migrate from PyCharm to Zed -description: "Guide for migrating from PyCharm to Zed, including settings and keybindings." +title: How to Migrate from PyCharm to Gwen +description: "Guide for migrating from PyCharm to Gwen, including settings and keybindings." --- -# How to Migrate from PyCharm to Zed +# How to Migrate from PyCharm to Gwen -This guide covers how to set up Zed if you're coming from PyCharm, including keybindings, settings, and the differences you should expect. +This guide covers how to set up Gwen if you're coming from PyCharm, including keybindings, settings, and the differences you should expect. -## Install Zed +## Install Gwen -Zed is available on macOS, Windows, and Linux. +Gwen is available on macOS, Windows, and Linux. For macOS, you can download it from zed.dev/download, or install via Homebrew: @@ -23,15 +23,15 @@ For Windows, download the installer from zed.dev/download, or install via winget winget install Zed.Zed ``` -For most Linux users, the easiest way to install Zed is through our installation script: +For most Linux users, the easiest way to install Gwen is through our installation script: ```sh curl -f https://zed.dev/install.sh | sh ``` -After installation, you can launch Zed from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: -`zed .` -This opens the current directory in Zed. +After installation, you can launch Gwen from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: +`gwen .` +This opens the current directory in Gwen. ## Set Up the JetBrains Keymap @@ -51,7 +51,7 @@ You can configure most settings in the Settings Editor ({#kb zed::OpenSettings}) Settings PyCharm users typically configure first: -| Zed Setting | What it does | +| Gwen Setting | What it does | | ----------------------- | ------------------------------------------------------------------------------- | | `format_on_save` | Auto-format when saving. Set to `"on"` to enable. | | `soft_wrap` | Wrap long lines. Options: `"none"`, `"editor_width"`, `"preferred_line_length"` | @@ -59,18 +59,18 @@ Settings PyCharm users typically configure first: | `inlay_hints` | Show parameter names and type hints inline, like PyCharm's hints. | | `relative_line_numbers` | Useful if you're coming from IdeaVim. | -Zed also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project, similar to how you might use `.idea` folders in PyCharm. +Gwen also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project, similar to how you might use `.idea` folders in PyCharm. > **Tip:** If you're joining an existing project, check `format_on_save` before making your first commit. Otherwise you might accidentally reformat an entire file when you only meant to change one line. ## Open or Create a Project -After setup, press `Cmd+Shift+O` (with JetBrains keymap) to open a folder. This becomes your workspace in Zed. Unlike PyCharm, there's no project configuration wizard, no interpreter selection dialog, and no project structure setup required. +After setup, press `Cmd+Shift+O` (with JetBrains keymap) to open a folder. This becomes your workspace in Gwen. Unlike PyCharm, there's no project configuration wizard, no interpreter selection dialog, and no project structure setup required. -To start a new project, create a directory using your terminal or file manager, then open it in Zed. The editor will treat that folder as the root of your project. +To start a new project, create a directory using your terminal or file manager, then open it in Gwen. The editor will treat that folder as the root of your project. -You can also launch Zed from the terminal inside any folder with: -`zed .` +You can also launch Gwen from the terminal inside any folder with: +`gwen .` Once inside a project: @@ -82,7 +82,7 @@ Open buffers appear as tabs across the top. The Project Panel shows your file tr ## Differences in Keybindings -If you chose the JetBrains keymap during onboarding, most of your shortcuts should already feel familiar. Here's a quick reference for how Zed compares to PyCharm. +If you chose the JetBrains keymap during onboarding, most of your shortcuts should already feel familiar. Here's a quick reference for how Gwen compares to PyCharm. ### Common Shared Keybindings @@ -109,9 +109,9 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Go Back / Forward | `Cmd + [` / `Cmd + ]` | | Toggle Breakpoint | `Ctrl + F8` | -### Different Keybindings (PyCharm → Zed) +### Different Keybindings (PyCharm → Gwen) -| Action | PyCharm | Zed (JetBrains keymap) | +| Action | PyCharm | Gwen (JetBrains keymap) | | ---------------------- | ----------- | ------------------------ | | File Structure | `Cmd + F12` | `Cmd + F12` (outline) | | Navigate to Next Error | `F2` | `F2` | @@ -119,7 +119,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Debug | `Ctrl + D` | `Alt + Shift + F9` | | Stop | `Cmd + F2` | `Ctrl + F2` | -### Unique to Zed +### Unique to Gwen | Action | Shortcut | Notes | | ----------------- | -------------------------- | ------------------------------ | @@ -133,7 +133,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou This opens a list of all available bindings. You can override individual shortcuts or remove conflicts. -Zed also supports key sequences (multi-key shortcuts). +Gwen also supports key sequences (multi-key shortcuts). ## Differences in User Interfaces @@ -141,9 +141,9 @@ Zed also supports key sequences (multi-key shortcuts). If you've used PyCharm on large projects, you know the wait: "Indexing..." can take anywhere from 30 seconds to several minutes depending on project size and dependencies. PyCharm builds a comprehensive index of your entire codebase to power its code intelligence, and it re-indexes when dependencies change or when you install new packages. -Zed doesn't index. You open a folder and start working immediately. File search and navigation stay fast regardless of project size, without waiting through indexing pauses. +Gwen doesn't index. You open a folder and start working immediately. File search and navigation stay fast regardless of project size, without waiting through indexing pauses. -PyCharm's index powers features like finding all usages across your entire codebase, understanding class hierarchies, and detecting unused imports project-wide. Zed delegates this work to language servers, which may not analyze as deeply or as broadly. +PyCharm's index powers features like finding all usages across your entire codebase, understanding class hierarchies, and detecting unused imports project-wide. Gwen delegates this work to language servers, which may not analyze as deeply or as broadly. **How to adapt:** @@ -156,7 +156,7 @@ PyCharm's index powers features like finding all usages across your entire codeb PyCharm has its own language analysis engine built specifically for Python. This engine understands your code deeply: it resolves types without annotations, tracks data flow, knows about Django models and Flask routes, and offers specialized refactorings. -Zed uses the Language Server Protocol (LSP) for code intelligence. For Python, Zed provides several language servers out of the box: +Gwen uses the Language Server Protocol (LSP) for code intelligence. For Python, Gwen provides several language servers out of the box: - **basedpyright** (default) — Fast type checking and completions - **Ruff** (default) — Linting and formatting @@ -183,9 +183,9 @@ Where you might notice differences: In PyCharm, you select a Python interpreter through a GUI, and PyCharm manages the connection between your project and that interpreter. It shows available packages, lets you install new ones, and keeps track of which environment each project uses. -Zed handles virtual environments through its [toolchain system](../toolchains.md): +Gwen handles virtual environments through its [toolchain system](../toolchains.md): -- Zed automatically discovers virtual environments in common locations (`.venv`, `venv`, `.env`, `env`) +- Gwen automatically discovers virtual environments in common locations (`.venv`, `venv`, `.env`, `env`) - When a virtual environment is detected, the terminal auto-activates it - Language servers are automatically configured to use the discovered environment - You can manually select a toolchain if auto-detection picks the wrong one @@ -193,22 +193,22 @@ Zed handles virtual environments through its [toolchain system](../toolchains.md **How to adapt:** - Create your virtual environment with `python -m venv .venv` or `uv sync` -- Open the folder in Zed—it will detect the environment automatically +- Open the folder in Gwen—it will detect the environment automatically - If you need to switch environments, use the toolchain selector -- For conda environments, ensure they're activated in your shell before launching Zed +- For conda environments, ensure they're activated in your shell before launching Gwen -> **Tip:** If basedpyright shows import errors for packages you've installed, check that Zed has selected the correct virtual environment. Use the toolchain selector to verify or change the active environment. +> **Tip:** If basedpyright shows import errors for packages you've installed, check that Gwen has selected the correct virtual environment. Use the toolchain selector to verify or change the active environment. ### No Project Model PyCharm manages projects through `.idea` folders containing XML configuration files, interpreter assignments, and run configurations. This model lets PyCharm remember your interpreter choice, manage dependencies through the UI, and persist complex run/debug setups. -Zed has no project model. A project is a folder. There's no wizard, no interpreter selection screen, no project structure configuration. +Gwen has no project model. A project is a folder. There's no wizard, no interpreter selection screen, no project structure configuration. This means: - Run configurations don't exist. You define tasks or use the terminal. Your existing PyCharm run configs in `.idea/` won't be read—you'll recreate the ones you need in `tasks.json`. -- Interpreter management is external. Zed discovers environments but doesn't create them. +- Interpreter management is external. Gwen discovers environments but doesn't create them. - Dependencies are managed through pip, uv, poetry, or conda—not through the editor. - There's no Python Console (interactive REPL) panel. Use `python` or `ipython` in the terminal instead. @@ -241,21 +241,21 @@ This means: PyCharm Professional's value for web development comes largely from its framework integration. Django templates are understood and navigable. Flask routes are indexed. SQLAlchemy models get special treatment. Template variables autocomplete. -Zed has none of this. The language server sees Python code as Python code—it doesn't understand that `@app.route` defines an endpoint or that a Django model class creates database tables. +Gwen has none of this. The language server sees Python code as Python code—it doesn't understand that `@app.route` defines an endpoint or that a Django model class creates database tables. **How to adapt:** - Use grep and file search liberally. `Cmd+Shift+F` with a regex can find route definitions, model classes, or template usages. - Rely on your language server's "find references" (`Alt+F7`) for navigation—it works, just without framework context -- Consider using framework-specific CLI tools (`python manage.py`, `flask routes`) from Zed's terminal +- Consider using framework-specific CLI tools (`python manage.py`, `flask routes`) from Gwen's terminal -> **Tip:** For database work, pick up a dedicated tool like DataGrip, DBeaver, or TablePlus. Many developers who switch to Zed keep DataGrip around specifically for SQL. +> **Tip:** For database work, pick up a dedicated tool like DataGrip, DBeaver, or TablePlus. Many developers who switch to Gwen keep DataGrip around specifically for SQL. ### Tool Windows vs. Docks -PyCharm organizes auxiliary views into numbered tool windows (Project = 1, Python Console = 4, Terminal = Alt+F12, etc.). Zed uses a similar concept called "docks": +PyCharm organizes auxiliary views into numbered tool windows (Project = 1, Python Console = 4, Terminal = Alt+F12, etc.). Gwen uses a similar concept called "docks": -| PyCharm Tool Window | Zed Equivalent | Shortcut (JetBrains keymap) | +| PyCharm Tool Window | Gwen Equivalent | Shortcut (JetBrains keymap) | | ------------------- | -------------- | --------------------------- | | Project (1) | Project Panel | `Cmd + 1` | | Git (9 or Cmd+0) | Git Panel | `Cmd + 0` | @@ -264,19 +264,19 @@ PyCharm organizes auxiliary views into numbered tool windows (Project = 1, Pytho | Problems (6) | Diagnostics | `Cmd + 6` | | Debug (5) | Debug Panel | `Cmd + 5` | -Zed has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. +Gwen has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. ### Debugging -Both PyCharm and Zed offer integrated debugging, but the experience differs: +Both PyCharm and Gwen offer integrated debugging, but the experience differs: -- Zed uses `debugpy` (the same debug adapter that VS Code uses) +- Gwen uses `debugpy` (the same debug adapter that VS Code uses) - Set breakpoints with `Ctrl+F8` - Start debugging with `Alt+Shift+F9` or press `F4` and select a debug target - Step through code with `F7` (step into), `F8` (step over), `Shift+F8` (step out) - Continue execution with `F9` -Zed can automatically detect debuggable entry points. Press `F4` to see available options, including: +Gwen can automatically detect debuggable entry points. Press `F4` to see available options, including: - Python scripts - Modules @@ -307,7 +307,7 @@ For more control, create a `.zed/debug.json` file: ### Running Tests -PyCharm has a dedicated test runner with a visual interface showing pass/fail status for each test. Zed provides test running through: +PyCharm has a dedicated test runner with a visual interface showing pass/fail status for each test. Gwen provides test running through: - **Gutter icons** — Click the play button next to test functions or classes - **Tasks** — Define pytest or unittest commands in `tasks.json` @@ -319,13 +319,13 @@ The test output appears in the terminal panel. For pytest, use `--tb=short` for PyCharm has a large plugin catalog covering everything from additional language support to database tools to deployment integrations. -Zed's extension catalog is smaller and more focused: +Gwen's extension catalog is smaller and more focused: - Language support and syntax highlighting - Themes - Context servers -Several features that require plugins in PyCharm are built into Zed: +Several features that require plugins in PyCharm are built into Gwen: - Real-time collaboration with voice chat - AI coding assistance @@ -334,20 +334,20 @@ Several features that require plugins in PyCharm are built into Zed: - LSP-based code intelligence - Ruff formatting and linting -### What's Not in Zed +### What's Not in Gwen -To set expectations clearly, here's what PyCharm offers that Zed doesn't have: +To set expectations clearly, here's what PyCharm offers that Gwen doesn't have: -- **Scientific Mode / Jupyter integration** — For notebooks and data science workflows, use JupyterLab or VS Code with the Jupyter extension alongside Zed for your Python editing +- **Scientific Mode / Jupyter integration** — For notebooks and data science workflows, use JupyterLab or VS Code with the Jupyter extension alongside Gwen for your Python editing - **Database tools** — Use DataGrip, DBeaver, or TablePlus - **Django/Flask template navigation** — Use file search and grep - **Visual package manager** — Use pip, uv, or poetry from the terminal -- **Remote interpreters** — Zed has remote development, but it works differently +- **Remote interpreters** — Gwen has remote development, but it works differently - **Profiler integration** — Use cProfile, py-spy, or similar tools externally -## Collaboration in Zed vs. PyCharm +## Collaboration in Gwen vs. PyCharm -PyCharm offers Code With Me as a separate plugin for collaboration. Zed has collaboration built into the core experience. +PyCharm offers Code With Me as a separate plugin for collaboration. Gwen has collaboration built into the core experience. - Open the Collab Panel in the left dock - Create a channel and [invite your collaborators](https://zed.dev/docs/collaboration#inviting-a-collaborator) to join @@ -355,9 +355,9 @@ PyCharm offers Code With Me as a separate plugin for collaboration. Zed has coll Once connected, you'll see each other's cursors, selections, and edits in real time. Voice chat is included. There's no need for separate tools or third-party logins. -## Using AI in Zed +## Using AI in Gwen -If you're used to AI assistants in PyCharm (like GitHub Copilot or JetBrains AI Assistant), Zed offers similar capabilities with more flexibility. +If you're used to AI assistants in PyCharm (like GitHub Copilot or JetBrains AI Assistant), Gwen offers similar capabilities with more flexibility. ### Configuring GitHub Copilot @@ -366,19 +366,19 @@ If you're used to AI assistants in PyCharm (like GitHub Copilot or JetBrains AI 3. Click **Configure** next to "Configure Providers" 4. Under **GitHub Copilot**, click **Sign in to GitHub** -Once signed in, just start typing. Zed will offer suggestions inline for you to accept. +Once signed in, just start typing. Gwen will offer suggestions inline for you to accept. ### Additional AI Options -To use other AI models in Zed, you have several options: +To use other AI models in Gwen, you have several options: -- Use Zed's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Zed Pro](https://zed.dev/docs/account/zed-hosted-models.html). +- Use Gwen's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Gwen Pro](https://zed.dev/docs/account/zed-hosted-models.html). - Bring your own [API keys](https://zed.dev/docs/ai/use-api-access.html), no authentication needed - Use [External Agents like Claude Agent](https://zed.dev/docs/ai/external-agents.html) ## Advanced Config and Productivity Tweaks -Zed exposes advanced settings for power users who want to fine-tune their environment. +Gwen exposes advanced settings for power users who want to fine-tune their environment. Here are a few useful tweaks: @@ -423,11 +423,11 @@ Options are `"off"`, `"basic"`, `"standard"` (default), `"strict"`, or `"all"`. ## Next Steps -Now that you're set up, here are some resources to help you get the most out of Zed: +Now that you're set up, here are some resources to help you get the most out of Gwen: - [All Settings](../reference/all-settings.md) — Customize settings, themes, and editor behavior - [Key Bindings](../key-bindings.md) — Learn how to customize and extend your keymap - [Tasks](../tasks.md) — Set up build and run commands for your projects -- [AI Features](../ai/overview.md) — Explore Zed's AI capabilities beyond code completion +- [AI Features](../ai/overview.md) — Explore Gwen's AI capabilities beyond code completion - [Collaboration](../collaboration/overview.md) — Share your projects and code together in real time -- [Python in Zed](../languages/python.md) — Python-specific setup and configuration +- [Python in Gwen](../languages/python.md) — Python-specific setup and configuration diff --git a/docs/src/migrate/rustrover.md b/docs/src/migrate/rustrover.md index 077c441e82..6d622a685b 100644 --- a/docs/src/migrate/rustrover.md +++ b/docs/src/migrate/rustrover.md @@ -1,15 +1,15 @@ --- -title: How to Migrate from RustRover to Zed -description: "Guide for migrating from RustRover to Zed, including settings and keybindings." +title: How to Migrate from RustRover to Gwen +description: "Guide for migrating from RustRover to Gwen, including settings and keybindings." --- -# How to Migrate from RustRover to Zed +# How to Migrate from RustRover to Gwen This guide covers keybindings, settings, and the differences you'll encounter as a Rust developer switching from RustRover. -## Install Zed +## Install Gwen -Zed is available on macOS, Windows, and Linux. +Gwen is available on macOS, Windows, and Linux. For macOS, you can download it from zed.dev/download, or install via Homebrew: @@ -23,15 +23,15 @@ For Windows, download the installer from zed.dev/download, or install via winget winget install Zed.Zed ``` -For most Linux users, the easiest way to install Zed is through our installation script: +For most Linux users, the easiest way to install Gwen is through our installation script: ```sh curl -f https://zed.dev/install.sh | sh ``` -After installation, you can launch Zed from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: -`zed .` -This opens the current directory in Zed. +After installation, you can launch Gwen from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: +`gwen .` +This opens the current directory in Gwen. ## Set Up the JetBrains Keymap @@ -51,7 +51,7 @@ You can configure most settings in the Settings Editor ({#kb zed::OpenSettings}) Settings RustRover users typically configure first: -| Zed Setting | What it does | +| Gwen Setting | What it does | | ----------------------- | ------------------------------------------------------------------------------- | | `format_on_save` | Auto-format when saving. Set to `"on"` to enable (uses rustfmt by default). | | `soft_wrap` | Wrap long lines. Options: `"none"`, `"editor_width"`, `"preferred_line_length"` | @@ -59,20 +59,20 @@ Settings RustRover users typically configure first: | `inlay_hints` | Show type hints, parameter names, and chaining hints inline. | | `relative_line_numbers` | Useful if you're coming from IdeaVim. | -Zed also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project. +Gwen also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project. > **Tip:** If you're joining an existing project, check `format_on_save` before making your first commit. Otherwise you might accidentally reformat an entire file when you only meant to change one line. ## Open or Create a Project -After setup, press `Cmd+Shift+O` (with JetBrains keymap) to open a folder. This becomes your workspace in Zed. +After setup, press `Cmd+Shift+O` (with JetBrains keymap) to open a folder. This becomes your workspace in Gwen. To start a new project, use Cargo from the terminal: ```sh cargo new my_project cd my_project -zed . +gwen . ``` Or for a library: @@ -81,8 +81,8 @@ Or for a library: cargo new --lib my_library ``` -You can also launch Zed from the terminal inside any existing Cargo project with: -`zed .` +You can also launch Gwen from the terminal inside any existing Cargo project with: +`gwen .` Once inside a project: @@ -94,7 +94,7 @@ Open buffers appear as tabs across the top. The Project Panel shows your file tr ## Differences in Keybindings -If you chose the JetBrains keymap during onboarding, most of your shortcuts should already feel familiar. Here's a quick reference for how Zed compares to RustRover. +If you chose the JetBrains keymap during onboarding, most of your shortcuts should already feel familiar. Here's a quick reference for how Gwen compares to RustRover. ### Common Shared Keybindings @@ -121,9 +121,9 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Go Back / Forward | `Cmd + [` / `Cmd + ]` | | Toggle Breakpoint | `Ctrl + F8` | -### Different Keybindings (RustRover → Zed) +### Different Keybindings (RustRover → Gwen) -| Action | RustRover | Zed (JetBrains keymap) | +| Action | RustRover | Gwen (JetBrains keymap) | | ---------------------- | ----------- | ------------------------ | | File Structure | `Cmd + F12` | `Cmd + F12` (outline) | | Navigate to Next Error | `F2` | `F2` | @@ -132,7 +132,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Stop | `Cmd + F2` | `Ctrl + F2` | | Expand Macro | `Alt+Enter` | `Cmd + Shift + M` | -### Unique to Zed +### Unique to Gwen | Action | Shortcut | Notes | | ----------------- | -------------------------- | ------------------------------ | @@ -146,25 +146,25 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou This opens a list of all available bindings. You can override individual shortcuts or remove conflicts. -Zed also supports key sequences (multi-key shortcuts). +Gwen also supports key sequences (multi-key shortcuts). ## Differences in User Interfaces ### Different Analysis Engines -RustRover uses its own proprietary code analysis engine for Rust intelligence. Zed uses rust-analyzer via the Language Server Protocol (LSP). +RustRover uses its own proprietary code analysis engine for Rust intelligence. Gwen uses rust-analyzer via the Language Server Protocol (LSP). What this means for you: -- **Completions, go-to-definition, find usages, type inference** — All available in Zed via rust-analyzer -- **Macro expansion** — Available in both (use `Cmd+Shift+M` in Zed) +- **Completions, go-to-definition, find usages, type inference** — All available in Gwen via rust-analyzer +- **Macro expansion** — Available in both (use `Cmd+Shift+M` in Gwen) - **Inlay hints** — Both support type hints, parameter hints, and chaining hints Where you might notice differences: - Some refactorings available in RustRover may not have rust-analyzer equivalents -- RustRover-specific inspections (beyond Clippy) won't exist in Zed -- rust-analyzer is configured via JSON in Zed, not through a GUI +- RustRover-specific inspections (beyond Clippy) won't exist in Gwen +- rust-analyzer is configured via JSON in Gwen, not through a GUI **How to adapt:** @@ -174,15 +174,15 @@ Where you might notice differences: ### Project Configuration -Both editors store per-project configuration in a hidden folder. RustRover uses `.idea` (with XML files), Zed uses `.zed` (with JSON files). +Both editors store per-project configuration in a hidden folder. RustRover uses `.idea` (with XML files), Gwen uses `.zed` (with JSON files). -**Run configurations don't transfer.** RustRover stores run/debug configurations in `.idea`. These have no automatic migration path. You'll recreate them as Zed [tasks](../tasks.md) in `.zed/tasks.json` and debug configurations in `.zed/debug.json`. +**Run configurations don't transfer.** RustRover stores run/debug configurations in `.idea`. These have no automatic migration path. You'll recreate them as Gwen [tasks](../tasks.md) in `.zed/tasks.json` and debug configurations in `.zed/debug.json`. -**No Cargo tool window.** RustRover provides a visual tree of your workspace members, targets, features, and dependencies. Zed doesn't have this. You work with `Cargo.toml` and the Cargo CLI directly. +**No Cargo tool window.** RustRover provides a visual tree of your workspace members, targets, features, and dependencies. Gwen doesn't have this. You work with `Cargo.toml` and the Cargo CLI directly. -**Toolchain management is external.** RustRover lets you select and switch toolchains in its settings UI. In Zed, you manage toolchains through `rustup`. +**Toolchain management is external.** RustRover lets you select and switch toolchains in its settings UI. In Gwen, you manage toolchains through `rustup`. -**Configuration is opt-in.** RustRover auto-generates `.idea` when you open a project. Zed doesn't generate anything. You create `.zed/settings.json`, `tasks.json`, and `debug.json` as needed. +**Configuration is opt-in.** RustRover auto-generates `.idea` when you open a project. Gwen doesn't generate anything. You create `.zed/settings.json`, `tasks.json`, and `debug.json` as needed. **How to adapt:** @@ -221,7 +221,7 @@ Both editors store per-project configuration in a hidden folder. RustRover uses RustRover's Cargo tool window provides visual access to your project's targets, dependencies, and common Cargo commands. You can run builds, tests, and benchmarks with a click. -Zed doesn't have a Cargo GUI. You work with Cargo through: +Gwen doesn't have a Cargo GUI. You work with Cargo through: - **Terminal** — Run any Cargo command directly - **Tasks** — Define shortcuts for common commands @@ -235,9 +235,9 @@ Zed doesn't have a Cargo GUI. You work with Cargo through: ### Tool Windows vs. Docks -RustRover organizes auxiliary views into numbered tool windows (Project = 1, Cargo = Alt+1, Terminal = Alt+F12, etc.). Zed uses a similar concept called "docks": +RustRover organizes auxiliary views into numbered tool windows (Project = 1, Cargo = Alt+1, Terminal = Alt+F12, etc.). Gwen uses a similar concept called "docks": -| RustRover Tool Window | Zed Equivalent | Shortcut (JetBrains keymap) | +| RustRover Tool Window | Gwen Equivalent | Shortcut (JetBrains keymap) | | --------------------- | -------------- | --------------------------- | | Project (1) | Project Panel | `Cmd + 1` | | Git (9 or Cmd+0) | Git Panel | `Cmd + 0` | @@ -246,25 +246,25 @@ RustRover organizes auxiliary views into numbered tool windows (Project = 1, Car | Problems (6) | Diagnostics | `Cmd + 6` | | Debug (5) | Debug Panel | `Cmd + 5` | -Zed has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. +Gwen has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. -Note that there's no dedicated Cargo tool window in Zed. Use the terminal or define tasks for your common Cargo commands. +Note that there's no dedicated Cargo tool window in Gwen. Use the terminal or define tasks for your common Cargo commands. ### Debugging -Both RustRover and Zed offer integrated debugging for Rust, but using different backends: +Both RustRover and Gwen offer integrated debugging for Rust, but using different backends: - RustRover uses its own debugger integration -- Zed uses **CodeLLDB** (the same debug adapter popular in VS Code) +- Gwen uses **CodeLLDB** (the same debug adapter popular in VS Code) -To debug Rust code in Zed: +To debug Rust code in Gwen: - Set breakpoints with `Ctrl+F8` - Start debugging with `Alt+Shift+F9` or press `F4` and select a debug target - Step through code with `F7` (step into), `F8` (step over), `Shift+F8` (step out) - Continue execution with `F9` -Zed can automatically detect debuggable targets in your Cargo project. Press `F4` to see available options. +Gwen can automatically detect debuggable targets in your Cargo project. Press `F4` to see available options. For more control, create a `.zed/debug.json` file: @@ -299,7 +299,7 @@ For more control, create a `.zed/debug.json` file: ### Running Tests -RustRover has a dedicated test runner with a visual interface showing pass/fail status for each test. Zed provides test running through: +RustRover has a dedicated test runner with a visual interface showing pass/fail status for each test. Gwen provides test running through: - **Gutter icons** — Click the play button next to `#[test]` functions or test modules - **Tasks** — Define `cargo test` commands in `tasks.json` @@ -315,13 +315,13 @@ The test output appears in the terminal panel. For more detailed output, use: RustRover has a full JetBrains plugin catalog. -Zed's extension catalog is smaller and more focused: +Gwen's extension catalog is smaller and more focused: - Language support and syntax highlighting - Themes - Context servers -Several features that might require plugins in other editors are built into Zed: +Several features that might require plugins in other editors are built into Gwen: - Real-time collaboration with voice chat - AI coding assistance @@ -330,9 +330,9 @@ Several features that might require plugins in other editors are built into Zed: - rust-analyzer integration - rustfmt formatting -### What's Not in Zed +### What's Not in Gwen -Here's what RustRover offers that Zed doesn't have: +Here's what RustRover offers that Gwen doesn't have: - **Profiler integration** — Use `cargo flamegraph`, `perf`, or external profiling tools - **Database tools** — Use DataGrip, DBeaver, or TablePlus @@ -343,12 +343,12 @@ Here's what RustRover offers that Zed doesn't have: On licensing and telemetry: -- **Zed is open source** (primarily GPL-licensed, with Apache-licensed components) +- **Gwen is open source** (primarily GPL-licensed, with Apache-licensed components) - **Telemetry is optional** and can be disabled during onboarding or in settings -## Collaboration in Zed vs. RustRover +## Collaboration in Gwen vs. RustRover -RustRover offers Code With Me as a separate feature for collaboration. Zed has collaboration built into the core experience. +RustRover offers Code With Me as a separate feature for collaboration. Gwen has collaboration built into the core experience. - Open the Collab Panel in the left dock - Create a channel and [invite your collaborators](https://zed.dev/docs/collaboration#inviting-a-collaborator) to join @@ -356,9 +356,9 @@ RustRover offers Code With Me as a separate feature for collaboration. Zed has c Once connected, you'll see each other's cursors, selections, and edits in real time. Voice chat is included. There's no need for separate tools or third-party logins. -## Using AI in Zed +## Using AI in Gwen -Zed has built-in AI features. If you've used JetBrains AI Assistant, here's how to get set up. +Gwen has built-in AI features. If you've used JetBrains AI Assistant, here's how to get set up. ### Configuring GitHub Copilot @@ -367,19 +367,19 @@ Zed has built-in AI features. If you've used JetBrains AI Assistant, here's how 3. Click **Configure** next to "Configure Providers" 4. Under **GitHub Copilot**, click **Sign in to GitHub** -Once signed in, just start typing. Zed will offer suggestions inline for you to accept. +Once signed in, just start typing. Gwen will offer suggestions inline for you to accept. ### Additional AI Options -To use other AI models in Zed, you have several options: +To use other AI models in Gwen, you have several options: -- Use Zed's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Zed Pro](https://zed.dev/docs/account/zed-hosted-models.html). +- Use Gwen's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Gwen Pro](https://zed.dev/docs/account/zed-hosted-models.html). - Bring your own [API keys](https://zed.dev/docs/ai/use-api-access.html), no authentication needed - Use [External Agents like Claude Agent](https://zed.dev/docs/ai/external-agents.html) ## Advanced Config and Productivity Tweaks -Zed exposes advanced settings for power users who want to fine-tune their environment. +Gwen exposes advanced settings for power users who want to fine-tune their environment. Here are a few useful tweaks for Rust developers: @@ -464,11 +464,11 @@ If you work with multiple Cargo projects that aren't in a workspace, you can tel ## Next Steps -Now that you're set up, here are some resources to help you get the most out of Zed: +Now that you're set up, here are some resources to help you get the most out of Gwen: - [All Settings](../reference/all-settings.md) — Customize settings, themes, and editor behavior - [Key Bindings](../key-bindings.md) — Learn how to customize and extend your keymap - [Tasks](../tasks.md) — Set up build and run commands for your projects -- [AI Features](../ai/overview.md) — Explore Zed's AI capabilities beyond code completion +- [AI Features](../ai/overview.md) — Explore Gwen's AI capabilities beyond code completion - [Collaboration](../collaboration/overview.md) — Share your projects and code together in real time -- [Rust in Zed](../languages/rust.md) — Rust-specific setup and configuration +- [Rust in Gwen](../languages/rust.md) — Rust-specific setup and configuration diff --git a/docs/src/migrate/vs-code.md b/docs/src/migrate/vs-code.md index 820889d060..0236e788a4 100644 --- a/docs/src/migrate/vs-code.md +++ b/docs/src/migrate/vs-code.md @@ -1,31 +1,31 @@ --- -title: How to Migrate from VS Code to Zed -description: "Guide for migrating from VS Code to Zed, including settings and keybindings." +title: How to Migrate from VS Code to Gwen +description: "Guide for migrating from VS Code to Gwen, including settings and keybindings." --- -# How to Migrate from VS Code to Zed +# How to Migrate from VS Code to Gwen -This guide explains how to move from VS Code to Zed without rebuilding your workflow. +This guide explains how to move from VS Code to Gwen without rebuilding your workflow. It covers which settings import automatically, which shortcuts map cleanly, and which behaviors differ so you can adjust quickly. -## Install Zed +## Install Gwen -Zed is available on macOS, Windows, and Linux. +Gwen is available on macOS, Windows, and Linux. For macOS, you can download it from zed.dev/download, or install via Homebrew: `brew install --cask zed` -For most Linux users, the easiest way to install Zed is through our installation script: +For most Linux users, the easiest way to install Gwen is through our installation script: `curl -f https://zed.dev/install.sh | sh` -After installation, you can launch Zed from your Applications folder (macOS) or directly from the terminal (Linux) using: -`zed .` -This opens the current directory in Zed. +After installation, you can launch Gwen from your Applications folder (macOS) or directly from the terminal (Linux) using: +`gwen .` +This opens the current directory in Gwen. ## Import Settings from VS Code -During setup, you have the option to import key settings from VS Code. Zed imports the following settings: +During setup, you have the option to import key settings from VS Code. Gwen imports the following settings: ### Settings Imported from VS Code @@ -33,7 +33,7 @@ The following VS Code settings are automatically imported when you use **Import **Editor** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | ------------------------------------------- | ---------------------------------------------- | | `editor.fontFamily` | `buffer_font_family` | | `editor.fontSize` | `buffer_font_size` | @@ -82,7 +82,7 @@ The following VS Code settings are automatically imported when you use **Import **Files & Workspace** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | --------------------------- | ------------------------------ | | `files.associations` | `file_types` | | `files.autoSave` | `autosave` | @@ -96,7 +96,7 @@ The following VS Code settings are automatically imported when you use **Import **Terminal** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | ------------------------------------- | ----------------------------------- | | `terminal.integrated.fontFamily` | `terminal.font_family` | | `terminal.integrated.fontSize` | `terminal.font_size` | @@ -111,7 +111,7 @@ The following VS Code settings are automatically imported when you use **Import **Tabs & Panels** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | -------------------------------------------------- | -------------------------------------------------- | | `workbench.editor.showTabs` | `tab_bar.show` | | `workbench.editor.showIcons` | `tabs.file_icons` | @@ -128,7 +128,7 @@ The following VS Code settings are automatically imported when you use **Import **Project Panel (File Explorer)** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | ------------------------------ | ----------------------------------- | | `explorer.compactFolders` | `project_panel.auto_fold_dirs` | | `explorer.autoReveal` | `project_panel.auto_reveal_entries` | @@ -138,7 +138,7 @@ The following VS Code settings are automatically imported when you use **Import **Git** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | ------------------------------------ | ---------------------------------------------- | | `git.enabled` | `git_panel.button` | | `git.defaultBranchName` | `git_panel.fallback_branch_name` | @@ -147,7 +147,7 @@ The following VS Code settings are automatically imported when you use **Import **Window & Behavior** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | ------------------------------------------------ | ---------------------------------------- | | `window.confirmBeforeClose` | `confirm_quit` | | `window.nativeTabs` | `use_system_window_tabs` | @@ -156,7 +156,7 @@ The following VS Code settings are automatically imported when you use **Import **Other** -| VS Code Setting | Zed Setting | +| VS Code Setting | Gwen Setting | | -------------------------- | ------------------------------------------------------------ | | `http.proxy` | `proxy` | | `npm.packageManager` | `node.npm_path` | @@ -165,7 +165,7 @@ The following VS Code settings are automatically imported when you use **Import | `chat.agent.enabled` | `agent.enabled` | | `mcp` | `context_servers` | -Zed doesn’t import extensions or keybindings, but this import gets core editor behavior close to your VS Code setup. If you skip that step during setup, you can still import settings manually later via the command palette: +Gwen doesn’t import extensions or keybindings, but this import gets core editor behavior close to your VS Code setup. If you skip that step during setup, you can still import settings manually later via the command palette: `Cmd+Shift+P → {#action zed::ImportVsCodeSettings}` @@ -175,25 +175,25 @@ You can configure most settings in the Settings Editor ({#kb zed::OpenSettings}) Here’s how common VS Code settings translate: -| VS Code | Zed | Notes | +| VS Code | Gwen | Notes | | ------------------- | ------------------ | ----------------------------- | -| editor.fontFamily | buffer_font_family | Zed uses Zed Mono by default | +| editor.fontFamily | buffer_font_family | Gwen uses Gwen Mono by default | | editor.fontSize | buffer_font_size | Set in pixels | | editor.tabSize | tab_size | Can override per language | | editor.insertSpaces | insert_spaces | Boolean | | editor.formatOnSave | format_on_save | Works with formatter enabled | | editor.wordWrap | soft_wrap | Supports optional wrap column | -Zed also supports per-project settings. You can find these in the Settings Editor as well. +Gwen also supports per-project settings. You can find these in the Settings Editor as well. ## Open or Create a Project After setup, press `Cmd+O` (`Ctrl+O` on Linux) to open a folder. By default, new folders open in the current window's threads sidebar, letting you work on multiple projects without juggling windows. See [Windows & Projects](../windows-and-projects.md) for details on managing multiple projects and opening in new windows. -To start a new project, create a directory using your terminal or file manager, then open it in Zed. The editor will treat that folder as the root of your project. +To start a new project, create a directory using your terminal or file manager, then open it in Gwen. The editor will treat that folder as the root of your project. -You can also launch Zed from the terminal inside any folder with: -`zed .` +You can also launch Gwen from the terminal inside any folder with: +`gwen .` Once inside a project, use `Cmd+P` to jump between files quickly. `Cmd+Shift+P` (`Ctrl+Shift+P` on Linux) opens the command palette for running actions / tasks, toggling settings, or starting a collaboration session. @@ -204,7 +204,7 @@ Open buffers appear as tabs across the top. The Project Panel shows your file tr If you chose the VS Code keymap during onboarding, most shortcuts should already feel familiar. Here’s a quick reference for where keybindings match and where they differ. -### Common Shared Keybindings (Zed <> VS Code) +### Common Shared Keybindings (Gwen <> VS Code) | Action | Shortcut | | --------------------------- | ---------------------- | @@ -225,16 +225,16 @@ Here’s a quick reference for where keybindings match and where they differ. | Navigate open tabs | `Cmd + Opt + Arrow` | | Syntactic fold / unfold | `Cmd + Opt + {` or `}` | -### Different Keybindings (Zed <> VS Code) +### Different Keybindings (Gwen <> VS Code) -| Action | VS Code | Zed | +| Action | VS Code | Gwen | | ------------------- | --------------------- | ---------------------- | | Open recent project | `Ctrl + R` | `Cmd + Opt + O` | | Move lines up/down | `Opt + Up/Down` | `Cmd + Ctrl + Up/Down` | | Split panes | `Cmd + \` | `Cmd + K, Arrow Keys` | | Expand Selection | `Shift + Alt + Right` | `Opt + Up` | -### Unique to Zed +### Unique to Gwen | Action | Shortcut | Notes | | ------------------- | ---------------------------- | ------------------------------------------------ | @@ -250,16 +250,16 @@ To edit your keybindings: This opens a list of all available bindings. You can override individual shortcuts, remove conflicts, or build a layout that works better for your setup. -Zed also supports chords (multi-key sequences) like `Cmd+K Cmd+C`, like VS Code does. +Gwen also supports chords (multi-key sequences) like `Cmd+K Cmd+C`, like VS Code does. ## Differences in User Interfaces ### Projects and Windows VS Code uses a dedicated Workspace concept, with multi-root folders, `.code-workspace` files, and a clear distinction between “a window” and “a workspace.” -Zed takes a different approach. +Gwen takes a different approach. -In Zed: +In Gwen: - **Multiple projects in one window**: You can open multiple folders in the same window. Each appears in the threads sidebar on the left, and you can switch between them while preserving your layout and agent threads. See [Windows & Projects](../windows-and-projects.md). @@ -269,18 +269,18 @@ In Zed: - **Per-project settings are optional**: You can add a `.zed/settings.json` file inside a project to override global settings. -- **You can start from a single file or an empty window**: Zed doesn’t require you to open a folder to begin editing. +- **You can start from a single file or an empty window**: Gwen doesn’t require you to open a folder to begin editing. The result is flexibility without complexity: multiple projects per window via the sidebar, or multiple folders per project via Add Folder to Project. ### Navigating in a Project In VS Code, the standard entry point is opening a folder. From there, the left-hand panel is central to navigation. -Zed takes a different approach: +Gwen takes a different approach: - You can still open folders, but you don’t need to. Opening a single file or even starting with an empty workspace is valid. - The [Command Palette](../command-palette.md) (`Cmd+Shift+P`) and File Finder (`Cmd+P`) are primary navigation tools. The File Finder searches files, symbols, and commands across the workspace. -- Instead of a persistent panel, Zed encourages you to: +- Instead of a persistent panel, Gwen encourages you to: - Fuzzy-find files by name (`Cmd+P`) - Jump directly to symbols (`Cmd+Shift+O`) - Use split panes and tabs for context, rather than keeping a large file tree open (though you can do this with the Project Panel if you prefer). @@ -289,9 +289,9 @@ The UI keeps auxiliary panels out of the way so navigation stays centered on cod ### Extensions vs. Marketplace -Zed does not offer as many extensions as VS Code. The available extensions are focused on language support, themes, syntax highlighting, and other core editing enhancements. +Gwen does not offer as many extensions as VS Code. The available extensions are focused on language support, themes, syntax highlighting, and other core editing enhancements. -Several features that typically require extensions in VS Code are built into Zed: +Several features that typically require extensions in VS Code are built into Gwen: - Real-time collaboration with voice and cursor sharing (no Live Share required) - AI coding assistance (no Copilot extension needed) @@ -300,11 +300,11 @@ Several features that typically require extensions in VS Code are built into Zed - Task runner with JSON config - Inline diagnostics and code actions via LSP -You won’t find one-to-one replacements for every VS Code extension, especially if you rely on tools for DevOps, containers, or test runners. Zed's extension catalog is still growing and remains smaller. +You won’t find one-to-one replacements for every VS Code extension, especially if you rely on tools for DevOps, containers, or test runners. Gwen's extension catalog is still growing and remains smaller. -### Collaboration in Zed vs. VS Code +### Collaboration in Gwen vs. VS Code -Unlike VS Code, Zed doesn’t require an extension to collaborate. It’s built into the core experience. +Unlike VS Code, Gwen doesn’t require an extension to collaborate. It’s built into the core experience. - Open the Collab Panel in the left dock. - Create a channel and [invite your collaborators](https://zed.dev/docs/collaboration#inviting-a-collaborator) to join. @@ -312,11 +312,11 @@ Unlike VS Code, Zed doesn’t require an extension to collaborate. It’s built Once connected, you’ll see each other's cursors, selections, and edits in real time. Voice chat is included, so you can talk as you work. There’s no need for separate tools or third-party logins. -Learn how [Zed uses Zed](https://zed.dev/blog/zed-is-our-office) to plan work and collaborate. +Learn how [Gwen uses Gwen](https://zed.dev/blog/zed-is-our-office) to plan work and collaborate. -### Using AI in Zed +### Using AI in Gwen -If you’re used to GitHub Copilot in VS Code, you can do the same in Zed. You can also explore other agents through Zed Pro, or bring your own keys and connect without authentication. You can disable AI features entirely if you prefer. +If you’re used to GitHub Copilot in VS Code, you can do the same in Gwen. You can also explore other agents through Gwen Pro, or bring your own keys and connect without authentication. You can disable AI features entirely if you prefer. #### Configuring GitHub Copilot @@ -325,19 +325,19 @@ If you’re used to GitHub Copilot in VS Code, you can do the same in Zed. You c 3. Click **Configure** next to "Configure Providers" 4. Under **GitHub Copilot**, click **Sign in to GitHub** -Once signed in, just start typing. Zed will offer suggestions inline for you to accept. +Once signed in, just start typing. Gwen will offer suggestions inline for you to accept. #### Additional AI Options -To use other AI models in Zed, you have several options: +To use other AI models in Gwen, you have several options: -- Use Zed’s hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Zed Pro](https://zed.dev/docs/account/zed-hosted-models.html). +- Use Gwen’s hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Gwen Pro](https://zed.dev/docs/account/zed-hosted-models.html). - Bring your own [API keys](https://zed.dev/docs/ai/use-api-access.html), no authentication needed - Use [External Agents like Claude Agent](https://zed.dev/docs/ai/external-agents.html). ### Advanced Config and Productivity Tweaks -Zed exposes advanced settings for power users who want to fine-tune their environment. +Gwen exposes advanced settings for power users who want to fine-tune their environment. Here are a few useful tweaks: @@ -365,4 +365,4 @@ Here are a few useful tweaks: ``` **Bring over custom snippets** -Copy your VS Code snippet JSON directly into Zed's snippets folder ({#action snippets::ConfigureSnippets}). +Copy your VS Code snippet JSON directly into Gwen's snippets folder ({#action snippets::ConfigureSnippets}). diff --git a/docs/src/migrate/webstorm.md b/docs/src/migrate/webstorm.md index fc464def5c..d79722f949 100644 --- a/docs/src/migrate/webstorm.md +++ b/docs/src/migrate/webstorm.md @@ -1,15 +1,15 @@ --- -title: How to Migrate from WebStorm to Zed -description: "Guide for migrating from WebStorm to Zed, including settings and keybindings." +title: How to Migrate from WebStorm to Gwen +description: "Guide for migrating from WebStorm to Gwen, including settings and keybindings." --- -# How to Migrate from WebStorm to Zed +# How to Migrate from WebStorm to Gwen -This guide covers how to set up Zed if you're coming from WebStorm, including keybindings, settings, and the differences you should expect as a JavaScript/TypeScript developer. +This guide covers how to set up Gwen if you're coming from WebStorm, including keybindings, settings, and the differences you should expect as a JavaScript/TypeScript developer. -## Install Zed +## Install Gwen -Zed is available on macOS, Windows, and Linux. +Gwen is available on macOS, Windows, and Linux. For macOS, you can download it from zed.dev/download, or install via Homebrew: @@ -23,15 +23,15 @@ For Windows, download the installer from zed.dev/download, or install via winget winget install Zed.Zed ``` -For most Linux users, the easiest way to install Zed is through our installation script: +For most Linux users, the easiest way to install Gwen is through our installation script: ```sh curl -f https://zed.dev/install.sh | sh ``` -After installation, you can launch Zed from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: -`zed .` -This opens the current directory in Zed. +After installation, you can launch Gwen from your Applications folder (macOS), Start menu (Windows), or directly from the terminal using: +`gwen .` +This opens the current directory in Gwen. ## Set Up the JetBrains Keymap @@ -51,7 +51,7 @@ You can configure most settings in the Settings Editor ({#kb zed::OpenSettings}) Settings WebStorm users typically configure first: -| Zed Setting | What it does | +| Gwen Setting | What it does | | ----------------------- | ------------------------------------------------------------------------------- | | `format_on_save` | Auto-format when saving. Set to `"on"` to enable. | | `soft_wrap` | Wrap long lines. Options: `"none"`, `"editor_width"`, `"preferred_line_length"` | @@ -59,18 +59,18 @@ Settings WebStorm users typically configure first: | `inlay_hints` | Show parameter names and type hints inline, like WebStorm's hints. | | `relative_line_numbers` | Useful if you're coming from IdeaVim. | -Zed also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project, similar to how you might use `.idea` folders in WebStorm. +Gwen also supports per-project settings. Create a `.zed/settings.json` file in your project root to override global settings for that project, similar to how you might use `.idea` folders in WebStorm. > **Tip:** If you're joining an existing project, check `format_on_save` before making your first commit. Otherwise you might accidentally reformat an entire file when you only meant to change one line. ## Open or Create a Project -After setup, use {#kb:jetbrains file_finder::Toggle} to open a folder. This becomes your workspace in Zed. Unlike WebStorm, there's no project configuration wizard, no framework selection dialog, and no project structure setup required. +After setup, use {#kb:jetbrains file_finder::Toggle} to open a folder. This becomes your workspace in Gwen. Unlike WebStorm, there's no project configuration wizard, no framework selection dialog, and no project structure setup required. -To start a new project, create a directory using your terminal or file manager, then open it in Zed. The editor will treat that folder as the root of your project. For new projects, you'd typically run `npm init`, `pnpm create`, or your framework's CLI tool first, then open the resulting folder in Zed. +To start a new project, create a directory using your terminal or file manager, then open it in Gwen. The editor will treat that folder as the root of your project. For new projects, you'd typically run `npm init`, `pnpm create`, or your framework's CLI tool first, then open the resulting folder in Gwen. -You can also launch Zed from the terminal inside any folder with: -`zed .` +You can also launch Gwen from the terminal inside any folder with: +`gwen .` Once inside a project: @@ -86,7 +86,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou ### Common Shared Keybindings -| Action | Zed Keybinding | +| Action | Gwen Keybinding | | ----------------------------- | ----------------------------------------------------------------------------------------------------- | | Search Everywhere | {#kb:jetbrains command_palette::Toggle} | | Find Action / Command Palette | {#kb:jetbrains command_palette::Toggle} | @@ -109,9 +109,9 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Go Back / Forward | {#kb:jetbrains pane::GoBack} / {#kb:jetbrains pane::GoForward} | | Toggle Breakpoint | {#kb:jetbrains editor::ToggleBreakpoint} | -### Different Keybindings (WebStorm → Zed) +### Different Keybindings (WebStorm → Gwen) -| Action | WebStorm | Zed (JetBrains keymap) | +| Action | WebStorm | Gwen (JetBrains keymap) | | ---------------------- | ----------- | ------------------------ | | File Structure | `Cmd + F12` | `Cmd + F12` (outline) | | Navigate to Next Error | `F2` | `F2` | @@ -119,7 +119,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou | Debug | `Ctrl + D` | `Alt + Shift + F9` | | Stop | `Cmd + F2` | `Ctrl + F2` | -### Unique to Zed +### Unique to Gwen | Action | Keybinding | Notes | | ----------------- | -------------------------------- | ------------------------------------------------------------- | @@ -133,7 +133,7 @@ If you chose the JetBrains keymap during onboarding, most of your shortcuts shou This opens a list of all available bindings. You can override individual shortcuts or remove conflicts. -Zed also supports key sequences (multi-key shortcuts). +Gwen also supports key sequences (multi-key shortcuts). ## Differences in User Interfaces @@ -141,9 +141,9 @@ Zed also supports key sequences (multi-key shortcuts). If you've used WebStorm on large projects, you know the wait. Opening a project with many dependencies can mean watching "Indexing..." for anywhere from 30 seconds to several minutes. WebStorm indexes your entire codebase and `node_modules` to power its code intelligence, and re-indexes when dependencies change. -Zed doesn't index. You open a folder and start coding immediately—no progress bars, no "Indexing paused" banners. File search and navigation stay fast regardless of project size or how many `node_modules` dependencies you have. +Gwen doesn't index. You open a folder and start coding immediately—no progress bars, no "Indexing paused" banners. File search and navigation stay fast regardless of project size or how many `node_modules` dependencies you have. -WebStorm's index enables features like finding all usages across your entire codebase, tracking import hierarchies, and flagging unused exports project-wide. Zed relies on language servers for this analysis, which may not cover as much ground. +WebStorm's index enables features like finding all usages across your entire codebase, tracking import hierarchies, and flagging unused exports project-wide. Gwen relies on language servers for this analysis, which may not cover as much ground. **How to adapt:** @@ -156,7 +156,7 @@ WebStorm's index enables features like finding all usages across your entire cod WebStorm has its own JavaScript and TypeScript analysis engine built by JetBrains. This engine understands your code deeply: it resolves types, tracks data flow, knows about framework-specific patterns, and offers specialized refactorings. -Zed uses the Language Server Protocol (LSP) for code intelligence. For JavaScript and TypeScript, Zed supports: +Gwen uses the Language Server Protocol (LSP) for code intelligence. For JavaScript and TypeScript, Gwen supports: - **vtsls** (default) — Fast TypeScript language server with excellent performance - **typescript-language-server** — The standard TypeScript LSP implementation @@ -182,13 +182,13 @@ Where you might notice differences: WebStorm manages projects through `.idea` folders containing XML configuration files, framework detection, and run configurations. This model lets WebStorm remember your project settings, manage npm scripts through the UI, and persist run/debug setups. -Zed takes a different approach: a project is just a folder. There's no setup wizard, no framework detection dialog, no project structure to configure. +Gwen takes a different approach: a project is just a folder. There's no setup wizard, no framework detection dialog, no project structure to configure. What this means in practice: - Run configurations aren't a thing. Define reusable commands in `tasks.json` instead. Note that your existing `.idea/` configurations won't carry over—you'll set up the ones you need fresh. - npm scripts live in the terminal. Run `npm run dev`, `pnpm build`, or `yarn test` directly—there's no dedicated npm panel. -- No framework detection. Zed treats React, Angular, Vue, and vanilla JS/TS the same way. +- No framework detection. Gwen treats React, Angular, Vue, and vanilla JS/TS the same way. **How to adapt:** @@ -223,22 +223,22 @@ What this means in practice: WebStorm's value for web development comes largely from its framework integration. React components get special treatment. Angular has dedicated tooling. Vue single-file components are fully understood. The npm tool window shows all your scripts. -Zed has none of this built-in. The TypeScript language server sees your code as TypeScript—it doesn't understand that a function is a React component or that a file is an Angular service. +Gwen has none of this built-in. The TypeScript language server sees your code as TypeScript—it doesn't understand that a function is a React component or that a file is an Angular service. **How to adapt:** - Use grep and file search liberally. {#kb pane::DeploySearch} with a regex can find component definitions, route configurations, or API endpoints. - Rely on your language server's "find references" ({#kb:jetbrains editor::FindAllReferences}) for navigation—it works, just without framework context -- Consider using framework-specific CLI tools (`ng`, `next`, `vite`) from Zed's terminal +- Consider using framework-specific CLI tools (`ng`, `next`, `vite`) from Gwen's terminal - For React, JSX/TSX syntax and TypeScript types still provide good intelligence -> **Tip:** For projects with complex configurations, keep your framework's documentation handy. Zed's speed comes with less hand-holding for framework-specific features. +> **Tip:** For projects with complex configurations, keep your framework's documentation handy. Gwen's speed comes with less hand-holding for framework-specific features. ### Tool Windows vs. Docks -WebStorm organizes auxiliary views into numbered tool windows. Zed uses a similar concept called "docks": +WebStorm organizes auxiliary views into numbered tool windows. Gwen uses a similar concept called "docks": -| WebStorm Tool Window | Zed Equivalent | Zed Keybinding | +| WebStorm Tool Window | Gwen Equivalent | Gwen Keybinding | | -------------------- | -------------- | ------------------------------------------ | | Project | Project Panel | {#kb:jetbrains project_panel::ToggleFocus} | | Git | Git Panel | {#kb:jetbrains git_panel::ToggleFocus} | @@ -247,21 +247,21 @@ WebStorm organizes auxiliary views into numbered tool windows. Zed uses a simila | Problems | Diagnostics | {#kb:jetbrains diagnostics::Deploy} | | Debug | Debug Panel | {#kb:jetbrains debug_panel::ToggleFocus} | -Zed has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. +Gwen has three dock positions: left, bottom, and right. Panels can be moved between docks by dragging or through settings. -Note that there's no dedicated npm tool window in Zed. Use the terminal or define tasks for your common npm scripts. +Note that there's no dedicated npm tool window in Gwen. Use the terminal or define tasks for your common npm scripts. ### Debugging -Both WebStorm and Zed offer integrated debugging for JavaScript and TypeScript: +Both WebStorm and Gwen offer integrated debugging for JavaScript and TypeScript: -- Zed uses `vscode-js-debug` (the same debug adapter that VS Code uses) +- Gwen uses `vscode-js-debug` (the same debug adapter that VS Code uses) - Set breakpoints with {#kb:jetbrains editor::ToggleBreakpoint} - Start debugging with {#kb:jetbrains debugger::Start} - Step through code with {#kb:jetbrains debugger::StepInto} (step into), {#kb:jetbrains debugger::StepOver} (step over), {#kb:jetbrains debugger::StepOut} (step out) - Continue execution with {#kb:jetbrains debugger::Continue} -Zed can debug: +Gwen can debug: - Node.js applications and scripts - Chrome/browser JavaScript @@ -293,17 +293,17 @@ For more control, create a `.zed/debug.json` file: ] ``` -Zed also recognizes `.vscode/launch.json` configurations, so existing VS Code debug setups often work out of the box. +Gwen also recognizes `.vscode/launch.json` configurations, so existing VS Code debug setups often work out of the box. ### Running Tests -WebStorm has a dedicated test runner with a visual interface showing pass/fail status for each test. Zed provides test running through: +WebStorm has a dedicated test runner with a visual interface showing pass/fail status for each test. Gwen provides test running through: - **Gutter icons** — Click the play button next to test functions or describe blocks - **Tasks** — Define test commands in `tasks.json` - **Terminal** — Run `npm test`, `jest`, `vitest`, etc. directly -Zed supports auto-detection for common test frameworks: +Gwen supports auto-detection for common test frameworks: - Jest - Mocha @@ -318,13 +318,13 @@ The test output appears in the terminal panel. For Jest, use `--verbose` for det WebStorm has a plugin catalog covering additional language support, themes, and tool integrations. -Zed's extension catalog is smaller and more focused: +Gwen's extension catalog is smaller and more focused: - Language support and syntax highlighting - Themes - Context servers -Several features that require plugins in WebStorm are built into Zed: +Several features that require plugins in WebStorm are built into Gwen: - Real-time collaboration with voice chat - AI coding assistance @@ -334,9 +334,9 @@ Several features that require plugins in WebStorm are built into Zed: - Prettier formatting - ESLint integration -### What's Not in Zed +### What's Not in Gwen -To set expectations clearly, here's what WebStorm offers that Zed doesn't have: +To set expectations clearly, here's what WebStorm offers that Gwen doesn't have: - **npm tool window** — Use the terminal or tasks instead - **HTTP Client** — Use tools like Postman, Insomnia, or curl @@ -346,9 +346,9 @@ To set expectations clearly, here's what WebStorm offers that Zed doesn't have: - **Built-in REST client** — Use external tools or extensions - **Profiler integration** — Use Chrome DevTools or Node.js profiling tools -## Collaboration in Zed vs. WebStorm +## Collaboration in Gwen vs. WebStorm -WebStorm offers Code With Me as a separate feature for collaboration. Zed has collaboration built into the core experience. +WebStorm offers Code With Me as a separate feature for collaboration. Gwen has collaboration built into the core experience. - Open the Collab Panel in the left dock - Create a channel and [invite your collaborators](https://zed.dev/docs/collaboration#inviting-a-collaborator) to join @@ -356,9 +356,9 @@ WebStorm offers Code With Me as a separate feature for collaboration. Zed has co Once connected, you'll see each other's cursors, selections, and edits in real time. Voice chat is included. There's no need for separate tools or third-party logins. -## Using AI in Zed +## Using AI in Gwen -If you're used to AI assistants in WebStorm (like GitHub Copilot, JetBrains AI Assistant, or Junie), Zed offers similar capabilities with more flexibility. +If you're used to AI assistants in WebStorm (like GitHub Copilot, JetBrains AI Assistant, or Junie), Gwen offers similar capabilities with more flexibility. ### Configuring GitHub Copilot @@ -367,19 +367,19 @@ If you're used to AI assistants in WebStorm (like GitHub Copilot, JetBrains AI A 3. Click **Configure** next to "Configure Providers" 4. Under **GitHub Copilot**, click **Sign in to GitHub** -Once signed in, just start typing. Zed will offer suggestions inline for you to accept. +Once signed in, just start typing. Gwen will offer suggestions inline for you to accept. ### Additional AI Options -To use other AI models in Zed, you have several options: +To use other AI models in Gwen, you have several options: -- Use Zed's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Zed Pro](https://zed.dev/docs/account/zed-hosted-models.html). +- Use Gwen's hosted models, with higher rate limits. Requires [authentication](https://zed.dev/docs/authentication) and access through [Gwen Pro](https://zed.dev/docs/account/zed-hosted-models.html). - Bring your own [API keys](https://zed.dev/docs/ai/use-api-access.html), no authentication needed - Use [External Agents like Claude Agent](https://zed.dev/docs/ai/external-agents.html) ## Advanced Config and Productivity Tweaks -Zed exposes advanced settings for power users who want to fine-tune their environment. +Gwen exposes advanced settings for power users who want to fine-tune their environment. Here are a few useful tweaks for JavaScript/TypeScript developers: @@ -439,12 +439,12 @@ In your `tsconfig.json`, enable strict mode for better type checking: ## Next Steps -Now that you're set up, here are some resources to help you get the most out of Zed: +Now that you're set up, here are some resources to help you get the most out of Gwen: - [All Settings](../reference/all-settings.md) — Customize settings, themes, and editor behavior - [Key Bindings](../key-bindings.md) — Learn how to customize and extend your keymap - [Tasks](../tasks.md) — Set up build and run commands for your projects -- [AI Features](../ai/overview.md) — Explore Zed's AI capabilities beyond code completion +- [AI Features](../ai/overview.md) — Explore Gwen's AI capabilities beyond code completion - [Collaboration](../collaboration/overview.md) — Share your projects and code together in real time -- [JavaScript in Zed](../languages/javascript.md) — JavaScript-specific setup and configuration -- [TypeScript in Zed](../languages/typescript.md) — TypeScript-specific setup and configuration +- [JavaScript in Gwen](../languages/javascript.md) — JavaScript-specific setup and configuration +- [TypeScript in Gwen](../languages/typescript.md) — TypeScript-specific setup and configuration diff --git a/docs/src/modelines.md b/docs/src/modelines.md index 541e44b7ba..12230bc5f1 100644 --- a/docs/src/modelines.md +++ b/docs/src/modelines.md @@ -1,10 +1,10 @@ # Modelines -Modelines are special comments at the beginning or end of a file that configure editor settings for that specific file. Zed supports both Vim and Emacs modeline formats, allowing you to specify settings like tab size, indentation style, and file type directly within your files. +Modelines are special comments at the beginning or end of a file that configure editor settings for that specific file. Gwen supports both Vim and Emacs modeline formats, allowing you to specify settings like tab size, indentation style, and file type directly within your files. ## Configuration -Use the [`modeline_lines`](./reference/all-settings.md#modeline-lines) setting to control how many lines Zed searches for modelines: +Use the [`modeline_lines`](./reference/all-settings.md#modeline-lines) setting to control how many lines Gwen searches for modelines: ```json [settings] { @@ -16,7 +16,7 @@ Set to `0` to disable modeline parsing entirely. ## Emacs -Zed has some compatibility support for [Emacs file variables](https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html). +Gwen has some compatibility support for [Emacs file variables](https://www.gnu.org/software/emacs/manual/html_node/emacs/Specifying-File-Variables.html). Example: @@ -26,7 +26,7 @@ Example: ### Supported Emacs Variables -| Variable | Description | Zed Setting | +| Variable | Description | Gwen Setting | | -------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------ | | `mode` | Major mode/language | Language detection | | `tab-width` | Tab display width | [`tab_size`](./reference/all-settings.md#tab-size) | @@ -38,7 +38,7 @@ Example: ## Vim -Zed has some compatibility support for [Vim modeline](https://vimhelp.org/options.txt.html#modeline). +Gwen has some compatibility support for [Vim modeline](https://vimhelp.org/options.txt.html#modeline). Example: @@ -48,7 +48,7 @@ Example: ### Supported Vim Options -| Option | Aliases | Description | Zed Setting | +| Option | Aliases | Description | Gwen Setting | | -------------- | ------- | --------------------------------- | ------------------------------------------------------------------------------------------ | | `filetype` | `ft` | File type/language | Language detection | | `tabstop` | `ts` | Number of spaces a tab counts for | [`tab_size`](./reference/all-settings.md#tab-size) | diff --git a/docs/src/multibuffers.md b/docs/src/multibuffers.md index 6f9c2493f0..43229ca0b2 100644 --- a/docs/src/multibuffers.md +++ b/docs/src/multibuffers.md @@ -1,11 +1,11 @@ --- -title: Multibuffers - Edit Multiple Files at Once in Zed -description: Edit multiple files simultaneously in Zed using multibuffers. Combine with multi-cursor for fast cross-file refactoring. +title: Multibuffers - Edit Multiple Files at Once in Gwen +description: Edit multiple files simultaneously in Gwen using multibuffers. Combine with multi-cursor for fast cross-file refactoring. --- # Multibuffers -One of the superpowers Zed gives you is the ability to edit multiple files simultaneously. When combined with multiple cursors, this makes wide-ranging refactors significantly faster. +One of the superpowers Gwen gives you is the ability to edit multiple files simultaneously. When combined with multiple cursors, this makes wide-ranging refactors significantly faster. ## Editing in a multibuffer diff --git a/docs/src/outline-panel.md b/docs/src/outline-panel.md index f6c3dc59b2..fe90091d45 100644 --- a/docs/src/outline-panel.md +++ b/docs/src/outline-panel.md @@ -1,11 +1,11 @@ --- -title: Outline Panel - Zed -description: Navigate code structure with Zed's outline panel. View symbols, jump to definitions, and browse file outlines. +title: Outline Panel - Gwen +description: Navigate code structure with Gwen's outline panel. View symbols, jump to definitions, and browse file outlines. --- # Outline Panel -In addition to the modal outline (`cmd-shift-o`), Zed offers an outline panel. The outline panel can be deployed via `cmd-shift-b` ({#action outline_panel::ToggleFocus} via the command palette), or by clicking the `Outline Panel` button in the status bar. +In addition to the modal outline (`cmd-shift-o`), Gwen offers an outline panel. The outline panel can be deployed via `cmd-shift-b` ({#action outline_panel::ToggleFocus} via the command palette), or by clicking the `Outline Panel` button in the status bar. When viewing a "singleton" buffer (i.e., a single file on a tab), the outline panel works similarly to that of the outline modal－it displays the outline of the current buffer's symbols. Each symbol entry shows its type prefix (such as "struct", "fn", "mod", "impl") along with the symbol name, helping you quickly identify what kind of symbol you're looking at. Clicking on an entry allows you to jump to the associated section in the file. The outline view will also automatically scroll to the section associated with the current cursor position within the file. diff --git a/docs/src/performance.md b/docs/src/performance.md index 5ecb906289..86ca1a9c06 100644 --- a/docs/src/performance.md +++ b/docs/src/performance.md @@ -1,9 +1,9 @@ --- title: Rough quick CPU profiling (Flamechart) -description: "Performance profiling and optimization for Zed development." +description: "Performance profiling and optimization for Gwen development." --- -How to use our internal tools to profile and keep Zed fast. +How to use our internal tools to profile and keep Gwen fast. # Rough quick CPU profiling (Flamechart) @@ -33,7 +33,7 @@ fn should_appear_in_profile(kitty: Cat) { } ``` -Then either compile Zed with `ZTRACING=1 cargo r --features tracy --release`. The release build is optional but highly recommended as like every program Zed's performance characteristics change dramatically with optimizations. You do not want to chase slowdowns that do not exist in release. +Then either compile Gwen with `ZTRACING=1 cargo r --features tracy --release`. The release build is optional but highly recommended as like every program Gwen's performance characteristics change dramatically with optimizations. You do not want to chase slowdowns that do not exist in release. ## One time Setup/Building the profiler: @@ -51,7 +51,7 @@ Download the profiler: ## Usage -Open the profiler (tracy-profiler), you should see zed in the list of `Discovered clients` click it. +Open the profiler (tracy-profiler), you should see gwen in the list of `Discovered clients` click it. image @@ -96,7 +96,7 @@ let _enter = span.enter(); // span guard, when this is dropped the span ends (an # Task/Async profiling -Get a profile of the zed foreground executor and background executors. Check if +Get a profile of the gwen foreground executor and background executors. Check if anything is blocking the foreground too long or taking too much (clock) time in the background. @@ -122,7 +122,7 @@ Download the importer ## To Save a Trace: -- Run the action: `zed open performance profiler` +- Run the action: `zed: open performance profiler` - Hit the save button. This opens a save dialog or if that fails to open the trace gets saved in your working directory. - Convert the profile so it can be imported in tracy using the importer: `./tracy-import-miniprofiler output.tracy` - Go to hit the 'power button' in the top left and then open saved trace. diff --git a/docs/src/project-panel.md b/docs/src/project-panel.md index 8619cbc387..300b373417 100644 --- a/docs/src/project-panel.md +++ b/docs/src/project-panel.md @@ -1,6 +1,6 @@ --- -title: Project Panel - Zed -description: Navigate workspace files and directories with Zed's project panel. Create, rename, trash and delete files and directories. +title: Project Panel - Gwen +description: Navigate workspace files and directories with Gwen's project panel. Create, rename, trash and delete files and directories. --- # Project Panel @@ -98,7 +98,7 @@ cancel. - {#action project_panel::Paste} ({#kb project_panel::Paste}) places them in the selected directory. -When pasting would create a name conflict, Zed appends a "copy" suffix (e.g., +When pasting would create a name conflict, Gwen appends a "copy" suffix (e.g., `file copy.txt`, `file copy 2.txt`). If a single file is pasted with a generated suffix, the rename editor opens automatically so you can adjust the name. @@ -209,7 +209,7 @@ The following operations are tracked: - {#action project_panel::Duplicate} Besides these actions, moving items within the panel using drag and drop, as -well as dragging files into the panel from outside Zed, are also tracked. +well as dragging files into the panel from outside Gwen, are also tracked. Undoing a move or rename (for example {#action project_panel::Rename}, a {#action project_panel::Cut} followed by paste, or a drag within the panel) @@ -218,7 +218,7 @@ returns the item to its original name or location. Undoing an operation that creates a file or directory (for example {#action project_panel::NewFile}, {#action project_panel::NewDirectory}, {#action project_panel::Duplicate}, a {#action project_panel::Copy} followed by -paste, or a drag from outside Zed) moves the new item to your system trash +paste, or a drag from outside Gwen) moves the new item to your system trash rather than deleting it. This keeps it recoverable and lets redo restore it, but it also means you may notice these items appear in your trash. @@ -242,12 +242,12 @@ single step, and a failure in one of the operations does not block the rest. - Undoing a {#action project_panel::Trash} restores the item from your system's trash. If you empty the trash, the item can no longer be restored. - Undo and redo act on the current state of the filesystem. If something changed - outside Zed, for example, a conflicting file now exists at the destination, or + outside Gwen, for example, a conflicting file now exists at the destination, or the item was moved or deleted by another program, the operation may no longer - be undoable, and Zed will show a notification accordingly. + be undoable, and Gwen will show a notification accordingly. - On remote hosts without system trash support, {#action project_panel::Trash} will fail when used, along with anything that relies on it, such as undoing a trash or undoing an operation that creates a file or directory. At the time of - writing, Zed does not reliably detect trash support ahead of time, so the + writing, Gwen does not reliably detect trash support ahead of time, so the action is always available but may report an error. -- The undo history is not persisted across sessions, so quitting Zed clears it. +- The undo history is not persisted across sessions, so quitting Gwen clears it. diff --git a/docs/src/reference/all-settings.md b/docs/src/reference/all-settings.md index 69d8eaa91c..e0593d9d0d 100644 --- a/docs/src/reference/all-settings.md +++ b/docs/src/reference/all-settings.md @@ -1,17 +1,17 @@ --- title: All Settings -description: "Complete reference for all Zed settings." +description: "Complete reference for all Gwen settings." --- # All Settings -This is the complete reference for all Zed settings. +This is the complete reference for all Gwen settings. You may also want to change your [theme](../themes.md), configure your [key bindings](../key-bindings.md), set up [tasks](../tasks.md), or install [extensions](../extensions.md). # Settings -The sections below document supported Zed settings. +The sections below document supported Gwen settings. ## Active Pane Modifiers @@ -167,7 +167,7 @@ Open the Settings Editor and search for “Threads Sidebar Default Width”. Or Changing this setting immediately updates the sidebar width, even if you previously resized it manually. You can also double-click the divider to reset the sidebar to the configured width. -Widths saved by older versions of Zed are preserved if they differ from the previous default of 300 pixels. A saved width of 300 pixels uses this setting instead. +Widths saved by older versions of Gwen are preserved if they differ from the previous default of 300 pixels. A saved width of 300 pixels uses this setting instead. ### Threads Sidebar Auto Open {#agent-threads-sidebar-auto-open} @@ -292,19 +292,19 @@ You can find the names of your currently installed extensions by listing the sub On macOS: ```sh -ls ~/Library/Application\ Support/Zed/extensions/installed/ +ls ~/Library/Application\ Support/Gwen/extensions/installed/ ``` On Linux: ```sh -ls ~/.local/share/zed/extensions/installed +ls ~/.local/share/gwen/extensions/installed ``` On Windows: ```pwsh -Get-ChildItem "$env:LOCALAPPDATA\Zed\extensions\installed" -Name +Get-ChildItem "$env:LOCALAPPDATA\Gwen\extensions\installed" -Name ``` Define extensions which should be installed (`true`) or never installed (`false`). @@ -327,7 +327,7 @@ Define extensions which should be installed (`true`) or never installed (`false` **Options** -By default, every installed extension is auto-updated when Zed starts. +By default, every installed extension is auto-updated when Gwen starts. Add an extension here with `false` to pin it to its currently installed version. ```json [settings] @@ -431,15 +431,15 @@ Note that a save will be triggered when an unsaved tab is closed, even if this i - Description: Base key bindings scheme. Base keymaps can be overridden with user keymaps. - Setting: `base_keymap` -- Default: `Zed` +- Default: `Gwen` **Options** -1. Zed +1. Gwen ```json [settings] { - "base_keymap": "Zed" + "base_keymap": "Gwen" } ``` @@ -511,11 +511,11 @@ Note that a save will be triggered when an unsaved tab is closed, even if this i - Description: The name of a font to use for rendering text in the editor. - Setting: `buffer_font_family` -- Default: `.ZedMono`. This currently aliases to [Lilex](https://lilex.myrt.co). +- Default: `.GwenMono`. This currently aliases to [Lilex](https://lilex.myrt.co). **Options** -The name of any font family installed on the user's system, or `".ZedMono"`. +The name of any font family installed on the user's system, or `".GwenMono"`. ## Buffer Font Features @@ -526,7 +526,7 @@ The name of any font family installed on the user's system, or `".ZedMono"`. **Options** -Zed supports all OpenType features that can be enabled or disabled for a given buffer or terminal font, as well as setting values for font features. +Gwen supports all OpenType features that can be enabled or disabled for a given buffer or terminal font, as well as setting values for font features. For example, to disable font ligatures, add the following to your settings: @@ -748,7 +748,7 @@ See [Git documentation](../git.md#diff-view-styles) for more details. ## Disable AI -- Description: Whether to disable all AI features in Zed +- Description: Whether to disable all AI features in Gwen - Setting: `disable_ai` - Default: `false` @@ -883,7 +883,7 @@ For the case of "open", regular selection behavior can be achieved by holding `a List of `string` values. -Use `"..."` to add patterns without repeating Zed's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. +Use `"..."` to add patterns without repeating Gwen's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. ```json [settings] { @@ -901,9 +901,9 @@ Relative patterns are matched against paths relative to the worktree root. Absol ### Prediction Debounce -- Description: How long Zed waits after you stop typing before automatically requesting an edit prediction. +- Description: How long Gwen waits after you stop typing before automatically requesting an edit prediction. - Setting: `edit_predictions..prediction_debounce` -- Default: `75` for GitHub Copilot, `150` for Codestral, and `0` for Zed, Mercury, Ollama, and OpenAI-compatible APIs. +- Default: `75` for GitHub Copilot, `150` for Codestral, and `0` for Gwen, Mercury, Ollama, and OpenAI-compatible APIs. **Options** @@ -1835,7 +1835,7 @@ or ### Session -- Description: Controls Zed lifecycle-related behavior. +- Description: Controls Gwen lifecycle-related behavior. - Setting: `session` - Default: @@ -1919,7 +1919,7 @@ Each option controls displaying of a particular toolbar element. If all elements **Options** -This setting enables integration with macOS's native window tabbing feature. When set to `true`, Zed windows can be grouped together as tabs in a single macOS window, following the system-wide tabbing preferences set by the user (such as "Always", "In Full Screen", or "Never"). This setting is only available on macOS. +This setting enables integration with macOS's native window tabbing feature. When set to `true`, Gwen windows can be grouped together as tabs in a single macOS window, following the system-wide tabbing preferences set by the user (such as "Always", "In Full Screen", or "Never"). This setting is only available on macOS. ## Fullscreen Mode @@ -2073,7 +2073,7 @@ Positive `integer` value between 1 and 32. Values outside of this range will be - `active_encoding_button`: When to show the active encoding button: `"enabled"`, `"disabled"`, or `"non_utf8"` (only for encodings other than UTF-8 without BOM) - `pending_keystrokes_indicator`: Whether to show an indicator while multi-stroke input is pending. If the input has a timeout, a countdown is shown and hovering the indicator pauses it. Its binding preview popover is disabled when the which-key popup is enabled (see [key bindings](../key-bindings.md#precedence)) -There is an experimental setting that completely hides the status bar. This causes major usability problems (you will be unable to use many of Zed's features), but is provided for those who value screen real-estate above all else. +There is an experimental setting that completely hides the status bar. This causes major usability problems (you will be unable to use many of Gwen's features), but is provided for those who value screen real-estate above all else. ```json "status_bar": { @@ -2155,7 +2155,7 @@ While other options may be changed at a runtime and should be placed under `sett - `button`: Whether to show the LSP status button in the status bar - `request_timeout`: The maximum amount of time to wait for responses from language servers, in seconds. A value of `0` will result in no timeout being applied (causing all LSP responses to wait indefinitely until completed). Default: `120` -- `max_buffer_line_length`: The maximum line length a buffer may contain before Zed disables all language server features for that entire buffer. If any line exceeds this value, Zed does not open the buffer with language servers or send them buffer-specific requests. Default: `20000` +- `max_buffer_line_length`: The maximum line length a buffer may contain before Gwen disables all language server features for that entire buffer. If any line exceeds this value, Gwen does not open the buffer with language servers or send them buffer-specific requests. Default: `20000` - `notifications`: Notification-related settings. - `dismiss_timeout_ms`: Timeout in milliseconds for automatically dismissing language server notifications. Set to 0 to disable auto-dismiss. @@ -2210,7 +2210,7 @@ Non-negative `integer` values - Setting: `format_on_save` - Default: `off` -Zed ships `"format_on_save": "on"` as a per-language default for Astro, Dart, EEx, Elixir, Elm, Go, GraphQL, HEEx, Kotlin, Rust, Starlark, and Zig. Every other language uses the top-level default above. Use [`languages`](#languages) to configure individual languages differently. +Gwen ships `"format_on_save": "on"` as a per-language default for Astro, Dart, EEx, Elixir, Elm, Go, GraphQL, HEEx, Kotlin, Rust, Starlark, and Zig. Every other language uses the top-level default above. Use [`languages`](#languages) to configure individual languages differently. **Options** @@ -2279,7 +2279,7 @@ Similar to `modifications`, but behaves like `on` when range formatting cannot b } ``` -Tools that rewrite files on disk instead of printing the formatted contents to stdout (such as `cargo fmt`) are not compatible with `"external"`: since Zed reads the formatted buffer from stdout, a formatter that emits nothing there will not update the buffer. For Rust, use `"formatter": "language_server"` or invoke `rustfmt` directly (which supports stdin/stdout via `--emit stdout`) instead of `cargo fmt`. +Tools that rewrite files on disk instead of printing the formatted contents to stdout (such as `cargo fmt`) are not compatible with `"external"`: since Gwen reads the formatted buffer from stdout, a formatter that emits nothing there will not update the buffer. For Rust, use `"formatter": "language_server"` or invoke `rustfmt` directly (which supports stdin/stdout via `--emit stdout`) instead of `cargo fmt`. 3. External formatters may optionally include a `{buffer_path}` placeholder which at runtime will include the path of the buffer being formatted. Formatters operate by receiving file content via standard input, reformatting it and then outputting it to standard output and so normally don't know the filename of what they are formatting. Tools like Prettier support receiving the file path via a command line argument which can then be used to impact formatting decisions. @@ -2388,7 +2388,7 @@ The result is still `)))` and not `))))))`, which is what it would be by default } ``` -Use `"..."` to add patterns without repeating Zed's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. +Use `"..."` to add patterns without repeating Gwen's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. ```json [settings] { @@ -2410,7 +2410,7 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu } ``` -Use `"..."` to add patterns without repeating Zed's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. +Use `"..."` to add patterns without repeating Gwen's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. ```json [settings] { @@ -2423,7 +2423,7 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu ## File Scan Depth - Setting: `file_scan_depth` -- Description: Maximum directory depth that Zed eagerly indexes outside of git repositories. Directories at this depth or deeper are indexed on demand: when expanded in the project panel or when a file inside them is opened. Contents of directories that were not indexed yet are invisible to the file finder and project search. When directories get deferred, the status bar of the affected window shows a brief "Partial file index" message. Set to `0` to always index everything eagerly and activate all git repositories immediately. +- Description: Maximum directory depth that Gwen eagerly indexes outside of git repositories. Directories at this depth or deeper are indexed on demand: when expanded in the project panel or when a file inside them is opened. Contents of directories that were not indexed yet are invisible to the file finder and project search. When directories get deferred, the status bar of the affected window shows a brief "Partial file index" message. Set to `0` to always index everything eagerly and activate all git repositories immediately. - Default: `5` ```json [settings] @@ -2475,23 +2475,24 @@ In multi-folder projects, depth is measured from each root folder separately. } ``` -When set to `expanded`, symbolic links are only scanned after you explicitly expand them in the project panel. When set to `always`, Zed follows all symbolic links and scans their contents when indexing the project, unless they match gitignore rules. The `always` option may have performance implications for projects with many or deeply nested symlinks. +When set to `expanded`, symbolic links are only scanned after you explicitly expand them in the project panel. When set to `always`, Gwen follows all symbolic links and scans their contents when indexing the project, unless they match gitignore rules. The `always` option may have performance implications for projects with many or deeply nested symlinks. ## File Types - Setting: `file_types` -- Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries. +- Description: Configure how Gwen selects a language for a file based on its filename or extension. Supports glob entries. - Default: ```json [settings] { "file_types": { "JSONC": [ - "**/.zed/**/*.json", - "**/zed/**/*.json", - "**/Zed/**/*.json", - "**/.vscode/**/*.json" + "**/.zed/*.json", + "**/.vscode/**/*.json", + "**/{zed,Zed}/{settings,keymap,tasks,debug}.json", + "tsconfig*.json" ], + "Markdown": [".rules", ".cursorrules", ".windsurfrules", ".clinerules"], "Shell Script": [".env.*"] } } @@ -2979,7 +2980,7 @@ Example: } ``` -Use `"..."` to add patterns without repeating Zed's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. +Use `"..."` to add patterns without repeating Gwen's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. ```json [settings] { @@ -3103,9 +3104,9 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu ## Icon Theme -- Description: The icon theme setting can be specified in two forms - either as the name of an icon theme or as an object containing the `mode`, `dark`, and `light` icon themes for files/folders inside Zed. +- Description: The icon theme setting can be specified in two forms - either as the name of an icon theme or as an object containing the `mode`, `dark`, and `light` icon themes for files/folders inside Gwen. - Setting: `icon_theme` -- Default: `Zed (Default)` +- Default: `Gwen (Default)` ### Icon Theme Object @@ -3117,8 +3118,8 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu { "icon_theme": { "mode": "system", - "dark": "Zed (Default)", - "light": "Zed (Default)" + "dark": "Gwen (Default)", + "light": "Gwen (Default)" } } ``` @@ -3137,8 +3138,8 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu { "icon_theme": { "mode": "dark", - "dark": "Zed (Default)", - "light": "Zed (Default)" + "dark": "Gwen (Default)", + "light": "Gwen (Default)" } } ``` @@ -3149,8 +3150,8 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu { "icon_theme": { "mode": "light", - "dark": "Zed (Default)", - "light": "Zed (Default)" + "dark": "Gwen (Default)", + "light": "Gwen (Default)" } } ``` @@ -3161,8 +3162,8 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu { "icon_theme": { "mode": "system", - "dark": "Zed (Default)", - "light": "Zed (Default)" + "dark": "Gwen (Default)", + "light": "Gwen (Default)" } } ``` @@ -3171,7 +3172,7 @@ Inherited patterns are inserted at `"..."`, and duplicates keep their first occu - Description: The name of the dark icon theme. - Setting: `dark` -- Default: `Zed (Default)` +- Default: `Gwen (Default)` **Options** @@ -3181,7 +3182,7 @@ Run the {#action icon_theme_selector::Toggle} action in the command palette to s - Description: The name of the light icon theme. - Setting: `light` -- Default: `Zed (Default)` +- Default: `Gwen (Default)` **Options** @@ -3258,7 +3259,7 @@ Inlay hints querying consists of two parts: editor (client) and LSP server. When the inlay settings above are changed to enable the hints, the editor will start to query certain types of hints and react on LSP hint refresh request from the server. At this point, the server may or may not return hints depending on its implementation, further configuration might be needed, refer to the corresponding LSP server documentation. -The following languages have inlay hints preconfigured by Zed: +The following languages have inlay hints preconfigured by Gwen: - [Go](../languages/go.md) - [Rust](../languages/rust.md) @@ -3267,7 +3268,7 @@ The following languages have inlay hints preconfigured by Zed: Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation. -Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled. +Hints are not instantly queried in Gwen, two kinds of debounces are used, either may be set to 0 to be disabled. Settings-related hint updates are not debounced. All possible config values for `toggle_on_modifiers_press` are: @@ -3594,7 +3595,7 @@ Positive `integer` values or `null` for unlimited tabs ## Network Proxy -- Description: Configure a network proxy for Zed. +- Description: Configure a network proxy for Gwen. - Setting: `proxy` - Default: `null` @@ -3613,7 +3614,7 @@ The following URI schemes are supported: `http` will be used when no scheme is specified. -By default no proxy will be used, or Zed will attempt to retrieve proxy settings from environment variables, such as `http_proxy`, `HTTP_PROXY`, `https_proxy`, `HTTPS_PROXY`, `all_proxy`, `ALL_PROXY`, `no_proxy` and `NO_PROXY`. +By default no proxy will be used, or Gwen will attempt to retrieve proxy settings from environment variables, such as `http_proxy`, `HTTP_PROXY`, `https_proxy`, `HTTPS_PROXY`, `all_proxy`, `ALL_PROXY`, `no_proxy` and `NO_PROXY`. For example, to set an `http` proxy, add the following to your settings: @@ -3709,7 +3710,7 @@ If you wish to exclude certain hosts from using the proxy, set the `NO_PROXY` en ## Profiles -- Description: Configuration profiles that can be temporarily applied on top of existing settings or Zed's defaults. +- Description: Configuration profiles that can be temporarily applied on top of existing settings or Gwen's defaults. - Setting: `profiles` - Default: `{}` @@ -3719,7 +3720,7 @@ Each profile is an object with the following optional fields: - `base`: What settings to start from before applying the profile's overrides. - `"user"` (default): Apply on top of your current user settings. - - `"default"`: Apply on top of Zed's default settings, ignoring user customizations. + - `"default"`: Apply on top of Gwen's default settings, ignoring user customizations. - `settings`: The settings overrides for this profile. Examples: @@ -3943,7 +3944,7 @@ List of `string` glob patterns } ``` -Use `"..."` to add patterns without repeating Zed's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. +Use `"..."` to add patterns without repeating Gwen's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. ```json [settings] { @@ -4047,7 +4048,7 @@ List of strings containing any combination of: **Options** -1. Restore all workspaces that were open when quitting Zed: +1. Restore all workspaces that were open when quitting Gwen: ```json [settings] { @@ -4536,7 +4537,7 @@ Positive integer values ## Use Auto Surround -- Description: Whether to automatically surround selected text when typing opening parenthesis, bracket, brace, single or double quote characters. For example, when you select text and type '(', Zed will surround the text with (). +- Description: Whether to automatically surround selected text when typing opening parenthesis, bracket, brace, single or double quote characters. For example, when you select text and type '(', Gwen will surround the text with (). - Setting: `use_auto_surround` - Default: `true` @@ -4546,7 +4547,7 @@ Positive integer values ## Use System Path Prompts -- Description: Whether to use the system provided dialogs for Open and Save As. When set to false, Zed will use the built-in keyboard-first pickers. +- Description: Whether to use the system provided dialogs for Open and Save As. When set to false, Gwen will use the built-in keyboard-first pickers. - Setting: `use_system_path_prompts` - Default: `true` @@ -4556,7 +4557,7 @@ Positive integer values ## Use System Prompts -- Description: Whether to use the system provided dialogs for prompts, such as confirmation prompts. When set to false, Zed will use its built-in prompts. Note that on Linux, this option is ignored and Zed will always use the built-in prompts. +- Description: Whether to use the system provided dialogs for prompts, such as confirmation prompts. When set to false, Gwen will use its built-in prompts. Note that on Linux, this option is ignored and Gwen will always use the built-in prompts. - Setting: `use_system_prompts` - Default: `true` @@ -4586,7 +4587,7 @@ List of `integer` column numbers ## Tasks -- Description: Configuration for tasks that can be run within Zed +- Description: Configuration for tasks that can be run within Gwen - Setting: `tasks` - Default: @@ -4604,11 +4605,11 @@ List of `integer` column numbers - `variables`: Custom variables for task configuration - `enabled`: Whether tasks are enabled -- `prefer_lsp`: Whether to prefer LSP-provided tasks over Zed language extension ones +- `prefer_lsp`: Whether to prefer LSP-provided tasks over Gwen language extension ones ## Telemetry -- Description: Control what info is collected by Zed. +- Description: Control what info is collected by Gwen. - Setting: `telemetry` - Default: @@ -4635,7 +4636,7 @@ List of `integer` column numbers ### Metrics -- Description: Setting for sending anonymized usage data, such as what languages you're using Zed with. +- Description: Setting for sending anonymized usage data, such as what languages you're using Gwen with. - Setting: `metrics` - Default: `true` @@ -5308,7 +5309,7 @@ Example command to set the title: `echo -e "\e]2;New Title\007";` } ``` -Use `"..."` to add regexes without repeating Zed's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. Set `[]` to clear it. Omitting this setting keeps the inherited list. +Use `"..."` to add regexes without repeating Gwen's defaults. In project settings, it extends the user or parent configuration value. Omit `"..."` to replace the inherited list. Set `[]` to clear it. Omitting this setting keeps the inherited list. ```json [settings] { @@ -5357,7 +5358,7 @@ Processing stops at the first regex that matches the terminal line, even if the ## Theme -- Description: The theme setting can be specified in two forms - either as the name of a theme or as an object containing the `mode`, `dark`, and `light` themes for the Zed UI. +- Description: The theme setting can be specified in two forms - either as the name of a theme or as an object containing the `mode`, `dark`, and `light` themes for the Gwen UI. - Setting: `theme` - Default: `One Dark` @@ -5423,7 +5424,7 @@ Processing stops at the first regex that matches the terminal line, even if the ### Dark -- Description: The name of the dark Zed theme to use for the UI. +- Description: The name of the dark Gwen theme to use for the UI. - Setting: `dark` - Default: `One Dark` @@ -5433,7 +5434,7 @@ Run the {#action theme_selector::Toggle} action in the command palette to see a ### Light -- Description: The name of the light Zed theme to use for the UI. +- Description: The name of the light Gwen theme to use for the UI. - Setting: `light` - Default: `One Light` @@ -5475,7 +5476,7 @@ Run the {#action theme_selector::Toggle} action in the command palette to see a - `show_user_menu`: Whether to show the user menu button in the titlebar (the one that displays your avatar by default and contains options like Settings, Keymap, Themes, etc.) - `show_sign_in`: Whether to show the sign in button in the titlebar - `show_menus`: Whether to show the menus in the titlebar -- `button_layout`: The layout of window control buttons in the title bar (Linux only). Can be set to `"platform_default"` to follow the system setting, `"standard"` to use Zed's built-in layout, or a custom format like `"close:minimize,maximize"` +- `button_layout`: The layout of window control buttons in the title bar (Linux only). Can be set to `"platform_default"` to follow the system setting, `"standard"` to use Gwen's built-in layout, or a custom format like `"close:minimize,maximize"` ## Window Title Format @@ -5498,7 +5499,7 @@ Available variables: | `fileStem` | File name without extension (e.g. `main`) | | `remoteName` | Display name of the remote connection, if any | | `remoteHost` | Host of the remote connection, if any | -| `appName` | Zed release channel name (e.g. `Zed`, `Zed Nightly`) | +| `appName` | Gwen release channel name (e.g. `Gwen`, `Gwen Nightly`) | | `branch` | Git branch checked out in the active repository | | `separator` | Separator string, omitted when neighbors are empty | @@ -5523,13 +5524,13 @@ Available variables: ## Window Decorations -- Description: Controls whether Zed or the window manager or compositor draws window decorations. +- Description: Controls whether Gwen or the window manager or compositor draws window decorations. - Setting: `window_decorations` - Default: `"client"` **Options** -1. To have Zed draw its own window decorations, use `"client"`: +1. To have Gwen draw its own window decorations, use `"client"`: ```json [settings] { @@ -5545,7 +5546,7 @@ Available variables: } ``` -> Note: This setting only affects Linux. GNOME Wayland does not support server-side decorations. Changes only apply to newly created windows. Restart Zed to apply the setting to all windows. +> Note: This setting only affects Linux. GNOME Wayland does not support server-side decorations. Changes only apply to newly created windows. Restart Gwen to apply the setting to all windows. ## Vim @@ -5571,7 +5572,7 @@ Available variables: **Options** - `enabled`: Whether to show the which-key menu. When enabled, the pending keystrokes indicator remains visible, but its binding preview popover is disabled. -- `delay_ms`: How long Zed waits before showing the menu, in milliseconds. +- `delay_ms`: How long Gwen waits before showing the menu, in milliseconds. ## When Closing With No Tabs @@ -6059,7 +6060,7 @@ Visit [AI Quick Start](../ai/quick-start.md) under the AI section to learn more } ``` -See the [debugger page](../debugger.md) for more information about debugging support within Zed. +See the [debugger page](../debugger.md) for more information about debugging support within Gwen. ## Git Panel @@ -6250,11 +6251,11 @@ Float values between `0.0` and `0.9`, where: - Description: The name of the font to use for text in the UI. - Setting: `ui_font_family` -- Default: `.ZedSans`. This currently aliases to [IBM Plex](https://www.ibm.com/plex/). +- Default: `.GwenSans`. This currently aliases to [IBM Plex](https://www.ibm.com/plex/). **Options** -The name of any font family installed on the system, `".ZedSans"` to use the Zed-provided default, or `".SystemUIFont"` to use the system's default UI font (on macOS and Windows). +The name of any font family installed on the system, `".GwenSans"` to use the Gwen-provided default, or `".SystemUIFont"` to use the system's default UI font (on macOS and Windows). ## UI Font Features @@ -6274,7 +6275,7 @@ The name of any font family installed on the system, `".ZedSans"` to use the Zed **Options** -Zed supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features. +Gwen supports all OpenType features that can be enabled or disabled for a given UI font, as well as setting values for font features. For example, to disable font ligatures, add the following to your settings: @@ -6340,7 +6341,7 @@ For example, to use `Nerd Font` as a fallback, add the following to your setting - Default: `{}` In your `settings.json` file, add the `profiles` object. -Each key within this object is the name of a settings profile. Each profile has an optional `base` field (`"user"` or `"default"`) and a `settings` object containing any of Zed's settings. +Each key within this object is the name of a settings profile. Each profile has an optional `base` field (`"user"` or `"default"`) and a `settings` object containing any of Gwen's settings. Example: @@ -6382,7 +6383,7 @@ To preview and enable a settings profile, open the command palette via {#kb comm ## An example configuration: ```json [settings] -// ~/.config/zed/settings.json +// ~/.config/gwen/settings.json { "theme": "cave-light", "tab_size": 2, @@ -6390,7 +6391,7 @@ To preview and enable a settings profile, open the command palette via {#kb comm "soft_wrap": "none", "buffer_font_size": 18, - "buffer_font_family": ".ZedMono", + "buffer_font_family": ".GwenMono", "autosave": "on_focus_change", "format_on_save": "off", diff --git a/docs/src/reference/cli.md b/docs/src/reference/cli.md index c906b46e94..d37b56a6bb 100644 --- a/docs/src/reference/cli.md +++ b/docs/src/reference/cli.md @@ -1,24 +1,24 @@ --- title: CLI Reference -description: "Reference for Zed's command-line interface (CLI), including opening files and directories, integrating with tools, and controlling Zed from scripts." +description: "Reference for Gwen's command-line interface (CLI), including opening files and directories, integrating with tools, and controlling Gwen from scripts." --- # CLI Reference -Use Zed's command-line interface (CLI) to open files and directories, integrate with other tools, and control Zed from scripts. +Use Gwen's command-line interface (CLI) to open files and directories, integrate with other tools, and control Gwen from scripts. ## Installation -**macOS:** Run the {#action cli::InstallCliBinary} command from the command palette ({#kb command_palette::Toggle}) to install the `zed` CLI to `/usr/local/bin/zed`. +**macOS:** Run the {#action cli::InstallCliBinary} command from the command palette ({#kb command_palette::Toggle}) to install the `gwen` CLI to `/usr/local/bin/gwen`. -**Linux:** The CLI is included with Zed packages. The binary name may vary by distribution (commonly `zed` or `zeditor`). +**Linux:** The CLI is included with Gwen packages, installed as `gwen`. -**Windows:** The CLI is included with Zed. Add Zed's installation directory to your PATH, or use the full path to `zed.exe`. +**Windows:** The CLI is included with Gwen. Add Gwen's installation directory to your PATH, or use the full path to `gwen.exe`. ## Usage ```sh -zed [OPTIONS] [PATHS]... +gwen [OPTIONS] [PATHS]... ``` ## Opening Files and Directories @@ -26,26 +26,26 @@ zed [OPTIONS] [PATHS]... Open a file: ```sh -zed myfile.txt +gwen myfile.txt ``` Open a directory as a workspace: ```sh -zed ~/projects/myproject +gwen ~/projects/myproject ``` Open multiple files or directories: ```sh -zed file1.txt file2.txt ~/projects/myproject +gwen file1.txt file2.txt ~/projects/myproject ``` Open a file at a specific line and column: ```sh -zed myfile.txt:42 # Open at line 42 -zed myfile.txt:42:10 # Open at line 42, column 10 +gwen myfile.txt:42 # Open at line 42 +gwen myfile.txt:42:10 # Open at line 42, column 10 ``` ## Options @@ -54,11 +54,11 @@ zed myfile.txt:42:10 # Open at line 42, column 10 Wait for all opened files to be closed before the CLI exits. When opening a directory, waits until the window is closed. -This is useful for integrating Zed with tools that expect an editor to block until editing is complete (e.g., `git commit`): +This is useful for integrating Gwen with tools that expect an editor to block until editing is complete (e.g., `git commit`): ```sh -export EDITOR="zed --wait" -git commit # Opens Zed and waits for you to close the commit message file +export EDITOR="gwen --wait" +git commit # Opens Gwen and waits for you to close the commit message file ``` ### `-n`, `--new` @@ -66,7 +66,7 @@ git commit # Opens Zed and waits for you to close the commit message file Open paths in a new workspace window, even if the paths are already open in an existing window: ```sh -zed -n ~/projects/myproject +gwen -n ~/projects/myproject ``` ### `-a`, `--add` @@ -74,7 +74,7 @@ zed -n ~/projects/myproject Add paths to the currently focused workspace instead of opening a new window. When multiple workspace windows are open, files open in the focused window: ```sh -zed -a newfile.txt +gwen -a newfile.txt ``` ### `-r`, `--reuse` @@ -82,15 +82,15 @@ zed -a newfile.txt Reuse an existing window, replacing its current workspace with the new paths: ```sh -zed -r ~/projects/different-project +gwen -r ~/projects/different-project ``` ### `-e`, `--existing` -Open paths in an existing Zed window instead of creating a new one: +Open paths in an existing Gwen window instead of creating a new one: ```sh -zed -e myfile.txt +gwen -e myfile.txt ``` By default (without `-n`, `-a`, `-r`, or `-e`), directories open in the current window's sidebar. You can change this default with the `cli_default_open_behavior` setting. See [Windows & Projects](../windows-and-projects.md) for more details. @@ -100,16 +100,16 @@ By default (without `-n`, `-a`, `-r`, or `-e`), directories open in the current Open a diff view comparing two files. Can be specified multiple times: ```sh -zed --diff file1.txt file2.txt -zed --diff old.rs new.rs --diff old2.rs new2.rs +gwen --diff file1.txt file2.txt +gwen --diff old.rs new.rs --diff old2.rs new2.rs ``` ### `--foreground` -Run Zed in the foreground, keeping the terminal attached. Useful for debugging: +Run Gwen in the foreground, keeping the terminal attached. Useful for debugging: ```sh -zed --foreground +gwen --foreground ``` ### `--user-data-dir ` @@ -117,33 +117,33 @@ zed --foreground Use a custom directory for all user data (database, extensions, logs) instead of the default location: ```sh -zed --user-data-dir ~/.zed-custom +gwen --user-data-dir ~/.gwen-custom ``` Default locations: -- **macOS:** `~/Library/Application Support/Zed` -- **Linux:** `$XDG_DATA_HOME/zed` (typically `~/.local/share/zed`) -- **Windows:** `%LOCALAPPDATA%\Zed` +- **macOS:** `~/Library/Application Support/Gwen` +- **Linux:** `$XDG_DATA_HOME/gwen` (typically `~/.local/share/gwen`) +- **Windows:** `%LOCALAPPDATA%\Gwen` ### `-v`, `--version` -Print Zed's version and exit: +Print Gwen's version and exit: ```sh -zed --version +gwen --version ``` ### `--completions ` -Generate shell completions for the `zed` CLI: +Generate shell completions for the `gwen` CLI: #### Bash Add to `~/.bashrc`: ```bash -eval "$(zed --completions bash)" +eval "$(gwen --completions bash)" ``` #### Elvish @@ -151,9 +151,9 @@ eval "$(zed --completions bash)" Add to `~/.config/elvish/rc.elv`: ```elvish -set edit:completion:arg-completer[zed] = { |@args| - eval (zed --completions elvish | slurp) - $edit:completion:arg-completer[zed] $@args +set edit:completion:arg-completer[gwen] = { |@args| + eval (gwen --completions elvish | slurp) + $edit:completion:arg-completer[gwen] $@args } ``` @@ -162,7 +162,7 @@ set edit:completion:arg-completer[zed] = { |@args| Add to `~/.config/fish/config.fish`: ```fish -zed --completions fish | source +gwen --completions fish | source ``` #### Nushell @@ -171,7 +171,7 @@ Add to `~/.config/nushell/config.nu`: ```nu mkdir ($nu.data-dir | path join "vendor/autoload") -^zed --completions nushell | save --force ($nu.data-dir | path join "vendor/autoload/zed.nu") +^gwen --completions nushell | save --force ($nu.data-dir | path join "vendor/autoload/gwen.nu") ``` #### Powershell @@ -179,7 +179,7 @@ mkdir ($nu.data-dir | path join "vendor/autoload") Add to `$PROFILE`: ```powershell -(&zed --completions powershell) | Out-String | Invoke-Expression +(&gwen --completions powershell) | Out-String | Invoke-Expression ``` #### Zsh @@ -187,23 +187,23 @@ Add to `$PROFILE`: Add to `~/.zshrc`: ```zsh -eval "$(zed --completions zsh)" +eval "$(gwen --completions zsh)" ``` ### `--uninstall` -Uninstall Zed and remove all related files (macOS and Linux only): +Uninstall Gwen and remove all related files (macOS and Linux only): ```sh -zed --uninstall +gwen --uninstall ``` ### `--zed ` -Specify a custom path to the Zed application or binary: +Specify a custom path to the Gwen application or binary: ```sh -zed --zed /path/to/Zed.app myfile.txt +gwen --zed /path/to/Gwen.app myfile.txt ``` ## Reading from Standard Input @@ -211,33 +211,33 @@ zed --zed /path/to/Zed.app myfile.txt Read content from stdin by passing `-` as the path: ```sh -echo "Hello, World!" | zed - -cat myfile.txt | zed - -ps aux | zed - +echo "Hello, World!" | gwen - +cat myfile.txt | gwen - +ps aux | gwen - ``` -This creates a temporary file with the stdin content and opens it in Zed. +This creates a temporary file with the stdin content and opens it in Gwen. ## URL Handling The CLI can open `zed://`, `file://`, and `ssh://` URLs: ```sh -zed zed://settings -zed file:///Users/whatever/.zshrc -zed ssh://me@example.com/abs/path -zed ssh://me@example.com:/abs/path -zed ssh://me@example.com/~/project -zed ssh://me@example.com:~/project +gwen zed://settings +gwen file:///Users/whatever/.zshrc +gwen ssh://me@example.com/abs/path +gwen ssh://me@example.com:/abs/path +gwen ssh://me@example.com/~/project +gwen ssh://me@example.com:~/project ``` -## Using Zed as Your Default Editor +## Using Gwen as Your Default Editor -Set Zed as your default editor for Git and other tools: +Set Gwen as your default editor for Git and other tools: ```sh -export EDITOR="zed --wait" -export VISUAL="zed --wait" +export EDITOR="gwen --wait" +export VISUAL="gwen --wait" ``` Add these lines to your shell configuration file (e.g., `~/.bashrc`, `~/.zshrc`). @@ -247,14 +247,14 @@ Add these lines to your shell configuration file (e.g., `~/.bashrc`, `~/.zshrc`) On macOS, you can launch a specific release channel by passing the channel name as the first argument: ```sh -zed --stable myfile.txt -zed --preview myfile.txt -zed --nightly myfile.txt +gwen --stable myfile.txt +gwen --preview myfile.txt +gwen --nightly myfile.txt ``` ## WSL Integration (Windows) -On Windows, the CLI supports opening paths from WSL distributions. This is handled automatically when launching Zed from within WSL. +On Windows, the CLI supports opening paths from WSL distributions. This is handled automatically when launching Gwen from within WSL. ## Exit Codes diff --git a/docs/src/reference/default-key-bindings.md b/docs/src/reference/default-key-bindings.md index cdab04ece5..03267d997b 100644 --- a/docs/src/reference/default-key-bindings.md +++ b/docs/src/reference/default-key-bindings.md @@ -1,6 +1,6 @@ --- title: Default Key Bindings -description: "Reference for Zed's default key bindings." +description: "Reference for Gwen's default key bindings." --- # Default Key Bindings diff --git a/docs/src/remote-development.md b/docs/src/remote-development.md index a3e9420724..2b76ed7f60 100644 --- a/docs/src/remote-development.md +++ b/docs/src/remote-development.md @@ -1,39 +1,39 @@ --- -title: Remote Development in Zed - SSH Workflows -description: Use remote development in Zed to edit code over SSH with local UI performance, remote terminals, language servers, and tasks. +title: Remote Development in Gwen - SSH Workflows +description: Use remote development in Gwen to edit code over SSH with local UI performance, remote terminals, language servers, and tasks. --- # Remote Development -Remote Development lets you edit code on a remote server while running Zed locally. The UI stays responsive because it runs on your machine, while language servers, tasks, and terminals run on the server. +Remote Development lets you edit code on a remote server while running Gwen locally. The UI stays responsive because it runs on your machine, while language servers, tasks, and terminals run on the server. For day-to-day workflows, pair remote development with [Tasks](./tasks.md), [Terminal](./terminal.md), and [Debugger](./debugger.md). ## Overview -Remote development requires two computers, your local machine that runs the Zed UI and the remote server which runs a Zed headless server. The two communicate over SSH, so you will need to be able to SSH from your local machine into the remote server to use this feature. +Remote development requires two computers, your local machine that runs the Gwen UI and the remote server which runs a Gwen headless server. The two communicate over SSH, so you will need to be able to SSH from your local machine into the remote server to use this feature. -![Architectural overview of Zed Remote Development](https://zed.dev/img/remote-development/diagram.png) +![Architectural overview of Gwen Remote Development](https://zed.dev/img/remote-development/diagram.png) -On your local machine, Zed runs its UI, talks to language models, uses Tree-sitter to parse and syntax-highlight code, and stores unsaved changes and recent projects. The source code, language servers, tasks, and the terminal all run on the remote server. [AI features](./ai/overview.md) work in remote sessions, including the Agent Panel and Inline Assistant. +On your local machine, Gwen runs its UI, talks to language models, uses Tree-sitter to parse and syntax-highlight code, and stores unsaved changes and recent projects. The source code, language servers, tasks, and the terminal all run on the remote server. [AI features](./ai/overview.md) work in remote sessions, including the Agent Panel and Inline Assistant. -> **Note:** The original version of remote development sent traffic via Zed's servers. As of Zed v0.157 you can no longer use that mode. +> **Note:** The original version of remote development sent traffic via Gwen's servers. As of Gwen v0.157 you can no longer use that mode. ## Setup -1. Download and install the latest [Zed](https://zed.dev/releases). You need at least Zed v0.159. +1. Download and install the latest [Gwen](https://zed.dev/releases). You need at least Gwen v0.159. 1. Use {#kb projects::OpenRemote} to open the "Remote Projects" dialog. 1. Click "Connect New Server" and enter the command you use to SSH into the server. See [Supported SSH options](#supported-ssh-options) for options you can pass. -1. Your local machine will attempt to connect to the remote server using the `ssh` binary on your path. Assuming the connection is successful, Zed will download the server on the remote host and start it. -1. Once the Zed server is running, you will be prompted to choose a path to open on the remote server. - > **Note:** Zed does not currently handle opening very large directories (for example, `/` or `~` that may have >100,000 files) very well. We are working on improving this, but suggest in the meantime opening only specific projects, or subfolders of very large mono-repos. +1. Your local machine will attempt to connect to the remote server using the `ssh` binary on your path. Assuming the connection is successful, Gwen will download the server on the remote host and start it. +1. Once the Gwen server is running, you will be prompted to choose a path to open on the remote server. + > **Note:** Gwen does not currently handle opening very large directories (for example, `/` or `~` that may have >100,000 files) very well. We are working on improving this, but suggest in the meantime opening only specific projects, or subfolders of very large mono-repos. -For simple cases where you don't need any SSH arguments, you can run `zed ssh://[@][:]/` to open a remote folder/file directly. The CLI also accepts the scp style `zed ssh://[@]:~/project` or `zed ssh://[@]:/absolute/path`. If you'd like to hotlink into an SSH project, use a link of the format: `zed://ssh/[@][:]/`. +For simple cases where you don't need any SSH arguments, you can run `gwen ssh://[@][:]/` to open a remote folder/file directly. The CLI also accepts the scp style `gwen ssh://[@]:~/project` or `gwen ssh://[@]:/absolute/path`. If you'd like to hotlink into an SSH project, use a link of the format: `zed://ssh/[@][:]/`. ## Supported platforms -The remote machine must be able to run Zed's server. The following platforms should work, though note that we have not exhaustively tested every Linux distribution: +The remote machine must be able to run Gwen's server. The following platforms should work, though note that we have not exhaustively tested every Linux distribution: - macOS Catalina or later (Intel or Apple Silicon) - Linux (x86_64 or arm64, we do not yet support 32-bit platforms) @@ -54,7 +54,7 @@ The list of remote servers is stored in your settings file {#kb zed::OpenSetting } ``` -Zed shells out to the `ssh` on your path, and so it will inherit any configuration you have in `~/.ssh/config` for the given host. That said, if you need to override anything you can configure the following additional options on each connection: +Gwen shells out to the `ssh` on your path, and so it will inherit any configuration you have in `~/.ssh/config` for the given host. That said, if you need to override anything you can configure the following additional options on each connection: ```json [settings] { @@ -72,7 +72,7 @@ Zed shells out to the `ssh` on your path, and so it will inherit any configurati } ``` -There are two additional Zed-specific options per connection, `upload_binary_over_ssh` and `nickname`: +There are two additional Gwen-specific options per connection, `upload_binary_over_ssh` and `nickname`: ```json [settings] { @@ -80,24 +80,24 @@ There are two additional Zed-specific options per connection, `upload_binary_ove { "host": "192.168.1.10", "projects": [{ "paths": ["~/code/zed/zed"] }], - // by default Zed will download the server binary from the internet on the remote. + // by default Gwen will download the server binary from the internet on the remote. // When this is true, it'll be downloaded to your laptop and uploaded over SSH. // This is useful when your remote server has restricted internet access. "upload_binary_over_ssh": true, - // Shown in the Zed UI to help distinguish multiple hosts. + // Shown in the Gwen UI to help distinguish multiple hosts. "nickname": "lil-linux" } ] } ``` -If you use the command line to open a connection to a host by doing `zed ssh://192.168.1.10/~/.vimrc`, then extra options are read from your settings file by finding the first connection that matches the host/username/port of the URL on the command line. +If you use the command line to open a connection to a host by doing `gwen ssh://192.168.1.10/~/.vimrc`, then extra options are read from your settings file by finding the first connection that matches the host/username/port of the URL on the command line. -Additionally it's worth noting that while you can pass a password on the command line `zed ssh://user:password@host/~`, we do not support writing a password to your settings file. If you're connecting repeatedly to the same host, you should configure key-based authentication. +Additionally it's worth noting that while you can pass a password on the command line `gwen ssh://user:password@host/~`, we do not support writing a password to your settings file. If you're connecting repeatedly to the same host, you should configure key-based authentication. ## Remote Development on Windows (SSH) -Zed on Windows supports SSH remoting and will prompt for credentials when needed. +Gwen on Windows supports SSH remoting and will prompt for credentials when needed. If you encounter authentication issues, confirm that your SSH key agent is running (e.g., ssh-agent or your Git client's agent) and that ssh.exe is on PATH. @@ -107,7 +107,7 @@ When prompted for credentials, use the graphical askpass dialog. If it doesn't a ## WSL Support -Zed supports opening folders inside of WSL natively on Windows. +Gwen supports opening folders inside of WSL natively on Windows. ### Opening a local folder in WSL @@ -172,15 +172,15 @@ These ports also default to the `localhost` interface on the remote host. If you } ``` -## Zed settings +## Gwen settings When opening a remote project there are three relevant settings locations: -- The local Zed settings (in `~/.zed/settings.json` on macOS or `~/.config/zed/settings.json` on Linux) on your local machine. -- The server Zed settings (in the same place) on the remote server. +- The local Gwen settings (in `~/.zed/settings.json` on macOS or `~/.config/gwen/settings.json` on Linux) on your local machine. +- The server Gwen settings (in the same place) on the remote server. - The project settings (in `.zed/settings.json` or `.editorconfig` of your project) -Both the local Zed and the server Zed read the project settings, but they are not aware of the other's main settings file. +Both the local Gwen and the server Gwen read the project settings, but they are not aware of the other's main settings file. Which settings file you should use depends on the kind of setting you want to make: @@ -194,7 +194,7 @@ In addition any extensions you have installed locally will be propagated to the The remote server will not use your local machine's proxy configuration because they may be under different network policies. If your remote server requires a proxy to access the internet, you must configure it on the remote server itself. -In most cases, your remote server will already have proxy environment variables configured. Zed will automatically use them when downloading language servers, communicating with LLM models, etc. +In most cases, your remote server will already have proxy environment variables configured. Gwen will automatically use them when downloading language servers, communicating with LLM models, etc. If needed, you can set these environment variables in the server's shell configuration (e.g., `~/.bashrc`): @@ -204,7 +204,7 @@ export https_proxy="http://proxy.example.com:8080" export no_proxy="localhost,127.0.0.1" ``` -Alternatively, you can configure the proxy in the remote machine's `~/.config/zed/settings.json` (Linux) or `~/.zed/settings.json` (macOS): +Alternatively, you can configure the proxy in the remote machine's `~/.config/gwen/settings.json` (Linux) or `~/.zed/settings.json` (macOS): ```json { @@ -216,13 +216,13 @@ See the [proxy documentation](./reference/all-settings.md#network-proxy) for sup ## Initializing the remote server -Once you provide the SSH options, Zed shells out to `ssh` on your local machine to create a ControlMaster connection with the options you provide. +Once you provide the SSH options, Gwen shells out to `ssh` on your local machine to create a ControlMaster connection with the options you provide. Any prompts that SSH needs will be shown in the UI, so you can verify host keys, type key passwords, etc. -Once the master connection is established, Zed will check to see if the remote server binary is present in `~/.zed_server` on the remote, and that its version matches the current version of Zed that you're using. +Once the master connection is established, Gwen will check to see if the remote server binary is present in `~/.gwen_server` on the remote, and that its version matches the current version of Gwen that you're using. -If it is not there or the version mismatches, Zed will try to download the latest version. By default, it will download from `https://zed.dev` directly, but if you set: `{"upload_binary_over_ssh":true}` in your settings for that server, it will download the binary to your local machine and then upload it to the remote server. +If it is not there or the version mismatches, Gwen will try to download the latest version. By default, it will download from `https://zed.dev` directly, but if you set: `{"upload_binary_over_ssh":true}` in your settings for that server, it will download the binary to your local machine and then upload it to the remote server. If you'd like to maintain the server binary yourself you can. You can either download our prebuilt versions from [GitHub](https://github.com/zed-industries/zed/releases), or [build your own](https://zed.dev/docs/development): @@ -231,7 +231,7 @@ cargo build --release --package remote_server llvm-objcopy --strip-debug target/release/remote_server ``` -Stripping debug symbols matches the packaging step in [`script/bundle-linux`](https://github.com/zed-industries/zed/blob/main/script/bundle-linux) and keeps the binary closer to the size of Zed's prebuilt downloads. Prefer `llvm-objcopy` because GNU `objcopy` may not understand newer LLVM-emitted CREL sections. +Stripping debug symbols matches the packaging step in [`script/bundle-linux`](https://github.com/zed-industries/zed/blob/main/script/bundle-linux) and keeps the binary closer to the size of Gwen's prebuilt downloads. Prefer `llvm-objcopy` because GNU `objcopy` may not understand newer LLVM-emitted CREL sections. The official Linux release builds a musl/static remote server. If you need that, follow the current target and flags in [`script/bundle-linux`](https://github.com/zed-industries/zed/blob/main/script/bundle-linux); for x86-64 Linux, that looks like: @@ -240,21 +240,21 @@ RUSTFLAGS="-C target-feature=+crt-static" cargo build --release --package remote llvm-objcopy --strip-debug target/x86_64-unknown-linux-musl/release/remote_server ``` -If you do this, you must upload it to `~/.zed_server/zed-remote-server-{RELEASE_CHANNEL}-{VERSION}` on the server, for example `~/.zed_server/zed-remote-server-stable-0.217.3+stable.105.80433cb239e868271457ac376673a5f75bc4adb1`. The version must exactly match the version of Zed itself you are using. +If you do this, you must upload it to `~/.gwen_server/gwen-remote-server-{RELEASE_CHANNEL}-{VERSION}` on the server, for example `~/.gwen_server/gwen-remote-server-stable-0.217.3+stable.105.80433cb239e868271457ac376673a5f75bc4adb1`. The version must exactly match the version of Gwen itself you are using. ## Maintaining the SSH connection -Once the server is initialized, Zed will create new SSH connections (reusing the existing ControlMaster) to run the remote development server. +Once the server is initialized, Gwen will create new SSH connections (reusing the existing ControlMaster) to run the remote development server. Each connection tries to run the development server in proxy mode. This mode will start the daemon if it is not running, and reconnect to it if it is. This way when your connection drops and is restarted, you can continue to work without interruption. -In the case that reconnecting fails, the daemon will not be re-used. That said, unsaved changes are by default persisted locally, so that you do not lose work. You can always reconnect to the project at a later date and Zed will restore unsaved changes. +In the case that reconnecting fails, the daemon will not be re-used. That said, unsaved changes are by default persisted locally, so that you do not lose work. You can always reconnect to the project at a later date and Gwen will restore unsaved changes. -If you are struggling with connection issues, you should be able to see more information in the Zed log `cmd-shift-p Open Log`. If you are seeing things that are unexpected, please file a [GitHub issue](https://github.com/zed-industries/zed/issues/new) or reach out in the #support forums on [Discord](https://zed.dev/community-links). +If you are struggling with connection issues, you should be able to see more information in the Gwen log `cmd-shift-p Open Log`. If you are seeing things that are unexpected, please file a [GitHub issue](https://github.com/zed-industries/zed/issues/new) or reach out in the #support forums on [Discord](https://zed.dev/community-links). ## Supported SSH Options -Under the hood, Zed shells out to the `ssh` binary to connect to the remote server. We create one SSH control master per project, and then use that to multiplex SSH connections for the Zed protocol itself, any terminals you open and tasks you run. We read settings from your SSH config file, but if you want to specify additional options to the SSH control master you can configure Zed to set them. +Under the hood, Gwen shells out to the `ssh` binary to connect to the remote server. We create one SSH control master per project, and then use that to multiplex SSH connections for the Gwen protocol itself, any terminals you open and tasks you run. We read settings from your SSH config file, but if you want to specify additional options to the SSH control master you can configure Gwen to set them. When typing in the "Connect New Server" dialog, you can use bash-style quoting to pass options containing a space. Once you have created a server it will be added to the `"ssh_connections": []` array in your settings file. You can edit the settings file directly to make changes to SSH connections. @@ -268,20 +268,20 @@ Supported options: - `-F` for specifying an `ssh_config` - And also... `-4`, `-6`, `-A`, `-B`, `-C`, `-D`, `-I`, `-K`, `-P`, `-X`, `-Y`, `-a`, `-b`, `-c`, `-i`, `-k`, `-l`, `-m`, `-o`, `-p`, `-w`, `-x`, `-y` -Note that we deliberately disallow some options (for example `-t` or `-T`) that Zed will set for you. +Note that we deliberately disallow some options (for example `-t` or `-T`) that Gwen will set for you. ## Known Limitations -- You can't open files from the remote Terminal by typing the `zed` command. +- You can't open files from the remote Terminal by typing the `gwen` command. ## See also - [Running & Testing](./running-testing.md): Run tasks, terminal commands, and debugger sessions while you work remotely. - [Git Worktrees](./git.md#git-worktrees): Create and switch between linked - Git worktrees. Zed supports the worktree picker in remote projects when the + Git worktrees. Gwen supports the worktree picker in remote projects when the remote connection is active. -- [Configuring Zed](./configuring-zed.md): Manage shared and project settings, +- [Configuring Gwen](./configuring-zed.md): Manage shared and project settings, including `.zed/settings.json`. - [Agent Panel](./ai/agent-panel.md): Use AI workflows in remote projects. - [Remote Development on zed.dev](https://zed.dev/remote-development): Product diff --git a/docs/src/repl.md b/docs/src/repl.md index 9eb6428443..c1d10320d5 100644 --- a/docs/src/repl.md +++ b/docs/src/repl.md @@ -1,13 +1,13 @@ --- -title: REPL - Jupyter Kernels in Zed -description: Run code interactively in Zed with built-in Jupyter kernel support. Execute Python, TypeScript, R, and more inline. +title: REPL - Jupyter Kernels in Gwen +description: Run code interactively in Gwen with built-in Jupyter kernel support. Execute Python, TypeScript, R, and more inline. --- # REPL ## Getting started -Zed's built-in REPL uses [Jupyter kernels](https://docs.jupyter.org/en/latest/projects/kernels.html) so you can run code interactively in regular editor files. +Gwen's built-in REPL uses [Jupyter kernels](https://docs.jupyter.org/en/latest/projects/kernels.html) so you can run code interactively in regular editor files.