docs: mid-session changes (#6672)
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -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—[or speak](/docs/guides/sessions/in-session-actions#voice-dictation "Learn how to enable voice dictation")—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—[or speak](/docs/guides/sessions/in-session-actions#voice-dictation "Learn how to enable voice dictation")—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>
|
||||
|
||||
Reference in New Issue
Block a user