tkmind/tkmind_go
1
0
Fork 0
Code Issues Pull Requests Actions 4 Packages Projects Releases Wiki Activity

Docs: goose session export and goose session import (#5267)

Browse Source
This commit is contained in:
Rizel Scarlett
2025-10-23 18:33:52 -04:00
committed by GitHub
parent d2f4658d93
commit 6e76bb825c
3 changed files with 57 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files
documentation/docs/guides/sessions/session-management.md
+37 -12
View File
@@ -5,10 +5,10 @@ sidebar_label: Session Management
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import { AppWindow, PanelLeft, FolderDot, Paperclip, Copy, Edit2, Trash2 } from 'lucide-react';
import { AppWindow, PanelLeft, FolderDot, Paperclip, Copy, Edit2, Trash2, Download, Upload } from 'lucide-react';
A session is a single, continuous interaction between you and Goose, providing a space to ask questions and prompt action. This guide covers how to manage the session lifecycle.
A session is a single, continuous interaction between you and goose, providing a space to ask questions and prompt action. This guide covers how to manage the session lifecycle.
## Start Session
@@ -130,7 +130,7 @@ Search allows you to find specific content within sessions or find specific sess
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
You can use keyboard shortcuts and search bar buttons to search sessions in Goose Desktop.
You can use keyboard shortcuts and search bar buttons to search sessions in goose Desktop.
| Action | macOS | Windows/Linux |
|--------|-------|---------------|
@@ -314,7 +314,7 @@ You can resume a CLI session in Desktop.
6. Confirm the deletion in the modal that appears
:::warning Permanent deletion
Deleting a session from Goose Desktop will also delete it from the CLI. This action cannot be undone.
Deleting a session from goose Desktop will also delete it from the CLI. This action cannot be undone.
:::
The session will be immediately removed from your session history and the underlying session file will be deleted from your local storage.
@@ -324,22 +324,47 @@ You can resume a CLI session in Desktop.
</TabItem>
</Tabs>
## Export Sessions
Export sessions to Markdown to share with your team, create documentation, archive conversations, or review them in a readable format.
## Import Sessions
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
Session export is currently only available through the CLI.
Import complete sessions from JSON files to restore, share, or migrate sessions between goose instances. Importing creates a new session with a new ID rather than overwriting existing sessions.
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
2. Click `History` in the sidebar
3. Click the <Upload className="inline" size={16} /> `Import Session` button in the top-right corner
4. Select a `.json` session file that was previously exported from goose
5. The session will be imported with a new session ID
6. A success notification will confirm the import
</TabItem>
<TabItem value="cli" label="goose CLI">
Export sessions using the `export` subcommand:
Session import is currently only available through the Desktop app.
</TabItem>
</Tabs>
## Export Sessions
<Tabs groupId="interface">
<TabItem value="ui" label="goose Desktop" default>
Export complete sessions as JSON files for backup, sharing, migration, or archival. Exported files preserve all session data including conversation history, metadata, and settings.
1. Click the <PanelLeft className="inline" size={16} /> button in the top-left to open the sidebar
2. Click `History` in the sidebar
3. Find the session you want to export
4. Hover over the session card to reveal the action buttons
5. Click the <Download className="inline" size={16} /> button that appears
6. The session will be downloaded as a `.json` file named after the session description
</TabItem>
<TabItem value="cli" label="goose CLI">
Export sessions for backup, sharing, migration, or documentation purposes. You can export as JSON files to preserve complete session data including conversation history, metadata, and settings, or as Markdown files to get a formatted, readable version of the conversation.
From your terminal, run the [`session export`](/docs/guides/goose-cli-commands#session-export-options) subcommand:
```bash
# Interactive export - prompts you to select a session
goose session export
```
For more details on export options, available flags, and output formats, see the [CLI commands documentation](/docs/guides/goose-cli-commands#session-export-options).
</TabItem>
</Tabs>