ai-space/goose
3
0
Fork 0
mirror of https://github.com/aaif-goose/goose.git synced 2026-07-03 14:10:03 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: mid-session changes (#6672)

Browse Source 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
dianed-square
2026-01-23 12:11:18 -08:00
committed by GitHub
parent c1a916efd9
commit bb82c062b1
3 changed files with 110 additions and 45 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/docs/getting-started/using-extensions.md
+56 -22
View File
@@ -5,7 +5,7 @@ title: Using Extensions
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import { PanelLeft, Settings } from 'lucide-react';
import { PanelLeft, Settings, Puzzle } from 'lucide-react';
Extensions are add-ons that provide a way to extend the functionality of goose by connecting with applications and tools you already use in your workflow. These extensions can be used to add new features, access data and resources, or integrate with other systems.
@@ -328,38 +328,72 @@ extensions:
## Enabling/Disabling Extensions
You can enable or disable installed extensions based on your workflow needs.
You can enable or disable installed extensions at any time, either as defaults for new sessions or to change the extensions you're using in the current session.
### Set Default Extensions for New Sessions
Changes made to your default extensions apply to future sessions. Updates to these settings do not affect any currently active sessions.
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar.
2. Click the `Extensions` button on the sidebar.
2. Use the toggle switch next to each extension to enable or disable it.
3. Use the toggle switch next to an extension to enable or disable it.
</TabItem>
<TabItem value="cli" label="goose CLI">
1. Run the following command to open up goose's configurations:
```sh
goose configure
```
2. Select `Toggle Extensions` from the menu.
3. A list of already installed extensions will populate.
4. Press the `space bar` to toggle the extension. Solid means enabled.
**Example:**
1. Run the following command to open up goose's configurations:
```sh
goose configure
```
2. Select `Toggle Extensions` from the menu.
3. A list of already installed extensions will populate.
4. Press the `space bar` to toggle the extension. Solid means enabled.
```
┌ goose-configure
│
◇ What would you like to configure?
│ Toggle Extensions
│
◆ enable extensions: (use "space" to toggle and "enter" to submit)
│ ◼ developer
│ ◻ fetch
└
```
**Example:**
```
┌ goose-configure
│
◇ What would you like to configure?
│ Toggle Extensions
│
◆ enable extensions: (use "space" to toggle and "enter" to submit)
│ ◼ developer
│ ◻ fetch
└
```
</TabItem>
</Tabs>
### Change Extensions Mid-Session
Changes made during a session preserve your current conversation without starting over. Mid-session changes apply only to the current chat session and do not change your default extensions for new sessions.
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
1. Click the <Puzzle className="inline" size={16} /> button at the bottom of the app.
2. Use the toggle switch next to an extension to enable or disable it.
</TabItem>
<TabItem value="cli" label="goose CLI">
Add extensions during an interactive session with slash commands:
**Add a stdio extension:**
```bash
/extension npx -y @modelcontextprotocol/server-memory
```
**Add built-in extension:**
```bash
/builtin developer
```
</TabItem>
</Tabs>
documentation/docs/guides/sessions/in-session-actions.md
+36 -1
View File
@@ -5,7 +5,7 @@ sidebar_label: In-Session Actions
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import { PanelLeft, Paperclip, Edit2, Send, GripVertical, X, ChevronUp, ChevronDown } from 'lucide-react';
import { PanelLeft, Paperclip, Edit2, Send, GripVertical, X, ChevronUp, ChevronDown, FolderDot, Puzzle, Bot, Tornado } from 'lucide-react';
goose provides features you can use to manage conversations and share information during sessions.
@@ -288,3 +288,38 @@ Provide goose with context from your codebase, documents, and other files to get
```
</TabItem>
</Tabs>
## Mid-Session Changes
You can change some settings during a session and they will take effect immediately, rather than requiring you to start a new session. This gives you more control over context and capabilities while you're interacting with goose.
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
Use the toolbar at the bottom of the app to change supported settings mid-session:
| Setting | Toolbar Item | Persistence* |
|---------|--------------|-------------|
| **Working Directory** | <FolderDot className="inline" size={16} /> directory switcher | New sessions (after restart) |
| [**Enabled Extensions**](/docs/getting-started/using-extensions#change-extensions-mid-session) | <Puzzle className="inline" size={16} /> icon | Current session only |
| [**Model**](/docs/getting-started/providers#configure-provider-and-model) | <Bot className="inline" size={16} /> model switcher | New sessions |
| [**goose Mode**](/docs/guides/goose-permissions#configuring-goose-mode) | <Tornado className="inline" size={16} /> mode switcher | New sessions |
</TabItem>
<TabItem value="cli" label="goose CLI">
Use the slash commands to change supported settings mid-session:
| Setting | Slash Command | Persistence* |
|---------|--------------|-------------|
| [**Enabled Extensions**](/docs/getting-started/using-extensions#change-extensions-mid-session) | `/extension` or `/builtin` | Current session only |
| [**goose Mode**](/docs/guides/goose-permissions#configuring-goose-mode) | `/mode [options]` | New sessions |
:::info
The CLI supports [additional slash commands](/docs/guides/goose-cli-commands#slash-commands) but doesn't support mid-session changes to the working directory or model.
:::
</TabItem>
</Tabs>
*Persistence indicates whether changes apply to your current session only or carry over to new sessions
documentation/docs/guides/sessions/session-management.md
+18 -22
View File
@@ -18,39 +18,35 @@ In your first session, goose prompts you to [set up an LLM (Large Language Model
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
When you open goose, you'll see the session interface ready for use. Just type&mdash;[or speak](/docs/guides/sessions/in-session-actions#voice-dictation "Learn how to enable voice dictation")&mdash;your questions, requests, or instructions directly into the input field, and goose will immediately get to work.
When you're ready to work on a new task, you can start a new session in the same directory or a different one. This directory is where goose reads and writes files by default.
When you open goose, you'll see the session interface ready for use. Just type&mdash;[or speak](/docs/guides/sessions/in-session-actions#voice-dictation "Learn how to enable voice dictation")&mdash;your questions, requests, or instructions directly into the input field, and goose will immediately get to work.
<Tabs>
<TabItem value="same-directory" label="Same Directory" default>
You can also start a new session at any time, either in the same goose window or in a new one.
To start a session in the same goose window:
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
2. Click `Home` in the sidebar
3. Send your first prompt from the chat box
<Tabs groupId="window-type">
<TabItem value="same-window" label="Same Window" default>
To start a session in a new goose window:
1. Click the <AppWindow className="inline" size={16} /> button in the top-left
2. In the new goose window, send your first prompt from the chat box
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
2. Click `Home` in the sidebar
3. Send your first prompt from the chat box
</TabItem>
<TabItem value="new-window" label="New Window">
</TabItem>
<TabItem value="diff-directory" label="Different Directory">
1. Click the <AppWindow className="inline" size={16} /> button in the top-left
2. In the new window, send your first prompt from the chat box
1. Click the <FolderDot className="inline" size={16} /> directory switcher at the bottom of the app
2. Navigate to the new directory or create a new folder
3. Click `Open` to open a new goose window for the selected directory
4. Send your first prompt from the chat box
</TabItem>
</TabItem>
</Tabs>
To change your working directory, click the <FolderDot className="inline" size={16} /> directory switcher at the bottom of the app.
:::tip
On macOS, you can use the goose dock icon to quickly start sessions:
- **Drag and drop** a folder onto the goose icon to open a new session in that directory
- **Right-click** the goose icon and select `New Window` to open a new session in your most recent directory
:::
#### Keyboard Shortcuts
You can also use keyboard shortcuts to start a new session or manage goose windows.
| Action | macOS | Windows/Linux |
@@ -412,4 +408,4 @@ You can resume a CLI session in Desktop.
```
</TabItem>
</Tabs>
</Tabs>