Commit Graph

97 Commits

Author SHA1 Message Date
Pedram Amini
df97d674e6 MAESTRO: Add Usage Dashboard and Document Graph documentation to README
Added new "Analytics & Visualization" subsection under Features:
- Usage Dashboard: comprehensive analytics with time ranges, agent comparison,
  activity heatmaps, CSV export, real-time updates, colorblind-friendly palettes
- Document Graph: visual knowledge graph with wiki-links and markdown link discovery,
  force/hierarchical layouts, search/filter, keyboard navigation, external links

Added Usage Dashboard keyboard shortcut (Opt+Cmd+U / Alt+Ctrl+U) to shortcuts table.
2025-12-29 06:23:24 -06:00
Pedram Amini
92b3cc73e7 added doc MCP server information 2025-12-28 12:56:46 -06:00
Pedram Amini
bfa54195e8 ## CHANGES
- Added configurable OS notifications for completed tasks and attention needs 🔔
- Introduced optional text-to-speech summaries with custom piped TTS commands 🗣️
- Added in-app toast notifications with flexible durations, including “Never” ⏱️
- Greatly expanded output filtering docs: global, per-response, regex modes 🔎
- Documented full agent lifecycle: create, edit, delete, and advanced options 🤖
- Added sidebar power features: search, bookmarks, grouping, drag-and-drop 🧲
- Improved keyboard-driven navigation tips across settings and quick actions ⌨️
- Refreshed README screenshots to showcase new Group Chat experience 👥
- Replaced hand-drawn achievement wand with crisp bundled icon asset 
2025-12-28 04:52:44 -06:00
Pedram Amini
8d145f6546 ## CHANGES
- Added a gorgeous main-screen screenshot to README for faster onboarding 🖼️
- Polished batch-stop UI label from “Stopping...” to “Stopping” everywhere 
- Updated MainPanel tests to match the refined stopping button text 🧪
- Refreshed achievement badge styling with sleek purple accent gradients 🎨
- Replaced trophy mini-badge with a signature Maestro wand + sparkle icon 🪄
- Switched default achievement icon rendering to a crisp trophy emoji 🏆
2025-12-28 04:42:12 -06:00
Pedram Amini
6e871565f9 ## CHANGES
- Refreshed README positioning for project-focused, high-velocity multi-agent workflows 🚄
- Added embedded YouTube walkthrough and onboarding demos for faster ramp-up 🎬
- Reorganized docs into clearer Power vs Core feature sections 🧭
- Consolidated feature list into crisp, scannable bullet format 🧾
- Expanded Auto Run narrative for spec-to-execution, long unattended runs ⏱️
- Clarified supported agents and teased future additions users requested 🔮
- Added explicit Requirements section covering agents and optional Git setup 🧰
- Updated keyboard-first links, highlighting mastery tracking and quick actions ⌨️
- Improved session discovery description: import, search, star, resume conversations 🗂️
- Tightened Remote Access messaging as “Mobile Remote Control” with tunneling details 📱
2025-12-28 04:34:22 -06:00
Pedram Amini
a72377d05d docs: center all README screenshots
Wrap all images in <p align="center"> tags for consistent visual presentation.
2025-12-28 04:23:03 -06:00
Pedram Amini
6ce78b55dc ## CHANGES
- Refreshed Git Worktrees README screenshot reference for clearer documentation 📸
- Added new Git Worktrees screenshot asset to docs for updated visuals 🖼️
2025-12-28 04:21:42 -06:00
Pedram Amini
1cd04a935a ## 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 
2025-12-28 04:18:54 -06:00
Pedram Amini
74f6c08f01 OAuth enabled but no valid token found. Starting authentication...
Found expired OAuth token, attempting refresh...
Token refresh successful
## CHANGES

