docs: mid-session changes (#6672)

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
@@ -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
@@ -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>