MAESTRO: Fix history.md documentation inaccuracies

- Correct time range options (8 options, not 4)
- Add Cmd+F shortcut for search filter
- Fix settings toggle location description
- Add /clear as third method for USER entries
- Add arrow key navigation in detail view
- Add platform-specific storage paths
- Add Help Panel section
- Improve keyboard navigation documentation
This commit is contained in:
Pedram Amini
2026-01-11 05:37:48 -06:00
parent bbb01d8abf
commit 7afb999b46

View File

@@ -27,13 +27,15 @@ Auto entries are created automatically when Auto Run completes a task. Each entr
### User Entries
User entries are created in two ways:
User entries are created in three ways:
1. **History Toggle** — Enable the **History** pill in the AI input box. Every prompt-response cycle automatically creates a user history entry.
2. **`/history` Command** — Run `/history` to create a synopsis entry covering all activity since the last time you ran the command. This is useful for periodic summaries without logging every single interaction.
**Toggle the default History behavior** in Settings → toggle "Save to History by default".
3. **`/clear` Command** — Running `/clear` automatically creates a history entry before clearing the conversation, preserving a synopsis of your work.
**Toggle the default History behavior** in Settings → General → "Enable 'History' by default for new tabs".
## Filtering History
@@ -46,20 +48,24 @@ Use the **AUTO** and **USER** filter buttons at the top of the History panel to
### By Keyword
Type in the search box to filter entries by keyword. The search matches against:
Press `Cmd+F` / `Ctrl+F` to open the search box, or click in the filter area to type. The search matches against:
- Entry summaries
- Session IDs
- Any text content in the entry
- Session names and IDs
- Full response content
### By Time Range
The **Graph View** at the top shows activity distribution over time. **Right-click the graph** to change the time range:
- Last 24 hours
- Last 7 days
- Last 30 days
- 24 hours
- 72 hours
- 1 week
- 2 weeks
- 1 month
- 6 months
- 1 year
- All time
The graph bars are clickable — click a time period to jump to entries from that window.
The graph bars are clickable — click a time period to jump to entries from that window. Hover over any bar to see the exact count and time range.
## Entry Details
@@ -77,9 +83,9 @@ The detail view shows:
### Navigation
- **Prev / Next** buttons to navigate between entries
- **Prev / Next** buttons to navigate between entries (or use `←` / `→` arrow keys)
- **Close** button to return to the list view
- **Delete** button to remove the entry
- **Delete** button to remove the entry (with confirmation dialog)
## Validating Entries
@@ -115,12 +121,31 @@ This is especially powerful for Auto Run tasks — you can pick up exactly where
## Keyboard Navigation
### List View
| Key | Action |
|-----|--------|
| `↑` / `↓` | Navigate between entries |
| `Enter` | Open detail view for selected entry |
| `Cmd+F` / `Ctrl+F` | Open search filter |
| `Esc` | Clear selection or close search |
### Detail View
| Key | Action |
|-----|--------|
| `←` / `→` | Navigate to previous/next entry |
| `Esc` | Close detail view, return to list |
## Storage
History is stored per-session in `~/Library/Application Support/Maestro/history/`. Each session maintains up to 5,000 entries. History files can be passed to AI agents as context for understanding past work patterns.
History is stored per-session in JSON files within the `history/` subdirectory of your Maestro data folder:
- **macOS**: `~/Library/Application Support/maestro/history/<sessionId>.json`
- **Windows**: `%APPDATA%/maestro/history/<sessionId>.json`
- **Linux**: `~/.config/maestro/history/<sessionId>.json`
Each session maintains up to **5,000 entries**. History files can be passed to AI agents as context for understanding past work patterns.
## Help Panel
Click the **?** button in the History panel header to open a detailed guide explaining all features, entry types, status indicators, and keyboard shortcuts.