- Revamped README with power features, screenshots, and crisp quick-start flow 🚀
- Added prominent User Docs badge linking to full documentation hub 📚
- Documented Auto Run playbooks for batch checklist execution and history tracking 
- Highlighted Git worktrees for parallel agents on isolated branches instantly 🌿
- Showcased Group Chat with moderator AI for coordinated multi-agent discussions 🗣️
- Introduced Remote Access docs for phone control via QR and tunnels 📱
- Documented `maestro-cli` for headless automation with JSONL scripting support 🧰
- Polished Achievement Card visuals: real GitHub logo and brighter trophies 🏆
- Improved Auto Run summaries by avoiding filename-extension sentence splitting ✍️
- Build and dev tweaks: disable npm rebuild and stop watching without HMR 🛠️
2025-12-28 04:04:27 -06:00
Pedram Amini
59fce66462 docs: align Mintlify theme with Dracula 2025-12-27 01:49:16 -06:00
Pedram Amini
921b3c974f docs: scaffold Mintlify docs 2025-12-27 01:20:52 -06:00
Pedram Amini
f724ef4c8c ## CHANGES
- Refreshed Maestro tagline across README and package metadata for clarity 
- Reset-on-completion now writes working copies into `Runs/` folder consistently 📁
- Auto Run working-copy IPC handler updated for new `Runs/` directory naming 🧭
- Working-copy relative paths now return `Runs/...` for downstream consumers 🔗
- Preload API docs updated to reflect `Runs/` working-copy location 🧩
- AutoRunner Help Modal now points users to `Runs/` audit-log folder 🪟
- Batch processor tracking/comments updated for `Runs/` audit log behavior 🧾
- Test suite updated to expect `Runs/` working-copy paths reliably 🧪
2025-12-26 10:07:57 -06:00
Pedram Amini
2b27208543 ## CHANGES
- “Reset on Completion” now runs from `runs/` working copies, never originals 🛡️
- Working-copy filenames include timestamps and loop info for easy audits 🧾
- Looping playbooks now recreate fresh copies each iteration for consistency 🔁
- Help modal clarifies reset behavior, audit logs, and manual cleanup guidance 💡
- Interruptions no longer require restore steps—source docs stay pristine 
2025-12-26 08:06:04 -06:00
Pedram Amini
87fbf51a36 Merge pull request #91 from denniswebb/fix/issue-86-cli-installation-instructions
Fix Issues #86: CLI installation instructions
2025-12-25 03:32:30 -06:00
Pedram Amini
e7b17d0e8a ## CHANGES
- Renamed “Summarize & Continue” workflow to “Compact & Continue” everywhere 🔄
- Updated context warning sash messaging to encourage compacting at high usage ⚠️
- Refreshed quick actions entry to “Context: Compact” with same shortcut 🧭
- Adjusted tab context menu action label from “Summarize” to “Compact” 🏷️
- Improved low-context toast copy: “Cannot Compact” with clearer thresholds 🛑
- Updated UI tests to assert new “Compact & Continue” button text 🧪
- Reorganized Playground panel layout for cleaner preview and controls flow 🧱
2025-12-24 21:48:18 -06:00
Dennis Webb
13add8b7c6 MAESTRO: Fix Issue #86 - Replace echo with printf in CLI installation instructions
- Changed macOS installation command to use printf instead of echo
- Changed Linux installation command to use printf instead of echo
- Added trailing newline to ensure proper script formatting
- Tested both commands to verify they generate valid executable scripts

The echo command creates literal \n characters instead of actual newlines,
making the generated wrapper scripts invalid. Using printf correctly
interprets escape sequences and generates valid executable scripts.

Fixes #86
2025-12-24 20:03:33 -06:00
Pedram Amini
8e34594abd docs: Add Keyboard Mastery section to README
Document the keyboard mastery gamification feature that tracks shortcut
usage and rewards users for becoming power users. Added:

- New "Keyboard Mastery" section under Keyboard Shortcuts
- Table showing all 5 levels (Beginner 0%, Student 25%, Performer 50%,
  Virtuoso 75%, Keyboard Maestro 100%)
