## CHANGES

- Upgraded README screenshots to consistent HTML `<img>` tags with sizing 📸
- Improved visual polish with standardized widths across all key images 🖼️
- Refreshed Auto Run screenshots with updated, current UI captures 🔄
- Cleaned up screenshot layout spacing for smoother scanning and readability ✨
- Made screenshot accessibility better with explicit `alt` text everywhere ♿

README.md

@@ -8,7 +8,7 @@
 
 Maestro is a cross-platform desktop app for orchestrating your fleet of AI coding agents. Built for power users who live on the keyboard and rarely touch the mouse.
 
-![Maestro Main Screen](docs/screenshots/main-screen.png)
+<img src="docs/screenshots/main-screen.png" alt="Maestro Main Screen" width="800">
 
 Run multiple agents in parallel with a Linear/Superhuman-level responsive interface. Currently supporting **Claude Code**, **OpenAI Codex**, and **OpenCode** with plans for additional agentic coding tools based on user demand.
 
@@ -17,28 +17,28 @@ Run multiple agents in parallel with a Linear/Superhuman-level responsive interf
 ### Auto Run & Playbooks
 Batch-process markdown checklists through AI agents. Create task documents with checkboxes, and Maestro works through them automatically—spawning fresh AI sessions for each task with clean context. Save configurations as playbooks for repeatable workflows, run in loops, and track everything in history.
 
-![Auto Run](docs/screenshots/autorun-1.png)
+<img src="docs/screenshots/autorun-1.png" alt="Auto Run" width="400">
 
 [Learn more about Auto Run](https://docs.runmaestro.ai/autorun-playbooks)
 
 ### Git Worktrees
 Run AI agents in parallel on isolated branches. Create worktree sub-agents from the git branch menu, each operating in their own directory. Work interactively in the main repo while sub-agents process tasks independently—then create PRs with one click.
 
-![Git Worktrees](docs/screenshots/git-worktree-list.png)
+<img src="docs/screenshots/git-worktree-list.png" alt="Git Worktrees" width="400">
 
 [Learn more about Git Worktrees](https://docs.runmaestro.ai/git-worktrees)
 
 ### Group Chat
 Coordinate multiple AI agents in a single conversation. A moderator AI orchestrates discussions, routing questions to the right agents and synthesizing their responses for cross-project questions and architecture discussions.
 
-![Group Chat](docs/screenshots/group-chat.png)
+<img src="docs/screenshots/group-chat.png" alt="Group Chat" width="800">
 
 [Learn more about Group Chat](https://docs.runmaestro.ai/group-chat)
 
 ### Remote Access
 Built-in web server with QR code access. Monitor and control all your agents from your phone. Supports local network access and remote tunneling via Cloudflare for access from anywhere—no account required.
 
-![Mobile Interface](docs/screenshots/mobile-chat.png)
+<img src="docs/screenshots/mobile-chat.png" alt="Mobile Interface" width="300">
 
 [Learn more about Remote Access](https://docs.runmaestro.ai/remote-access)
 
@@ -96,13 +96,16 @@ npm run dev
 
 ## Screenshots
 
-![Command Palette](docs/screenshots/cmd-k-1.png)
+<img src="docs/screenshots/cmd-k-1.png" alt="Command Palette" width="800">
+
 *Quick Actions palette for rapid navigation*
 
-![Git Diff Viewer](docs/screenshots/git-diff.png)
+<img src="docs/screenshots/git-diff.png" alt="Git Diff Viewer" width="800">
+
 *Side-by-side diff viewer with syntax highlighting*
 
-![Themes](docs/screenshots/themes.png)
+<img src="docs/screenshots/themes.png" alt="Themes" width="800">
+
 *12 beautiful themes to match your style*
 
 [See more...](docs/screenshots/)