jlengrand/Maestro
1
0
Fork 0
mirror of https://github.com/jlengrand/Maestro.git synced 2026-03-10 08:31:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

MAESTRO: docs: Fix context-management.md accuracy issues

Browse Source 
- Add "Requires Session" column to Tab Menu table with availability conditions
- Add missing tab menu actions: Export as HTML, Publish as GitHub Gist, Move to First/Last Position
- Fix Tab Export section to reference "Export as HTML" instead of "Context: Copy to Clipboard"
- Change "Right-click" to "Hover over" in three sections (hover overlay, not right-click menu)
- Correct Command Palette labels to match actual QuickActionsModal implementation
- Document alternative sharing options (Copy to Clipboard, Publish as GitHub Gist)
This commit is contained in:
Pedram Amini
2026-01-11 05:21:13 -06:00
parent e37f98047f
commit b319f79511
1 changed files with 23 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/context-management.md
View File

@@ -10,16 +10,20 @@ Hover over any tab with an established session to access the tab menu overlay:
![Tab Menu](./screenshots/tab-menu.png)
| Action | Description |
|--------|-------------|
| **Copy Session ID** | Copy the session ID to clipboard (for session continuity) |
| **Star Session** | Bookmark this session for quick access |
| **Rename Tab** | Give the tab a descriptive name |
| **Mark as Unread** | Add unread indicator to the tab |
| **Context: Copy to Clipboard** | Copy the full conversation to clipboard |
| **Context: Compact** | Compress context while preserving key information |
| **Context: Merge Into** | Merge this context into another session |
| **Context: Send to Agent** | Transfer context to a different agent |
| Action | Requires Session | Description |
|--------|------------------|-------------|
| **Copy Session ID** | Yes | Copy the session ID to clipboard (for session continuity) |
| **Star Session** | Yes | Bookmark this session for quick access |
| **Rename Tab** | Yes | Give the tab a descriptive name |
| **Mark as Unread** | Yes | Add unread indicator to the tab |
| **Export as HTML** | No (1+ logs) | Export conversation as self-contained HTML file |
| **Context: Copy to Clipboard** | No (1+ logs) | Copy the full conversation to clipboard |
| **Context: Compact** | No (5+ logs) | Compress context while preserving key information |
| **Context: Merge Into** | Yes | Merge this context into another session |
| **Context: Send to Agent** | Yes | Transfer context to a different agent |
| **Context: Publish as GitHub Gist** | No (1+ logs) | Share conversation as a public or secret GitHub Gist (requires `gh` CLI) |
| **Move to First Position** | No | Move this tab to the first position |
| **Move to Last Position** | No | Move this tab to the last position |
### Tab Close Operations
@@ -54,8 +58,8 @@ These actions are also available via **Quick Actions** (`Cmd+K` / `Ctrl+K`) with
Export any tab conversation as a self-contained HTML file:
1. Right-click the tab → **Context: Copy to Clipboard**
2. Or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Export tab to HTML"
1. Hover over the tab → **Export as HTML**
2. Choose a save location when prompted
The exported HTML file includes:
- **Full conversation history** with all messages
@@ -66,6 +70,10 @@ The exported HTML file includes:
This is useful for sharing conversations, creating documentation, or archiving important sessions.
**Alternative sharing options:**
- **Context: Copy to Clipboard** — Copy the raw conversation text to clipboard (for pasting into documents or chat)
- **Context: Publish as GitHub Gist** — Share as a public or secret GitHub Gist (requires `gh` CLI to be installed)
---
Context management lets you combine or transfer conversation history between sessions and agents, enabling powerful workflows where you can:
@@ -116,7 +124,7 @@ Customize warning thresholds in **Settings** (`Cmd+,` / `Ctrl+,`) → **General*
When your conversation approaches context limits, you can compress it while preserving essential information:
1. **Right-click** a tab → **"Context: Compact"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Compact"
1. **Hover over** a tab → **"Context: Compact"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Compact"
2. The AI compacts the conversation, extracting key decisions, code changes, and context
3. A new tab opens with the compressed context, ready to continue working
@@ -174,7 +182,7 @@ During compaction, you'll see status updates:
Combine context from multiple sessions or tabs into one:
1. **Right-click** a tab → **"Context: Merge Into"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Merge with another session"
1. **Hover over** a tab → **"Context: Merge Into"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Merge Into"
2. Search for or select the target session/tab from the modal
3. Review the merge preview showing estimated token count
4. Optionally enable **Clean context** to remove duplicates and reduce size
@@ -204,7 +212,7 @@ The merged context creates a new tab in the target session with conversation his
Transfer your context to a different AI agent:
1. **Right-click** a tab → **"Context: Send to Agent"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Send to another agent"
1. **Hover over** a tab → **"Context: Send to Agent"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Send to Agent"
2. Search for or select the target agent from the list
3. Review the token estimate and cleaning options
4. Click **"Send to Session"**