- Description of the celebration system and progress tracking
- Updated feature bullet to mention mastery tracking
2025-12-24 19:57:50 -06:00
Pedram Amini
8b1b848f4d docs: add Summarize & Continue documentation to README
Document the third context management feature that was missing
from the README. All three features (summarize, merge, send to
agent) are now documented with access via right-click and Cmd+K.
2025-12-24 05:36:13 -06:00
Pedram Amini
8b082dba21 refactor: remove keyboard shortcuts for context management features
Remove dedicated shortcuts for mergeSession, sendToAgent, and
summarizeAndContinue. These features remain accessible via tab
right-click menu and Command Palette (Cmd+K).

This resolves a shortcut conflict where mergeSession (Cmd+Shift+M)
conflicted with the existing moveToGroup shortcut.
2025-12-24 05:36:13 -06:00
Pedram Amini
93f4b4b3a7 MAESTRO: Add Context Management documentation to README.md
- Add comprehensive "Context Management" section with merge and transfer docs
- Add keyboard shortcuts (Cmd+Shift+M for merge, Cmd+Shift+A for send to agent)
- Include step-by-step instructions, tips, and use cases
- Document context grooming feature for cross-agent transfers
2025-12-24 05:36:12 -06:00
Pedram Amini
3cf7b23cb7 ## CHANGES
- Updated Discord invite everywhere to new community link for joining! 🚀
- About modal now opens the refreshed Discord invite correctly instantly! 
- Quick Actions “Join Discord” now routes to updated server invite! 🔗
- Bookmark toggle hidden for worktree child sessions to prevent confusion! 🧩
- Collapsed session pills now subdivide segments for worktree parents/children! 🎛️
- Collapsed bookmarks palette now shows only parents, with segmented worktrees! 📌
- Collapsed group palette simplified using reusable segmented pill renderer! 🧱
- Collapsed ungrouped palette now uses segmented pills for clearer status! 🧭
- Unread indicators now appear only on last worktree segment pill! 🔴
- Hover tooltips now work per worktree segment for better visibility! 👀
2025-12-22 09:34:46 -06:00
Pedram Amini
0a6c87c9ab ## CHANGES
- Added Git Worktrees for truly parallel, conflict-free multi-agent development! 🌳
- Introduced Worktree sub-agents nested under parents for clean organization! 🌿
- Built WorktreeConfigModal to manage base paths and watching behavior! ⚙️
- Added one-click Pull Request creation for worktree child sessions! 🔀
- Integrated Create PR actions into sidebar context menus and shortcuts! ⌨️
- Updated git status dropdown with “Configure Worktrees” and PR actions! 🧩
- Reworked Auto Run guidance to promote worktree sessions for parallelism! 🚀
- Removed Auto Run’s embedded worktree UI, simplifying batch runner flow! 🧹
- Simplified playbooks by dropping stored worktree settings entirely! 📓
- Polished tab starring safety by blocking stars on unsaved tabs! 
2025-12-22 00:59:40 -06:00
Pedram Amini
1f344ee802 Add Group Chat section with image 2025-12-20 14:59:00 -06:00
Christian Clauss
223416a5db Fix typo 2025-12-20 18:32:22 +01:00
Pedram Amini
d1274d3c2f POST "https://api.anthropic.com/v1/messages": 429 Too Many Requests {"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed your account's rate limit. Please try again later."},"request_id":"req_011CWHZ4TBc4wsjeoh5KdWfA"} 2025-12-20 01:35:09 -06:00
Pedram Amini
d60c59c1b9 POST "https://api.anthropic.com/v1/messages": 429 Too Many Requests {"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed your account's rate limit. Please try again later."},"request_id":"req_011CWHXwicF3qc7ZLXsc9qGP"} 2025-12-20 01:20:31 -06:00
Pedram Amini
3ad6d97934 MAESTRO: Complete refactoring audit Task 71 - remove dead shortcutMatcher.ts
Removed completely unused shortcutMatcher.ts utility file (105 lines) and its
test file (436 lines). All 3 exports (matchShortcut, isAltMetaShortcut,
isAltMetaNumberShortcut) were dead code - never imported by any application
code. The identical logic exists and is actively used in the
useKeyboardShortcutHelpers hook.
2025-12-19 19:34:28 -06:00
Pedram Amini
797601a688 POST "https://api.anthropic.com/v1/messages": 429 Too Many Requests {"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed your account's rate limit. Please try again later."},"request_id":"req_011CWH51RwMiG7Si6sWHfqRx"} 2025-12-19 19:27:17 -06:00
Pedram Amini
fa2dc5d9fb ## CHANGES
- Added comprehensive debug package generation for troubleshooting issues 🔍
- Debug packages safely exclude sensitive data and conversations 🔐
- Implemented markdown reference copying in image lightbox viewer 📝
- Added delete confirmation dialog for image removal safety ⚠️
- Fixed URL encoding for image paths with special characters 🔗
- Enhanced privacy protections with automatic path sanitization 🛡️
- Improved error handling for missing group chat functions 🐛
- Added quick action support via Cmd/Ctrl+K shortcut 
- Expanded modal now maintains independent edit/preview modes 🎯
- Updated troubleshooting section with Discord and GitHub links 💬
2025-12-19 13:12:52 -06:00
Pedram Amini
4ea390d54b fix: center customize button and show for undetected agents
- Center the Customize button horizontally in agent tiles
- Increase bottom padding on tiles to give button more space
- Show Customize button for all supported agents, even undetected ones
  (so users can set custom path to find agent in non-standard location)
