UI Layout & Navigation | Maestro Docs

Fresh

Maestro uses a three-panel layout optimized for multi-agent orchestration.

Panel Overview

Left Panel — Agent Management

The agent list supports:

Grouping — Organize agents by project or domain
Filtering — Search by name or filter by status
Bookmarks — Quick access to frequently used agents (Ctrl+Shift+B)
Drag-and-drop — Reorder agents freely
Color status indicators:

Color	Meaning
Green	Ready
Yellow	Thinking / Processing
Red	Disconnected
Pulsing Orange	Connecting
Red Dot Badge	Unread messages

Navigation shortcuts:

Ctrl+[ / Ctrl+] — Previous / Next agent
Alt+Ctrl+1-9 — Jump to agent by number
Ctrl+Shift+M — Move agent to group
Ctrl+Shift+Backspace — Remove agent

Main Panel — Workspace

Switch between two modes with Ctrl+J:

AI Terminal Mode

Multiple tabs — Each tab is an independent session
@file mentions — Type @ to insert file references
Image attachments — Drag-and-drop or paste images
Slash commands — Type / for autocomplete
Draft auto-save — Unsent messages are preserved

Command Terminal Mode

Full PTY shell — Tab completion for files, branches, tags
Command history — Navigate with Up Arrow

Additional Views

Session Explorer (Ctrl+Shift+L) — Browse all sessions across all providers
File Preview — Syntax highlighting, markdown preview, image viewing, edit in-place
Git Diffs (Ctrl+Shift+D) — View staged and unstaged changes
Git Logs (Ctrl+Shift+G) — Browse commit history

Right Panel — Context

Three tabs accessible via shortcuts:

Tab	Shortcut	Purpose
Files	`Ctrl+Shift+F`	File explorer with breadcrumbs, syntax highlighting, markdown preview, edit in-place
History	`Ctrl+Shift+H`	Timestamped activity log (AUTO/USER entries)
Auto Run	`Ctrl+Shift+1`	Task runner panel for markdown checklists

Panel Toggle Shortcuts

Alt+Ctrl+Left — Toggle left panel
Alt+Ctrl+Right — Toggle right panel

Tab Management

Action	Shortcut
New Tab	`Ctrl+T`
Close Tab	`Ctrl+W`
Close All	`Ctrl+Shift+W`
Reopen Closed	`Ctrl+Shift+T` (up to 25)
Previous/Next Tab	`Ctrl+Shift+[` / `Ctrl+Shift+]`
Tab Switcher	`Alt+Ctrl+T`
Jump to Tab 1-9	`Ctrl+1-9`
Last Tab	`Ctrl+0`

Input & Output

Action	Key
Send Message	`Enter` or `Ctrl+Enter` (configurable)
Multiline Input	`Shift+Enter`
Command History	`Up Arrow` in input
Slash Commands	Type `/`
File Picker	Type `@`
Search Output	`Ctrl+F` in output
Scroll Output	`Up/Down Arrow` in output
Page Up/Down	`Alt+Up/Down` in output
Jump Top/Bottom	`Ctrl+Up/Down` in output

Output Filtering

Global filter: Applies to all output (click filter icon in toolbar)
Per-response filter: Hover response → click filter icon
Modes: Include (green +) or Exclude (red -)
Matching: Plain text (case-insensitive) or Regex (toggle Aa / .*)

See Also

Keyboard Shortcuts — Complete reference
Auto Run — The right panel's Auto Run tab
History — The right panel's History tab