Skip to main content
Maestro provides context-aware search that adapts to what you’re viewing. Press Cmd+F anywhere to search - the behavior changes based on your current view. The same shortcut (Cmd+F) performs different searches depending on context:
Search AI Output or Terminal HistoryWhen the main panel is focused, Cmd+F searches the active conversation or terminal output.Features:
  • Case-insensitive by default
  • Regex support (toggle with button)
  • Jump to next/previous match
  • Match count display
  • Persistent across scrolling
Shortcut: src/renderer/constants/shortcuts.ts:102-106
Search within AI conversations with advanced filtering:

​
Search Features

Enable regex mode for advanced pattern matching:
function\s+\w+     # Find function declarations
import.*from       # Find import statements
\b\d{3}-\d{4}\b    # Find phone numbers
Toggle: Click the .* button in the search bar
Toggle case-sensitive search:
  • Default: Case-insensitive (“test” matches “Test”, “TEST”, “test”)
  • Case-sensitive: Exact match (“test” only matches “test”)
Toggle: Click the Aa button in the search bar
Jump between matches:
Enter              # Next match
Shift+Enter        # Previous match
The current match index and total count are displayed:
2 / 15 matches
All matches are highlighted in the output with:
  • Yellow background for all matches
  • Orange background for the current/active match
  • Auto-scroll to bring current match into view

​
Search Interface

The search bar appears at the top of the main panel: 
// Search state
interface SearchState {
  query: string;           // Search text
  isRegex: boolean;        // Regex mode enabled
  caseSensitive: boolean;  // Case-sensitive search
  currentIndex: number;    // Current match (0-based)
  totalMatches: number;    // Total match count
}
Search terminal history with the same interface:

​
Terminal-Specific Features

  • ANSI code stripping: Searches the text content, ignoring terminal escape codes
  • Command boundaries: Jump between command outputs
  • Scroll lock: Searching disables auto-scroll to preserve results
Filter: src/main/utils/terminalFilter.ts

​
Auto-Scroll Control

Control whether output auto-scrolls to bottom: 
Alt+Cmd+S          # Toggle auto-scroll AI output
Features:
  • Auto-scroll ON: New output scrolls into view automatically
  • Auto-scroll OFF: Output stays at current scroll position
  • Smart resume: Scrolling to bottom manually re-enables auto-scroll
Shortcut: src/renderer/constants/shortcuts.ts:71-75
Pro Tip: Disable auto-scroll when searching or reviewing earlier output. Re-enable it by scrolling to the bottom or pressing Cmd+Shift+J.

​
Jump to Bottom

Instantly scroll to the latest output: 
Cmd+Shift+J        # Jump to bottom of output
This also re-enables auto-scroll if it was disabled. Shortcut: src/renderer/constants/shortcuts.ts:57

​
Output Display Modes

​
Thinking Display

Control how AI reasoning/thinking content is shown: 
Cmd+Shift+K        # Toggle show thinking
Modes: 
type ThinkingMode = 'off' | 'on' | 'sticky';
ModeBehavior
OffThinking is suppressed (never shown)
OnThinking shown while streaming, cleared when response completes
StickyThinking shown and remains visible after response
Setting: Per-tab in src/renderer/types/index.ts:AITab Shortcut: src/renderer/constants/shortcuts.ts:157-161

​
Markdown Rendering

Toggle between rendered markdown and raw text: 
Cmd+E              # Toggle edit/preview mode (in file preview)
In AI output, markdown is always rendered with:
  • Syntax highlighting for code blocks
  • Tables with borders and alignment
  • Links as clickable URLs
  • Images with zoom on click
  • Mermaid diagrams rendered as SVG
Renderer: src/renderer/components/TerminalOutput.tsx

​
Filtering History

The History panel provides advanced filtering:

​
Filter Options

1

Open History

Press Cmd+Shift+H or click the History tab in the Right Bar.
2

Search

Press Cmd+F to open the search bar.Search fields:
  • Entry summary
  • Full response content
  • Session name
3

Filter by Type

Toggle filters:
  • AUTO - Auto Run entries only
  • USER - User-initiated prompts only
  • ALL - Show everything (default)
4

Filter by Success

Show only:
  • Successful responses (no errors)
  • Failed responses (errors occurred)
  • All responses
Component: src/renderer/components/HistoryPanel.tsx Search your saved notes: 
Cmd+Shift+O        # Open Director's Notes
Cmd+F              # Search notes (when modal is open)
Features:
  • Full-text search across all notes
  • Filter by tags
  • Sort by date or title
  • Regex support
Shortcut: src/renderer/constants/shortcuts.ts:76-80, 107-111 Search system logs: 
Alt+Cmd+L          # Open System Log Viewer
Cmd+F              # Search logs (when viewer is open)
Features:
  • Filter by log level (debug, info, warn, error)
  • Search by message content
  • Time range filtering
  • Regex patterns
Component: src/renderer/components/LogViewer.tsx Shortcut: src/renderer/constants/shortcuts.ts:50, 101

​
Search Performance

Large outputs use virtual scrolling to render only visible content:
  • Handles millions of lines efficiently
  • Search still finds matches in off-screen content
  • Auto-scroll to matches works seamlessly
Complex regex patterns are compiled once and reused:
// Cached regex compilation
const regex = useMemo(
  () => new RegExp(pattern, flags),
  [pattern, flags]
);

​
Keyboard Shortcuts

# Context-Aware Search
Cmd+F              # Search (adapts to current view)

# Search Navigation
Enter              # Next match
Shift+Enter        # Previous match
Esc                # Close search / clear filter

# Output Control
Cmd+Shift+J        # Jump to bottom
Alt+Cmd+S          # Toggle auto-scroll

# Display Modes
Cmd+Shift+K        # Toggle show thinking (AI mode)
Cmd+E              # Toggle edit/preview (file preview)

# Specialized Search
Cmd+G              # Fuzzy file search
Cmd+Shift+L        # View agent sessions (searchable)
Alt+Cmd+L          # System log viewer (searchable)
Cmd+Shift+O        # Director's Notes (searchable)

​
Tips for Effective Searching

Instead of searching for specific values, search for patterns:
\berror\b          # Find "error" as whole word
TODO:.*            # Find all TODO comments
\d{1,3}\.\d{1,3}   # Find version numbers
Before asking the AI to “find that thing we discussed”, search History:
  • Faster than re-asking
  • Shows exact context
  • Includes token usage stats
  1. Disable auto-scroll (Alt+Cmd+S)
  2. Search for pattern
  3. Review all matches without output moving
  4. Jump to bottom (Cmd+Shift+J) to resume
Create custom AI commands for frequent searches:
// Settings → Custom AI Commands
{
  command: '/errors',
  prompt: 'Find all error messages in the output',
  aiOnly: true
}

​
Next Steps

Keyboard Shortcuts

Master all search shortcuts

File Explorer

Filter and search file trees

Git Integration

Search git diffs and logs

Dual-Mode Sessions

Search in both AI and terminal modes

Build docs developers (and LLMs) love

Get started for freeTalk to us