2025-12-18 22:40:58 -06:00
Pedram Amini
9b45b41bd2 OAuth enabled but no valid token found. Starting authentication...
Found expired OAuth token, attempting refresh...
Token refresh successful
I'd be happy to help you create a clean update summary for your Github project! However, I don't see any input provided after "INPUT:" in your message.

Could you please share the changelog, commit history, or release notes that you'd like me to summarize? This could include:

- Git commit messages
- Pull request descriptions
- A changelog file
- Release notes
- Or any other documentation about what changed since the last release

Once you provide that information, I'll create an exciting CHANGES section with clean 10-word bullets and relevant emojis as requested!
2025-12-18 15:54:27 -06:00
Pedram Amini
a68e6e85e8 feat: add MAESTRO_SESSION_RESUMED env var for hook control
Add environment variable that allows agent hooks to differentiate
between new sessions and resumed sessions. Since Maestro spawns a
new process per message (batch mode), session start hooks fire on
every turn. This env var lets users conditionally skip hooks.

- Set MAESTRO_SESSION_RESUMED=1 when --resume or --session flags present
- Document in README with example hook guard
- Add note in Agent Provider UI linking to documentation

Fixes #42

Co-authored-by: TQ White II (@tqwhite)
2025-12-18 15:54:27 -06:00
Pedram Amini
9857b87473 OAuth enabled but no valid token found. Starting authentication...
Found expired OAuth token, attempting refresh...
Token refresh successful
## CHANGES

- Added Aider as a new agent option in the interface 🤖
- Improved agent-specific configuration options in modal dialogs 🔧
- Enhanced playbook dropdown to support longer names dynamically 📏
- Fixed cost tracker widget display for all usage scenarios 💰
- Added back button navigation to the Maestro Wizard interface ⬅️
- Improved markdown generation in wizard document creation flow 📝
- Fixed keyboard shortcut isolation in wizard to prevent conflicts ⌨️
- Enhanced agent output parsing for OpenCode and Codex agents 🔍
- Added YOLO mode argument handling for auto-approval features 
- Renamed "Ungrouped" sections to "Ungrouped Agents" for clarity 📁
2025-12-17 21:43:11 -06:00
Pedram Amini
a17659d408 ## CHANGES
- Added support for **OpenAI Codex** and **OpenCode** agents! 🚀
- Multiple AI coding agents now available beyond Claude Code 🤖
- Custom CLI arguments can be configured per agent type ⚙️
- Resume sessions with agent-specific session ID arguments 🔄
- Fixed race conditions in AutoRun content synchronization 🔧
- Improved performance for long content handling in tests 
- Added canceled log entries when interrupting AI sessions 📝
- Enhanced queued items filtering by active tab context 🎯
- Multi-provider synopsis generation for batch processing tasks 📊
- Updated agent detection to support extensible tool types 🛠️
2025-12-17 13:11:33 -06:00
Pedram Amini
80f4f3ee93 ## CHANGES
- Added git worktree support for parallel Auto Run operations 🌳
- Enable background processing while continuing interactive work freely 🚀
- No more read-only mode when using worktree feature 🔓
- Visual git branch icon indicates active worktree operation 🌿
- Auto-create pull requests when batch processing completes 
- Worktree path computed from base directory plus branch name 📁
- Yellow border and input locks only without worktree enabled 🟡
- Continue editing main repo while Auto Run processes tasks 💪
- Improved documentation explaining worktree setup and benefits 📚
- Enhanced UI indicators for parallel operation status tracking 🎯
2025-12-14 17:56:23 -06:00
mattjay
aa1b6577da docs: add Contributors section to README
Add a Contributors section to recognize project contributors.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-14 14:07:18 -06:00
Pedram Amini
801bc6f9ac OAuth enabled but no valid token found. Starting authentication...
Found expired OAuth token, attempting refresh...
Token refresh successful
# CHANGES

- Removed macOS quarantine label clearing requirement from README 🎉
- Added smart caching for GitHub user profile fetching 🚀
- Enhanced leaderboard with real-time ranking notifications and improvements 📊
- Added personal best tracking for longest run achievements 🏆
- Improved markdown image rendering with better display properties 🖼️
- Added privacy note for email addresses in registration modal 🔒
- Fixed remote image toggle behavior in markdown preview 🔧
- Added quick action shortcut to open Maestro website 🌐
- Enhanced leaderboard API with ranking position feedback system 📈
- Improved GitHub analytics script performance with user caching 
2025-12-13 02:14:29 -06:00
Pedram Amini
ecbe335960 ## CHANGES
- Unread messages now show iPhone-style red notification badge 🔴
- Badge overlaps top-right corner of status indicator beautifully 📍
- Removed separate pulsing green dot for cleaner interface 
- Unified notification system across all session view modes 🎯
- Red badge provides better visibility than previous green dot 👁️
- Consistent positioning using absolute CSS for perfect alignment 📐
- Badge appears only on non-active sessions with unread messages 💬
- Smaller 1.5px size creates subtle yet noticeable alert 🎪
- Updated README to reflect new red badge notification style 📝
- Cleaner visual hierarchy with single indicator per session 🧹
2025-12-12 13:02:46 -06:00
Pedram Amini
c275b9744c Update README.md 2025-12-12 00:05:59 -06:00
Pedram Amini
5b70a1316e feat: Add Discord badge and persist ungrouped collapsed state
- Add Discord community badge with logo to README
- Persist "Ungrouped" folder collapsed state across sessions via useSettings
- Update SessionList tests with new ungroupedCollapsed props
- Add community-data/ to .gitignore

Claude ID: c7150d1e-52ea-43e1-8bdf-4504bbee752e
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-12 00:04:42 -06:00
Pedram Amini
1f66a151a5 Update README.md 2025-12-11 21:18:01 -06:00
Pedram Amini
bd7bb536d0 Enhance README with video links and thumbnails
Added links to video introductions and demos in README.
2025-12-11 20:38:15 -06:00
Pedram Amini
2ff9db3f9e feat: Wizard UI improvements, preparing plan screen, and unread indicator
- Added pulsing green unread indicator for sessions with new messages
- Enhanced PreparingPlanScreen with Austin facts and file creation animations
- Updated SessionList collapse button to require sessions
- Renamed wizard screen title from "Choose Your AI Assistant" to "Choose Your Provider"
- Updated test assertions to match UI text changes
- Documented unread indicator in README

Claude ID: 207f9996-7530-493f-bb99-96a3bb26c6f7
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-11 05:21:34 -06:00
Pedram Amini
a89a5f4315 README update 2025-12-10 01:05:51 -06:00
Pedram Amini
ade482a8ae OAuth enabled but no valid token found. Starting authentication...
Found expired OAuth token, attempting refresh...
Token refresh successful
## CHANGES

- Added theme screenshots documentation link to README 🎨
- Fixed search shortcut from `/` to `Cmd+F` everywhere ⌨️
- Improved auto-run folder change button label clarity 📁
- Enhanced git commit count display showing X of TOTAL 📊
- Added parallel fetching for git log and commit count 
- Fixed branch mismatch check for non-git directories 🐛
- Improved search match scrolling in edit mode accuracy 📍
- Added onMatchesRendered callback for preview search scrolling 🔍
- Updated all keyboard shortcut documentation to Cmd+F 📚
- Bumped version from 0.7.0 to 0.7.3 🚀
2025-12-10 01:01:31 -06:00
Pedram Amini
f47b122d80 # CHANGES
- Added custom tab name template variable {{TAB_NAME}} support 🏷️
- Enhanced AutoRun expanded modal with integrated controls header 🎛️
- Added template autocomplete to AI Commands panel editor 🤖
- Fixed modal z-index layering for proper isolation 🎨
- Updated achievement card timeline section with new title 🏆
- Added comprehensive test coverage for new autocomplete features 
- Improved AutoRun modal with mode toggle in header bar 🔄
- Added image upload button to expanded AutoRun edit mode 🖼️
- Added help button integration in expanded modal header 
- Maintained backwards compatibility with SESSION_NAME alias 🔗
2025-12-09 23:30:18 -06:00
Pedram Amini
21898a331e feat: History panel enhancements - navigation, search, scroll persistence, styling
- Add Prev/Next navigation buttons to HistoryDetailModal with left/right arrow key bindings
- Filter-aware navigation (respects AUTO/USER visibility settings)
- Add session ID search capability (long and short octet form)
- Persist scroll position across session switches using module-level cache
- Fix random scroll-to-top on external refresh by preserving state during refresh
- Enhanced validated entry styling (solid green background, white checkmarks)
- Activity graph now supports configurable lookback via right-click context menu
  (24h, 72h, 1 week, 2 weeks, 1 month, 6 months, 1 year, all time)

Claude ID: e2360cc6-54db-411f-9b53-c39ee8212c2a
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-09 10:18:18 -06:00
Pedram Amini
372e6f4f83 refactor: rename template vars to agent-centric naming, fix Dracula theme
- Rename session/project variables to agent-centric naming:
  - {{SESSION_NAME}} -> {{AGENT_NAME}}
  - {{PROJECT_PATH}} -> {{AGENT_PATH}}
  - Legacy aliases preserved for backwards compatibility
- Fix Dracula theme to use actual Dracula color palette
- Add Cmd+Shift+P shortcut for Prompt Composer
- Fix history entry usageStats to track per-task metrics
- Update README template variable documentation
- Fix SessionList tests for Ungrouped section behavior
- Update test cases to match new variable naming
- Remove COMPLETED_TARGETS.md

Claude ID: c756d389-b10d-438d-a76a-e2ba42c157aa
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-08 23:50:38 -06:00
Pedram Amini
b2a91c3c69 feat: add update check feature to hamburger menu and Command K
Adds ability to check for updates from GitHub releases:
- New update-checker.ts module that fetches releases from GitHub API
- UpdateCheckModal.tsx shows current vs latest version, versions behind count,
  and expandable release notes for each version
- Accessible via hamburger menu "Check for Updates" and Command K palette
- Includes upgrade instructions noting that data persists when updating
- Updates README.md with improved description and upgrade instructions

Also includes minor refactoring of ExecutionQueueIndicator pill calculation.

Session: 24e07ddb-7b12-4c03-b4ba-5c863d8a11fe
2025-12-08 17:57:21 -06:00
Pedram Amini
8d9a76ae87 feat: add spec-driven workflow docs, token stats, and remote image toggle
- Update README with spec-driven development intro and workflow section
- Add total tokens tracking to Claude session stats computation
- Display token count in Session Explorer aggregate stats
- Add Globe toggle in FilePreview to show/hide remote images in markdown

Claude ID: 7141edc5-2280-4215-a66e-b743475a26c4
Maestro ID: b9bc0d08-5be2-4fdf-93cd-5618a8d53b35
2025-12-08 17:22:13 -06:00