mirror of
https://github.com/jlengrand/Maestro.git
synced 2026-03-10 08:31:19 +00:00
Merge remote-tracking branch 'origin/token-donations' into 0.15.0-rc
# Conflicts: # docs/releases.md
This commit is contained in:
Pedram Amini
11
docs/CLAUDE.md
Normal file
11
docs/CLAUDE.md
Normal file
@@ -0,0 +1,11 @@
|
||||
<claude-mem-context>
|
||||
# Recent Activity
|
||||
|
||||
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
|
||||
|
||||
### Jan 11, 2026
|
||||
|
||||
| ID | Time | T | Title | Read |
|
||||
|----|------|---|-------|------|
|
||||
| #413 | 5:34 AM | 🔵 | History Documentation Content Loaded for Verification | ~412 |
|
||||
</claude-mem-context>
|
||||
176
docs/SYMPHONY_ISSUES.md
Normal file
176
docs/SYMPHONY_ISSUES.md
Normal file
@@ -0,0 +1,176 @@
|
||||
# Creating Symphony Issues
|
||||
|
||||
Maintainers create GitHub Issues to define contribution opportunities for the Symphony community.
|
||||
|
||||
## Overview
|
||||
|
||||
Symphony issues are standard GitHub issues with the `runmaestro.ai` label. The issue body contains paths to Auto Run documents that define the work to be done. When a contributor starts working on an issue, a draft PR is automatically created to claim it.
|
||||
|
||||
## Issue Requirements
|
||||
|
||||
1. **Label**: Add the `runmaestro.ai` label to the issue
|
||||
2. **Title**: Clear description of the contribution (e.g., "Add unit tests for user module")
|
||||
3. **Body**: List the Auto Run document paths (one per line)
|
||||
|
||||
## Issue Body Format
|
||||
|
||||
Simply list the paths to your Auto Run documents:
|
||||
|
||||
```
|
||||
.maestro/autorun/add-user-tests.md
|
||||
.maestro/autorun/add-user-tests-2.md
|
||||
```
|
||||
|
||||
That's it! No special formatting required. The system will:
|
||||
- Parse the `.md` file paths from the issue body
|
||||
- Clone your repository when a contributor starts
|
||||
- Run each document in sequence via Auto Run
|
||||
- Create a PR with all changes
|
||||
|
||||
### Supported Path Formats
|
||||
|
||||
The following formats are recognized:
|
||||
|
||||
```markdown
|
||||
# Bare paths (recommended)
|
||||
.maestro/autorun/task-1.md
|
||||
.maestro/autorun/task-2.md
|
||||
|
||||
# Markdown list items
|
||||
- .maestro/autorun/task-1.md
|
||||
- `.maestro/autorun/task-2.md`
|
||||
|
||||
# Numbered lists
|
||||
1. .maestro/autorun/task-1.md
|
||||
2. .maestro/autorun/task-2.md
|
||||
```
|
||||
|
||||
## Example Issue
|
||||
|
||||
**Title**: Add comprehensive tests for the authentication module
|
||||
|
||||
**Labels**: `runmaestro.ai`
|
||||
|
||||
**Body**:
|
||||
```markdown
|
||||
Add test coverage for the authentication module.
|
||||
|
||||
Documents to process:
|
||||
.maestro/autorun/auth-unit-tests.md
|
||||
.maestro/autorun/auth-integration-tests.md
|
||||
.maestro/autorun/auth-e2e-tests.md
|
||||
|
||||
## Context
|
||||
|
||||
The `src/auth/` module currently has low test coverage. These documents will guide the AI to add comprehensive tests following our existing patterns.
|
||||
|
||||
## Expected Outcome
|
||||
|
||||
- Unit tests for all public functions
|
||||
- Integration tests for auth flow
|
||||
- E2E tests for login/logout
|
||||
|
||||
Estimated time: ~45 minutes of AI agent time.
|
||||
```
|
||||
|
||||
## Auto Run Document Format
|
||||
|
||||
Each `.md` file should be a complete Auto Run document:
|
||||
|
||||
```markdown
|
||||
# Task: Add Unit Tests for Auth Module
|
||||
|
||||
## Context
|
||||
The authentication module at `src/auth/` needs test coverage.
|
||||
|
||||
## Objectives
|
||||
- [ ] Create `src/__tests__/auth.test.ts`
|
||||
- [ ] Add tests for `login()` function
|
||||
- [ ] Add tests for `logout()` function
|
||||
- [ ] Add tests for `refreshToken()` function
|
||||
- [ ] Ensure `npm test` passes
|
||||
- [ ] Verify coverage > 80%
|
||||
|
||||
## Constraints
|
||||
- Use Jest testing framework
|
||||
- Follow existing test patterns in the codebase
|
||||
- Do not modify production code
|
||||
```
|
||||
|
||||
### Document Best Practices
|
||||
|
||||
1. **Small, focused tasks**: Each document should be ~30-60 minutes of AI time
|
||||
2. **Clear objectives**: Use checkboxes (`- [ ]`) for verification steps
|
||||
3. **Provide context**: Include file paths, existing patterns, constraints
|
||||
4. **Verification steps**: Include test commands, linting checks
|
||||
5. **Independence**: Each document should be self-contained
|
||||
|
||||
## Issue Availability
|
||||
|
||||
An issue is **available** for contribution when:
|
||||
- It has the `runmaestro.ai` label
|
||||
- It is **open** (not closed)
|
||||
- There is **no open PR** with "Closes #N" in the body
|
||||
|
||||
When a contributor starts working on an issue, a draft PR is immediately created with "Closes #N" in the body. This claims the issue and prevents duplicate work.
|
||||
|
||||
### Claim Flow
|
||||
|
||||
```
|
||||
1. Contributor clicks "Start Symphony" on an issue
|
||||
2. Repository is cloned locally
|
||||
3. A new branch is created (symphony/issue-{number}-{timestamp})
|
||||
4. An empty commit is made
|
||||
5. The branch is pushed to origin
|
||||
6. A draft PR is created with "Closes #{issue}" in the body
|
||||
7. Auto Run begins processing documents
|
||||
8. When complete, contributor clicks "Finalize PR"
|
||||
9. Draft PR is converted to "Ready for Review"
|
||||
```
|
||||
|
||||
## Creating Good Issues
|
||||
|
||||
### Do
|
||||
|
||||
- ✅ Break large tasks into multiple smaller issues
|
||||
- ✅ Include all necessary context in the documents
|
||||
- ✅ Provide clear acceptance criteria
|
||||
- ✅ Estimate the expected time/complexity
|
||||
- ✅ Link to relevant documentation or examples
|
||||
|
||||
### Don't
|
||||
|
||||
- ❌ Create issues that require human judgment calls
|
||||
- ❌ Include tasks that need external credentials/access
|
||||
- ❌ Bundle unrelated tasks in a single issue
|
||||
- ❌ Assume contributors know your codebase intimately
|
||||
- ❌ Create documents with ambiguous requirements
|
||||
|
||||
## Example Document Structure
|
||||
|
||||
For complex tasks, organize your documents like this:
|
||||
|
||||
```
|
||||
.maestro/autorun/
|
||||
├── feature-1-setup.md # First: Set up files/structure
|
||||
├── feature-1-implement.md # Second: Implement the feature
|
||||
├── feature-1-tests.md # Third: Add tests
|
||||
└── feature-1-docs.md # Fourth: Update documentation
|
||||
```
|
||||
|
||||
Each document builds on the previous one, and contributors can see the full scope in the issue body.
|
||||
|
||||
## Monitoring Contributions
|
||||
|
||||
As a maintainer:
|
||||
|
||||
1. You'll receive a GitHub notification when a draft PR is created
|
||||
2. Watch the PR for progress as the contributor works
|
||||
3. Review and provide feedback once the PR is ready
|
||||
4. Merge when satisfied
|
||||
|
||||
## Questions?
|
||||
|
||||
- See [SYMPHONY_REGISTRY.md](SYMPHONY_REGISTRY.md) for registry information
|
||||
- Check the [Maestro documentation](https://docs.runmaestro.ai) for Auto Run guides
|
||||
- Open an issue on the Maestro repository for support
|
||||
158
docs/SYMPHONY_REGISTRY.md
Normal file
158
docs/SYMPHONY_REGISTRY.md
Normal file
@@ -0,0 +1,158 @@
|
||||
# Maestro Symphony Registry
|
||||
|
||||
The central registry for open source projects participating in Symphony.
|
||||
|
||||
## Overview
|
||||
|
||||
Symphony connects open source maintainers with AI-powered contributors. Maintainers register their repositories, create Auto Run documents, and open GitHub Issues with the `runmaestro.ai` label. Contributors browse available tasks and complete them via Maestro's Auto Run feature.
|
||||
|
||||
## Repository Structure
|
||||
|
||||
The registry lives in the main Maestro repository:
|
||||
|
||||
```
|
||||
pedramamini/Maestro/
|
||||
├── symphony-registry.json # Central list of all projects
|
||||
└── docs/
|
||||
└── SYMPHONY_REGISTRY.md # This documentation
|
||||
```
|
||||
|
||||
## symphony-registry.json Schema
|
||||
|
||||
```json
|
||||
{
|
||||
"schemaVersion": "1.0",
|
||||
"lastUpdated": "2025-01-01T00:00:00Z",
|
||||
"repositories": [
|
||||
{
|
||||
"slug": "owner/repo-name",
|
||||
"name": "Human Readable Name",
|
||||
"description": "Short description of the project",
|
||||
"url": "https://github.com/owner/repo-name",
|
||||
"category": "developer-tools",
|
||||
"tags": ["cli", "productivity"],
|
||||
"maintainer": {
|
||||
"name": "Name",
|
||||
"url": "https://..."
|
||||
},
|
||||
"isActive": true,
|
||||
"featured": false,
|
||||
"addedAt": "2025-01-01"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Field Reference
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
|-------|------|----------|-------------|
|
||||
| `slug` | string | Yes | Repository identifier in `owner/repo` format |
|
||||
| `name` | string | Yes | Human-readable project name |
|
||||
| `description` | string | Yes | Short description (max 200 chars) |
|
||||
| `url` | string | Yes | Full GitHub repository URL |
|
||||
| `category` | string | Yes | Primary category (see Categories below) |
|
||||
| `tags` | string[] | No | Optional tags for search/filtering |
|
||||
| `maintainer.name` | string | Yes | Maintainer or organization name |
|
||||
| `maintainer.url` | string | No | Optional link to maintainer profile |
|
||||
| `isActive` | boolean | Yes | Whether repo is accepting contributions |
|
||||
| `featured` | boolean | No | Show in featured section (default: false) |
|
||||
| `addedAt` | string | Yes | ISO 8601 date when registered |
|
||||
|
||||
## How It Works
|
||||
|
||||
1. **Maintainers register once** by submitting a PR to add their repo to `symphony-registry.json`
|
||||
2. **Maintainers create Auto Run documents** in their repository (e.g., `.maestro/autorun/`)
|
||||
3. **Maintainers open GitHub Issues** with the `runmaestro.ai` label, listing document paths
|
||||
4. **Contributors browse** available issues in Maestro Symphony
|
||||
5. **One-click contribution** clones the repo, creates a draft PR (claiming the issue), and runs Auto Run
|
||||
6. **Finalize PR** when all documents are processed
|
||||
7. **Maintainer reviews** and merges the contribution
|
||||
|
||||
## Categories
|
||||
|
||||
| ID | Label | Use Case |
|
||||
|----|-------|----------|
|
||||
| `ai-ml` | AI & ML | AI/ML tools and libraries |
|
||||
| `developer-tools` | Developer Tools | Developer productivity tools |
|
||||
| `infrastructure` | Infrastructure | DevOps, cloud, infrastructure |
|
||||
| `documentation` | Documentation | Documentation projects |
|
||||
| `web` | Web | Web frameworks and libraries |
|
||||
| `mobile` | Mobile | Mobile development |
|
||||
| `data` | Data | Data processing, databases |
|
||||
| `security` | Security | Security tools |
|
||||
| `other` | Other | Miscellaneous projects |
|
||||
|
||||
## Registering a Repository
|
||||
|
||||
### Prerequisites
|
||||
|
||||
Before registering, ensure your repository:
|
||||
|
||||
- Has a clear README explaining the project
|
||||
- Has contribution guidelines (CONTRIBUTING.md)
|
||||
- Uses a license compatible with open source (MIT, Apache 2.0, etc.)
|
||||
- Has at least one Auto Run document ready
|
||||
|
||||
### Registration Steps
|
||||
|
||||
1. **Fork** the `pedramamini/Maestro` repository
|
||||
2. **Add your entry** to `symphony-registry.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"slug": "your-org/your-repo",
|
||||
"name": "Your Project Name",
|
||||
"description": "Brief description of your project",
|
||||
"url": "https://github.com/your-org/your-repo",
|
||||
"category": "developer-tools",
|
||||
"tags": ["typescript", "cli"],
|
||||
"maintainer": {
|
||||
"name": "Your Name",
|
||||
"url": "https://github.com/your-username"
|
||||
},
|
||||
"isActive": true,
|
||||
"featured": false,
|
||||
"addedAt": "2025-01-15"
|
||||
}
|
||||
```
|
||||
|
||||
3. **Submit a PR** with your repository details
|
||||
4. Once merged, **create issues** with the `runmaestro.ai` label to enable contributions
|
||||
|
||||
### After Registration
|
||||
|
||||
Once your repository is in the registry:
|
||||
|
||||
1. Create a `.maestro/autorun/` directory in your repo (optional, but recommended)
|
||||
2. Write Auto Run documents for contribution tasks
|
||||
3. Open GitHub Issues with the `runmaestro.ai` label
|
||||
4. List the document paths in the issue body
|
||||
|
||||
See [SYMPHONY_ISSUES.md](SYMPHONY_ISSUES.md) for detailed issue formatting guidelines.
|
||||
|
||||
## Updating Your Entry
|
||||
|
||||
To update your registry entry (e.g., change category, update description):
|
||||
|
||||
1. Submit a PR modifying your entry in `symphony-registry.json`
|
||||
2. Keep your `slug` unchanged to maintain history
|
||||
|
||||
## Removing Your Repository
|
||||
|
||||
To remove your repository from Symphony:
|
||||
|
||||
1. Set `isActive: false` in your registry entry, OR
|
||||
2. Submit a PR removing your entry entirely
|
||||
|
||||
Note: Setting `isActive: false` hides your repo from the contributor UI but preserves contribution history.
|
||||
|
||||
## Registry Caching
|
||||
|
||||
The Symphony client caches the registry for 2 hours to reduce API calls. Changes to the registry may take up to 2 hours to propagate to all users.
|
||||
|
||||
## Questions?
|
||||
|
||||
- See [SYMPHONY_ISSUES.md](SYMPHONY_ISSUES.md) for issue formatting
|
||||
- Check the [Maestro documentation](https://docs.runmaestro.ai) for Auto Run guides
|
||||
- Open an issue on the Maestro repository for support
|
||||
@@ -67,13 +67,13 @@ Separate from Conductor ranks, Maestro tracks your **keyboard mastery** based on
|
||||
|
||||
| Level | Title | Shortcuts Used |
|
||||
|:-----:|-------|----------------|
|
||||
| 0 | Novice | 0-19% |
|
||||
| 1 | Apprentice | 20-39% |
|
||||
| 2 | Journeyman | 40-59% |
|
||||
| 3 | Expert | 60-79% |
|
||||
| 4 | Master | 80-100% |
|
||||
| 0 | Beginner | 0-24% |
|
||||
| 1 | Student | 25-49% |
|
||||
| 2 | Performer | 50-74% |
|
||||
| 3 | Virtuoso | 75-99% |
|
||||
| 4 | Keyboard Maestro | 100% |
|
||||
|
||||
Your current keyboard mastery level is shown in the status bar. Hover over the keyboard icon to see which shortcuts you've used and which remain to be discovered. See [Keyboard Shortcuts](./keyboard-shortcuts) for the full shortcut reference.
|
||||
Your current keyboard mastery level and progress are shown in the **Keyboard Shortcuts panel** (press `?` or `Cmd/Ctrl+/` to open). The panel displays which shortcuts you've used (marked with a checkmark) and which remain to be discovered. See [Keyboard Shortcuts](./keyboard-shortcuts) for the full shortcut reference.
|
||||
|
||||
## Leaderboard
|
||||
|
||||
|
||||
@@ -133,6 +133,7 @@ For editing complex Auto Run documents, use the **Expanded Editor** — a fullsc
|
||||
|
||||
**To open the Expanded Editor:**
|
||||
- Click the **expand icon** (↗️) in the top-right corner of the Auto Run panel
|
||||
- Or press `Cmd+Shift+E` (Mac) / `Ctrl+Shift+E` (Windows/Linux) to toggle
|
||||
|
||||
|
||||
|
||||
@@ -145,9 +146,11 @@ The Expanded Editor provides:
|
||||
|
||||
Click **Collapse** or press `Esc` to return to the sidebar panel view.
|
||||
|
||||
## Auto-Save
|
||||
## Saving Documents
|
||||
|
||||
Documents auto-save after 5 seconds of inactivity, and immediately when switching documents. Full undo/redo support with `Cmd+Z` / `Cmd+Shift+Z`.
|
||||
Save your changes with `Cmd+S` (Mac) or `Ctrl+S` (Windows/Linux), or click the **Save** button in the editor footer. The editor shows "Unsaved changes" and a **Revert** button when you have pending edits. Full undo/redo support with `Cmd+Z` / `Cmd+Shift+Z`.
|
||||
|
||||
**Note**: Switching documents discards unsaved changes. Save before switching if you want to preserve your edits.
|
||||
|
||||
## Image Support
|
||||
|
||||
|
||||
21
docs/cli.md
21
docs/cli.md
@@ -38,6 +38,7 @@ maestro-cli list groups
|
||||
|
||||
# List all agents
|
||||
maestro-cli list agents
|
||||
maestro-cli list agents -g <group-id>
|
||||
maestro-cli list agents --group <group-id>
|
||||
|
||||
# Show agent details (history, usage stats, cost)
|
||||
@@ -45,6 +46,7 @@ maestro-cli show agent <agent-id>
|
||||
|
||||
# List all playbooks (or filter by agent)
|
||||
maestro-cli list playbooks
|
||||
maestro-cli list playbooks -a <agent-id>
|
||||
maestro-cli list playbooks --agent <agent-id>
|
||||
|
||||
# Show playbook details
|
||||
@@ -64,6 +66,10 @@ maestro-cli playbook <playbook-id> --wait --verbose
|
||||
|
||||
# Debug mode for troubleshooting
|
||||
maestro-cli playbook <playbook-id> --debug
|
||||
|
||||
# Clean orphaned playbooks (for deleted sessions)
|
||||
maestro-cli clean playbooks
|
||||
maestro-cli clean playbooks --dry-run
|
||||
```
|
||||
|
||||
## JSON Output
|
||||
@@ -82,17 +88,22 @@ GROUPS (2)
|
||||
|
||||
# JSON output for scripting
|
||||
maestro-cli list groups --json
|
||||
{"type":"group","id":"group-abc123","name":"Frontend","emoji":"🎨","timestamp":...}
|
||||
{"type":"group","id":"group-def456","name":"Backend","emoji":"⚙️","timestamp":...}
|
||||
{"type":"group","id":"group-abc123","name":"Frontend","emoji":"🎨","collapsed":false,"timestamp":...}
|
||||
{"type":"group","id":"group-def456","name":"Backend","emoji":"⚙️","collapsed":false,"timestamp":...}
|
||||
|
||||
# Note: list agents outputs a JSON array (not JSONL)
|
||||
maestro-cli list agents --json
|
||||
[{"id":"agent-abc123","name":"My Agent","toolType":"claude-code","cwd":"/path/to/project",...}]
|
||||
|
||||
# Running a playbook with JSON streams events
|
||||
maestro-cli playbook <playbook-id> --json
|
||||
{"type":"start","timestamp":...,"playbook":{...}}
|
||||
{"type":"document_start","timestamp":...,"document":"tasks.md","taskCount":5}
|
||||
{"type":"task_start","timestamp":...,"taskIndex":0}
|
||||
{"type":"task_complete","timestamp":...,"success":true,"summary":"...","elapsedMs":8000}
|
||||
{"type":"document_complete","timestamp":...,"tasksCompleted":5}
|
||||
{"type":"complete","timestamp":...,"totalTasksCompleted":5,"totalElapsedMs":60000}
|
||||
{"type":"task_complete","timestamp":...,"success":true,"summary":"...","elapsedMs":8000,"usageStats":{...}}
|
||||
{"type":"document_complete","timestamp":...,"document":"tasks.md","tasksCompleted":5}
|
||||
{"type":"loop_complete","timestamp":...,"iteration":1,"tasksCompleted":5,"elapsedMs":60000}
|
||||
{"type":"complete","timestamp":...,"success":true,"totalTasksCompleted":5,"totalElapsedMs":60000,"totalCost":0.05}
|
||||
```
|
||||
|
||||
## Scheduling with Cron
|
||||
|
||||
@@ -12,12 +12,12 @@ Settings are organized into tabs:
|
||||
|
||||
| Tab | Contents |
|
||||
|-----|----------|
|
||||
| **General** | Theme, input behavior, toggles defaults, context warnings, log level, storage location, power management |
|
||||
| **General** | Font family and size, terminal width, log level and buffer, max output lines, shell configuration, input send behavior, default toggles (history, thinking), power management, updates, privacy, context warnings, usage stats, document graph, storage location |
|
||||
| **Shortcuts** | Customize keyboard shortcuts (see [Keyboard Shortcuts](./keyboard-shortcuts)) |
|
||||
| **Appearance** | Font size, UI density |
|
||||
| **Notifications** | Sound alerts, text-to-speech settings |
|
||||
| **Themes** | Dark, light, and vibe mode themes, custom theme builder with import/export |
|
||||
| **Notifications** | OS notifications, audio feedback (text-to-speech), toast notification duration |
|
||||
| **AI Commands** | View and edit slash commands, [Spec-Kit](./speckit-commands), and [OpenSpec](./openspec-commands) prompts |
|
||||
| **SSH Remotes** | Configure remote hosts for [SSH agent execution](./ssh-remote-execution) |
|
||||
| **SSH Hosts** | Configure remote hosts for [SSH agent execution](./ssh-remote-execution) |
|
||||
|
||||
## Checking for Updates
|
||||
|
||||
|
||||
@@ -10,16 +10,20 @@ Hover over any tab with an established session to access the tab menu overlay:
|
||||
|
||||
|
||||
|
||||
| Action | Description |
|
||||
|--------|-------------|
|
||||
| **Copy Session ID** | Copy the session ID to clipboard (for session continuity) |
|
||||
| **Star Session** | Bookmark this session for quick access |
|
||||
| **Rename Tab** | Give the tab a descriptive name |
|
||||
| **Mark as Unread** | Add unread indicator to the tab |
|
||||
| **Context: Copy to Clipboard** | Copy the full conversation to clipboard |
|
||||
| **Context: Compact** | Compress context while preserving key information |
|
||||
| **Context: Merge Into** | Merge this context into another session |
|
||||
| **Context: Send to Agent** | Transfer context to a different agent |
|
||||
| Action | Requires Session | Description |
|
||||
|--------|------------------|-------------|
|
||||
| **Copy Session ID** | Yes | Copy the session ID to clipboard (for session continuity) |
|
||||
| **Star Session** | Yes | Bookmark this session for quick access |
|
||||
| **Rename Tab** | Yes | Give the tab a descriptive name |
|
||||
| **Mark as Unread** | Yes | Add unread indicator to the tab |
|
||||
| **Export as HTML** | No (1+ logs) | Export conversation as self-contained HTML file |
|
||||
| **Context: Copy to Clipboard** | No (1+ logs) | Copy the full conversation to clipboard |
|
||||
| **Context: Compact** | No (5+ logs) | Compress context while preserving key information |
|
||||
| **Context: Merge Into** | Yes | Merge this context into another session |
|
||||
| **Context: Send to Agent** | Yes | Transfer context to a different agent |
|
||||
| **Context: Publish as GitHub Gist** | No (1+ logs) | Share conversation as a public or secret GitHub Gist (requires `gh` CLI) |
|
||||
| **Move to First Position** | No | Move this tab to the first position |
|
||||
| **Move to Last Position** | No | Move this tab to the last position |
|
||||
|
||||
### Tab Close Operations
|
||||
|
||||
@@ -54,8 +58,8 @@ These actions are also available via **Quick Actions** (`Cmd+K` / `Ctrl+K`) with
|
||||
|
||||
Export any tab conversation as a self-contained HTML file:
|
||||
|
||||
1. Right-click the tab → **Context: Copy to Clipboard**
|
||||
2. Or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Export tab to HTML"
|
||||
1. Hover over the tab → **Export as HTML**
|
||||
2. Choose a save location when prompted
|
||||
|
||||
The exported HTML file includes:
|
||||
- **Full conversation history** with all messages
|
||||
@@ -66,6 +70,10 @@ The exported HTML file includes:
|
||||
|
||||
This is useful for sharing conversations, creating documentation, or archiving important sessions.
|
||||
|
||||
**Alternative sharing options:**
|
||||
- **Context: Copy to Clipboard** — Copy the raw conversation text to clipboard (for pasting into documents or chat)
|
||||
- **Context: Publish as GitHub Gist** — Share as a public or secret GitHub Gist (requires `gh` CLI to be installed)
|
||||
|
||||
---
|
||||
|
||||
Context management lets you combine or transfer conversation history between sessions and agents, enabling powerful workflows where you can:
|
||||
@@ -116,7 +124,7 @@ Customize warning thresholds in **Settings** (`Cmd+,` / `Ctrl+,`) → **General*
|
||||
|
||||
When your conversation approaches context limits, you can compress it while preserving essential information:
|
||||
|
||||
1. **Right-click** a tab → **"Context: Compact"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Compact"
|
||||
1. **Hover over** a tab → **"Context: Compact"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Compact"
|
||||
2. The AI compacts the conversation, extracting key decisions, code changes, and context
|
||||
3. A new tab opens with the compressed context, ready to continue working
|
||||
|
||||
@@ -174,7 +182,7 @@ During compaction, you'll see status updates:
|
||||
|
||||
Combine context from multiple sessions or tabs into one:
|
||||
|
||||
1. **Right-click** a tab → **"Context: Merge Into"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Merge with another session"
|
||||
1. **Hover over** a tab → **"Context: Merge Into"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Merge Into"
|
||||
2. Search for or select the target session/tab from the modal
|
||||
3. Review the merge preview showing estimated token count
|
||||
4. Optionally enable **Clean context** to remove duplicates and reduce size
|
||||
@@ -204,7 +212,7 @@ The merged context creates a new tab in the target session with conversation his
|
||||
|
||||
Transfer your context to a different AI agent:
|
||||
|
||||
1. **Right-click** a tab → **"Context: Send to Agent"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Send to another agent"
|
||||
1. **Hover over** a tab → **"Context: Send to Agent"**, or use **Command Palette** (`Cmd+K` / `Ctrl+K`) → "Context: Send to Agent"
|
||||
2. Search for or select the target agent from the list
|
||||
3. Review the token estimate and cleaning options
|
||||
4. Click **"Send to Session"**
|
||||
|
||||
@@ -12,19 +12,27 @@ The Document Graph provides an interactive visualization of your markdown files
|
||||
|
||||
There are several ways to access the Document Graph:
|
||||
|
||||
### From the File Explorer
|
||||
### From File Preview
|
||||
|
||||
Click the **graph icon** (circular arrows) in the Files tab header to open the Document Graph for your current project.
|
||||
|
||||
|
||||
When viewing a markdown file in File Preview, press `Cmd+Shift+G` / `Ctrl+Shift+G` to open the Document Graph focused on that file. Press `Esc` to return to the File Preview. This is the primary way to open the Document Graph.
|
||||
|
||||
### From Quick Actions
|
||||
|
||||
Press `Cmd+K` / `Ctrl+K` and search for "Document Graph" to open it directly.
|
||||
Press `Cmd+K` / `Ctrl+K` and search for "Open Last Document Graph" to re-open the most recently viewed graph.
|
||||
|
||||
### From File Preview
|
||||
<Note>
|
||||
The "Open Last Document Graph" option only appears after you've opened a Document Graph at least once during your session.
|
||||
</Note>
|
||||
|
||||
When viewing a markdown file in File Preview, press `Cmd+Shift+G` / `Ctrl+Shift+G` to open the Document Graph focused on that file. Press `Esc` to return to the File Preview.
|
||||
### From the File Explorer
|
||||
|
||||
After you've opened a Document Graph at least once, a **graph icon** (branch icon) appears in the Files tab header. Click it to re-open the last viewed graph.
|
||||
|
||||
|
||||
|
||||
### From File Context Menu
|
||||
|
||||
Right-click any markdown file in the File Explorer and select **Document Graph** to open the graph focused on that file.
|
||||
|
||||
### Using Go to File
|
||||
|
||||
@@ -36,17 +44,18 @@ The Document Graph is designed for keyboard-first navigation:
|
||||
|
||||
| Action | Key |
|
||||
|--------|-----|
|
||||
| Navigate to connected nodes | `Arrow Keys` (spatial detection) |
|
||||
| Focus/select a node | `Enter` |
|
||||
| Open the selected document | `O` |
|
||||
| Close the graph | `Esc` |
|
||||
| Cycle through connected nodes | `Tab` |
|
||||
| Navigate between nodes | `Arrow Keys` (spatial detection) |
|
||||
| Recenter view on node | `Enter` (for document nodes) |
|
||||
| Open external URL | `Enter` (for external link nodes) |
|
||||
| Open document in File Preview | `O` |
|
||||
| Focus search | `Cmd/Ctrl+F` |
|
||||
| Close graph or help panel | `Esc` |
|
||||
|
||||
### Mouse Controls
|
||||
|
||||
- **Click** a node to select it
|
||||
- **Double-click** a node to recenter the view on it
|
||||
- **Drag** nodes to reposition them — positions are saved
|
||||
- **Drag** nodes to reposition them
|
||||
- **Scroll** to zoom in and out
|
||||
- **Pan** by dragging the background
|
||||
|
||||
@@ -56,13 +65,14 @@ The toolbar at the top of the Document Graph provides several options:
|
||||
|
||||
### Depth Control
|
||||
|
||||
Adjust the **Depth** setting to control how many levels of connections are shown from the focused document:
|
||||
Adjust the **Depth** slider to control how many levels of connections are shown from the focused document:
|
||||
|
||||
- **Depth: 0 (All)** — Show all connected documents regardless of distance
|
||||
- **Depth: 1** — Show only direct connections
|
||||
- **Depth: 2** — Show connections and their connections (default)
|
||||
- **Depth: 3+** — Show deeper relationship chains
|
||||
- **Depth: 3-5** — Show deeper relationship chains
|
||||
|
||||
Lower depth values keep the graph focused; higher values reveal the full document ecosystem.
|
||||
Lower depth values keep the graph focused and improve performance; higher values reveal more of the document ecosystem. The depth can be adjusted from 0 (All) to 5.
|
||||
|
||||
### External Links
|
||||
|
||||
@@ -133,11 +143,11 @@ The Document Graph is especially useful for:
|
||||
|
||||
| Action | macOS | Windows/Linux |
|
||||
|--------|-------|---------------|
|
||||
| Open Document Graph | Via `Cmd+K` menu | Via `Ctrl+K` menu |
|
||||
| Open from File Preview | `Cmd+Shift+G` | `Ctrl+Shift+G` |
|
||||
| Re-open last graph | Via `Cmd+K` menu | Via `Ctrl+K` menu |
|
||||
| Go to File (fuzzy finder) | `Cmd+G` | `Ctrl+G` |
|
||||
| Navigate nodes | `Arrow Keys` | `Arrow Keys` |
|
||||
| Select/focus node | `Enter` | `Enter` |
|
||||
| Open document | `O` | `O` |
|
||||
| Cycle connected nodes | `Tab` | `Tab` |
|
||||
| Recenter on node | `Enter` | `Enter` |
|
||||
| Open document in preview | `O` | `O` |
|
||||
| Focus search | `Cmd+F` | `Ctrl+F` |
|
||||
| Close graph | `Esc` | `Esc` |
|
||||
|
||||
@@ -29,9 +29,9 @@ icon: sparkles
|
||||
- ⚡ **[Slash Commands](./slash-commands)** - Extensible command system with autocomplete. Create custom commands with template variables for your workflows. Includes bundled [Spec-Kit](./speckit-commands) for feature specifications and [OpenSpec](./openspec-commands) for change proposals.
|
||||
- 💾 **Draft Auto-Save** - Never lose work. Drafts are automatically saved and restored per session.
|
||||
- 🔊 **Speakable Notifications** - Audio alerts with text-to-speech announcements when agents complete tasks.
|
||||
- 🎨 **[Beautiful Themes](https://github.com/pedramamini/Maestro/blob/main/THEMES.md)** - 12 themes including Dracula, Monokai, Nord, Tokyo Night, GitHub Light, and more.
|
||||
- 🎨 **[Beautiful Themes](https://github.com/pedramamini/Maestro/blob/main/THEMES.md)** - 17 built-in themes across dark (Dracula, Monokai, Nord, Tokyo Night, Catppuccin Mocha, Gruvbox Dark), light (GitHub, Solarized, One Light, Gruvbox Light, Catppuccin Latte, Ayu Light), and vibe (Pedurple, Maestro's Choice, Dre Synth, InQuest) categories, plus a fully customizable theme builder.
|
||||
- 💰 **Cost Tracking** - Real-time token usage and cost tracking per session and globally.
|
||||
- 📊 **[Usage Dashboard](./usage-dashboard)** - Comprehensive analytics for tracking AI usage patterns. View aggregated statistics, compare agent performance, analyze activity heatmaps, and export data to CSV. Access via `Opt+Cmd+U` / `Alt+Ctrl+U`.
|
||||
- 🏆 **[Achievements](./achievements)** - Level up from Apprentice to Titan of the Baton based on cumulative Auto Run time. 11 conductor-themed ranks to unlock.
|
||||
|
||||
> **Note**: Maestro supports Claude Code, OpenAI Codex, and OpenCode as providers. Support for additional providers (Aider, Gemini CLI, Qwen3 Coder) may be added in future releases based on community demand.
|
||||
> **Note**: Maestro currently supports Claude Code, Codex (OpenAI), and OpenCode as fully-integrated providers. Support for additional providers (Aider, Gemini CLI, Qwen3 Coder) is planned for future releases based on community demand.
|
||||
|
||||
@@ -22,7 +22,7 @@ Maestro features a three-panel layout:
|
||||
Each agent shows a color-coded status indicator:
|
||||
|
||||
- 🟢 **Green** - Ready and waiting
|
||||
- 🟡 **Yellow** - Agent is thinking
|
||||
- 🟡 **Yellow** - Agent is thinking or waiting for user input
|
||||
- 🔴 **Red** - No connection with agent
|
||||
- 🟠 **Pulsing Orange** - Attempting to establish connection
|
||||
- 🔴 **Red Badge** - Unread messages (small red dot overlapping top-right of status indicator, iPhone-style)
|
||||
@@ -46,7 +46,7 @@ When you open a file, a **breadcrumb trail** appears showing your navigation his
|
||||
|
||||
### File Editing
|
||||
|
||||
Files can be edited directly in the preview. Changes are saved automatically when you navigate away or close the preview.
|
||||
Files can be edited directly in the preview. Press `Cmd+S` / `Ctrl+S` to save changes. If you navigate away or close the preview with unsaved changes, a confirmation dialog will ask whether to discard them.
|
||||
|
||||
### Publish as GitHub Gist
|
||||
|
||||
@@ -89,6 +89,7 @@ Reference files in your AI prompts using `@` mentions:
|
||||
For complex prompts that need more editing space, use the **Prompt Composer** — a fullscreen editing modal.
|
||||
|
||||
**To open the Prompt Composer:**
|
||||
- Press `Cmd+Shift+P` / `Ctrl+Shift+P`, or
|
||||
- Click the **pencil icon** (✏️) in the bottom-left corner of the AI input box
|
||||
|
||||
|
||||
@@ -318,7 +319,7 @@ Drag the right edge of the sidebar to resize it. The width is persisted across s
|
||||
|
||||
### Collapsed Mode
|
||||
|
||||
Click the sidebar toggle (`Cmd+B` / `Ctrl+B`) to collapse the sidebar to icon-only mode. In collapsed mode:
|
||||
Click the sidebar toggle (`Opt+Cmd+Left` / `Alt+Ctrl+Left`) to collapse the sidebar to icon-only mode. In collapsed mode:
|
||||
- Agents show as icons with status indicators
|
||||
- Hover for agent name tooltip
|
||||
- Click to select an agent
|
||||
|
||||
@@ -12,7 +12,7 @@ Follow the [Installation](./installation) instructions for your platform, then l
|
||||
|
||||
## 2. Create an agent (or use the Wizard)
|
||||
|
||||
Maestro supports **Claude Code**, **OpenAI Codex**, and **OpenCode** as providers. Make sure at least one is installed and authenticated.
|
||||
Maestro supports **Claude Code**, **Codex** (OpenAI), and **OpenCode** as providers. Make sure at least one is installed and authenticated.
|
||||
|
||||
**Option A: Quick Setup**
|
||||
Create your first agent manually using the **+** button in the sidebar.
|
||||
|
||||
@@ -44,28 +44,38 @@ Worktree sub-agents appear nested under their parent agent in the Left Bar:
|
||||
|
||||
|
||||
|
||||
- **Nested Display** — Worktree sub-agents appear indented under their parent agent
|
||||
- **Branch Icon** — A green checkmark indicates the active worktree
|
||||
- **Collapse/Expand** — Click the chevron on a parent agent to show/hide its worktree children
|
||||
- **Nested Display** — Worktree sub-agents appear in a drawer below their parent agent, styled with a subtle accent background
|
||||
- **Branch Icon** — Worktree children show a `GitBranch` icon next to their name
|
||||
- **Collapse/Expand** — Click the worktree count band below the parent session to show/hide worktree children (e.g., "2 worktrees ▾")
|
||||
- **Independent Operation** — Each worktree agent has its own working directory, conversation history, and state
|
||||
|
||||
### Creating a Worktree Sub-Agent
|
||||
|
||||
1. In the agent list (Left Bar), hover over an agent in a git repository
|
||||
2. Click the **git branch indicator** (shows current branch name)
|
||||
3. In the overlay menu, click **"Create Worktree Sub-Agent"**
|
||||
4. Configure the worktree:
|
||||
There are two ways to access worktree configuration:
|
||||
|
||||
**From the Header (Main Panel):**
|
||||
1. Select an agent that's in a git repository
|
||||
2. Hover over the **branch pill** in the header (shows the current branch name, e.g., "main")
|
||||
3. In the hover overlay, click **"Configure Worktrees"**
|
||||
|
||||
**From the Context Menu (Left Bar):**
|
||||
1. Right-click an agent in the session list
|
||||
2. Select **"Configure Worktrees"** (only shown for git repositories)
|
||||
|
||||
In the configuration modal:
|
||||
|
||||
|
||||
|
||||
| Option | Description |
|
||||
|--------|-------------|
|
||||
| **Worktree Directory** | Base folder where worktrees are created (should be outside the main repo) |
|
||||
| **Watch for Changes** | Monitor the worktree for file system changes |
|
||||
| **Create New Worktree** | Branch name for the new worktree (becomes the subdirectory name) |
|
||||
| **Worktree Directory** | Base folder where worktrees are created (should be outside the main repo). You can browse to select it (local sessions) or type the path directly. |
|
||||
| **Watch for new worktrees** | Auto-detect worktrees created outside Maestro (e.g., via command line) |
|
||||
| **Create New Worktree** | Enter a branch name and click **Create** to instantly create a new worktree sub-agent |
|
||||
|
||||
**Tip:** Configure the worktree directory to be outside your main repository (e.g., `~/Projects/Maestro-WorkTrees/`). This keeps worktrees organized and prevents them from appearing in your main repo's file tree.
|
||||
|
||||
**Note:** Once configured, you can quickly create additional worktrees by right-clicking the parent session and selecting **"Create Worktree"** (bypasses the full configuration modal).
|
||||
|
||||
### Worktree Actions
|
||||
|
||||
Right-click any worktree sub-agent to access management options:
|
||||
@@ -76,6 +86,7 @@ Right-click any worktree sub-agent to access management options:
|
||||
|--------|-------------|
|
||||
| **Rename** | Change the display name of the worktree agent |
|
||||
| **Edit Agent...** | Modify agent configuration |
|
||||
| **Duplicate...** | Create a new agent with the same configuration |
|
||||
| **Create Pull Request** | Open a PR from this worktree's branch |
|
||||
| **Remove Worktree** | Delete the worktree agent (see below) |
|
||||
|
||||
|
||||
@@ -4,6 +4,10 @@ description: Coordinate multiple AI agents in a single conversation with a moder
|
||||
icon: comments
|
||||
---
|
||||
|
||||
<Note>
|
||||
Group Chat is currently in **Beta**. The feature is functional but under active development.
|
||||
</Note>
|
||||
|
||||
Group Chat lets you coordinate multiple AI agents in a single conversation. A moderator AI orchestrates the discussion, routing questions to the right agents and synthesizing their responses.
|
||||
|
||||
|
||||
@@ -18,12 +22,17 @@ Group Chat lets you coordinate multiple AI agents in a single conversation. A mo
|
||||
|
||||
## How It Works
|
||||
|
||||
1. **Create a Group Chat** from the sidebar menu
|
||||
2. **Add participants** by @mentioning agent names (e.g., `@Frontend`, `@Backend`)
|
||||
3. **Send your question** - the moderator receives it first
|
||||
4. **Moderator coordinates** - routes to relevant agents via @mentions
|
||||
5. **Agents respond** - each agent works in their own project context
|
||||
6. **Moderator synthesizes** - combines responses into a coherent answer
|
||||
1. **Create a Group Chat** — Use keyboard shortcut `Opt+Cmd+C` / `Alt+Ctrl+C`, click "+ New Chat" in the Group Chats section of the sidebar, or use Quick Actions (`Cmd+K` / `Ctrl+K`)
|
||||
2. **Select a moderator** — Choose which AI agent (Claude Code, OpenCode, or Codex) will coordinate the conversation
|
||||
3. **@mention agents** — In your message, @mention any Maestro session (e.g., `@Frontend`, `@Backend`). Agents are automatically added as participants when mentioned.
|
||||
4. **Send your question** — The moderator receives it first and decides how to proceed
|
||||
5. **Moderator coordinates** — Routes to relevant agents via @mentions, can make multiple rounds
|
||||
6. **Agents respond** — Each agent works in their own project context
|
||||
7. **Moderator synthesizes** — Combines responses into a coherent answer
|
||||
|
||||
<Tip>
|
||||
Agents are automatically added as participants when you or the moderator @mention them. You don't need to pre-configure participants — just @mention any active Maestro session by name.
|
||||
</Tip>
|
||||
|
||||
## The Moderator's Role
|
||||
|
||||
@@ -80,8 +89,29 @@ Remote agents are identified by the **REMOTE** pill in the participant list. Eac
|
||||
|
||||
## Tips for Effective Group Chats
|
||||
|
||||
- **Name agents descriptively** - Agent names appear in the chat, so "Frontend-React" is clearer than "Agent1"
|
||||
- **Be specific in questions** - The more context you provide, the better the moderator can route
|
||||
- **@mention explicitly** - You can direct questions to specific agents: "What does @Backend think?"
|
||||
- **Let the moderator work** - It may take multiple rounds for complex questions
|
||||
- **Mix local and remote** - Combine agents across machines for maximum coverage
|
||||
- **Name agents descriptively** — Agent names appear in the chat, so "Frontend-React" is clearer than "Agent1"
|
||||
- **Be specific in questions** — The more context you provide, the better the moderator can route
|
||||
- **@mention explicitly** — You can direct questions to specific agents: "What does @Backend think?"
|
||||
- **Let the moderator work** — It may take multiple rounds for complex questions
|
||||
- **Mix local and remote** — Combine agents across machines for maximum coverage
|
||||
- **Hyphenated names for spaces** — If your session name has spaces, use hyphens in @mentions (e.g., `@My-Project` for "My Project")
|
||||
|
||||
## Managing Group Chats
|
||||
|
||||
Right-click on a group chat in the sidebar to access the context menu:
|
||||
|
||||
| Action | Description |
|
||||
|--------|-------------|
|
||||
| **Edit** | Change the moderator agent or customize its settings (CLI args, path, environment variables) |
|
||||
| **Rename** | Change the group chat name |
|
||||
| **Delete** | Remove the group chat and its conversation history |
|
||||
|
||||
## Input Features
|
||||
|
||||
The Group Chat input supports the same features as direct agent conversations:
|
||||
|
||||
- **Read-only mode** — Toggle to prevent agents from modifying files (participants receive the mode flag)
|
||||
- **Image attachments** — Attach images to include in your message
|
||||
- **Prompt Composer** — Open the full prompt composer with `Cmd+Shift+P` / `Ctrl+Shift+P`
|
||||
- **Enter/Cmd+Enter toggle** — Switch between send behaviors
|
||||
- **Message queuing** — Messages are queued if the moderator or agents are busy
|
||||
|
||||
@@ -10,7 +10,7 @@ Maestro is a cross-platform desktop app for orchestrating your fleet of AI agent
|
||||
|
||||
Collaborate with AI to create detailed specification documents, then let Auto Run execute them automatically, each task in a fresh session with clean context. Allowing for long-running unattended sessions, my current record is nearly 24 hours of continuous runtime.
|
||||
|
||||
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 (Aider, Gemini CLI, Qwen3 Coder) based on user demand.
|
||||
Run multiple agents in parallel with a Linear/Superhuman-level responsive interface. Currently supporting **Claude Code**, **Codex** (OpenAI), and **OpenCode** with plans for additional agentic coding tools (Aider, Gemini CLI, Qwen3 Coder) based on user demand.
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -8,17 +8,18 @@ icon: download
|
||||
|
||||
Download the latest release for your platform from the [Releases](https://github.com/pedramamini/maestro/releases) page:
|
||||
|
||||
- **macOS**: `.dmg` or `.zip`
|
||||
- **Windows**: `.exe` installer
|
||||
- **Linux**: `.AppImage`, `.deb`, or `.rpm`
|
||||
- **macOS**: `.dmg` or `.zip` (available for both Intel and Apple Silicon)
|
||||
- **Windows**: `.exe` installer or portable `.exe` (no installation required)
|
||||
- **Linux**: `.AppImage`, `.deb`, or `.rpm` (available for both x86_64 and arm64)
|
||||
- **Upgrading**: Simply replace the old binary with the new one. All your data (sessions, settings, playbooks, history) persists in your [config directory](./configuration).
|
||||
|
||||
## Requirements
|
||||
|
||||
- At least one supported AI coding agent installed and authenticated:
|
||||
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) - Anthropic's AI coding assistant
|
||||
- [OpenAI Codex](https://github.com/openai/codex) - OpenAI's coding agent
|
||||
- [OpenCode](https://github.com/sst/opencode) - Open-source AI coding assistant
|
||||
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — Anthropic's AI coding assistant (fully integrated)
|
||||
- [Codex](https://github.com/openai/codex) — OpenAI's coding agent (fully integrated)
|
||||
- [OpenCode](https://github.com/sst/opencode) — Open-source AI coding assistant (fully integrated)
|
||||
- [Aider](https://github.com/paul-gauthier/aider), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Qwen3 Coder](https://github.com/QwenLM/Qwen-Agent) — Planned support
|
||||
- Git (optional, for git-aware features)
|
||||
|
||||
## WSL2 Users (Windows Subsystem for Linux)
|
||||
@@ -65,4 +66,31 @@ If you encounter `electron-rebuild` failures, try setting the temp directory:
|
||||
TMPDIR=/tmp npm run rebuild
|
||||
```
|
||||
|
||||
For persistent issues, see [Troubleshooting](./troubleshooting) for additional WSL-specific guidance
|
||||
For persistent issues, see [Troubleshooting](./troubleshooting) for additional WSL-specific guidance.
|
||||
|
||||
## Building from Source
|
||||
|
||||
If you prefer to build Maestro from source:
|
||||
|
||||
```bash
|
||||
# Prerequisites: Node.js 22.0.0 or higher
|
||||
node --version # Verify version
|
||||
|
||||
# Clone the repository
|
||||
git clone https://github.com/pedramamini/maestro.git
|
||||
cd maestro
|
||||
|
||||
# Install dependencies
|
||||
npm install
|
||||
|
||||
# Run in development mode
|
||||
npm run dev
|
||||
|
||||
# Or build for production
|
||||
npm run build
|
||||
npm run package
|
||||
```
|
||||
|
||||
<Note>
|
||||
Building from source requires native module compilation (node-pty, better-sqlite3). On Windows, you'll need the [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/). On macOS, you'll need Xcode Command Line Tools (`xcode-select --install`).
|
||||
</Note>
|
||||
|
||||
433
docs/releases.md
433
docs/releases.md
@@ -17,46 +17,47 @@ Maestro can update itself automatically! This feature was introduced in **v0.8.7
|
||||
|
||||
**Latest: v0.14.5** | Released January 24, 2026
|
||||
|
||||
Changes in this point release include:
|
||||
|
||||
- Desktop app performance improvements (more to come on this, we want Maestro blazing fast) 🐌
|
||||
- Added local manifest feature for custom playbooks 📖
|
||||
- Agents are now inherently aware of your activity history as seen in the history panel 📜 (this is built-in cross context memory!)
|
||||
- Added markdown rendering support for AI responses in mobile view 📱
|
||||
- Bugfix in tracking costs from JSONL files that were aged out 🏦
|
||||
- Added BlueSky social media handle for leaderboard 🦋
|
||||
- Added options to disable GPU rendering and confetti 🎊
|
||||
- Better handling of large files in preview 🗄️
|
||||
- Bug fix in Claude context calculation 🧮
|
||||
- Addressed bug in OpenSpec version reporting 🐛
|
||||
|
||||
The major contributions to 0.14.x remain:
|
||||
|
||||
🗄️ Document Graphs. Launch from file preview or from the FIle tree panel. Explore relationships between Markdown documents that contain links between documents and to URLs.
|
||||
|
||||
📶 SSH support for agents. Manage a remote agent with feature parity over SSH. Includes support for Git and File tree panels. Manage agents on remote systems or in containers. This even works for Group Chat, which is rad as hell.
|
||||
|
||||
🧙♂️ Added an in-tab wizard for generating Auto Run Playbooks via `/wizard` or a new button in the Auto Run panel.
|
||||
|
||||
# Smaller Changes in 014.x
|
||||
|
||||
- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️
|
||||
- Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆
|
||||
- Agent duplication. Pro tip: Consider a group of unused "Template" agents ✌️
|
||||
- New setting to prevent system from going to sleep while agents are active 🛏️
|
||||
- The tab menu has a new "Publish as GitHub Gist" option 📝
|
||||
- The tab menu has options to move the tab to the first or last position 🔀
|
||||
- [Maestro-Playbooks](https://github.com/pedramamini/Maestro-Playbooks) can now contain non-markdown assets 📙
|
||||
- Improved default shell detection 🐚
|
||||
- Added logic to prevent overlapping TTS notifications 💬
|
||||
- Added "Toggle Bookmark" shortcut (CTRL/CMD+SHIFT+B) ⌨️
|
||||
- Gist publishing now shows previous URLs with copy button 📋
|
||||
|
||||
Changes in this point release include:
|
||||
|
||||
- Desktop app performance improvements (more to come on this, we want Maestro blazing fast) 🐌
|
||||
- Added local manifest feature for custom playbooks 📖
|
||||
- Agents are now inherently aware of your activity history as seen in the history panel 📜 (this is built-in cross context memory!)
|
||||
- Added markdown rendering support for AI responses in mobile view 📱
|
||||
- Bugfix in tracking costs from JSONL files that were aged out 🏦
|
||||
- Added BlueSky social media handle for leaderboard 🦋
|
||||
- Added options to disable GPU rendering and confetti 🎊
|
||||
- Better handling of large files in preview 🗄️
|
||||
- Bug fix in Claude context calculation 🧮
|
||||
- Addressed bug in OpenSpec version reporting 🐛
|
||||
|
||||
The major contributions to 0.14.x remain:
|
||||
|
||||
🗄️ Document Graphs. Launch from file preview or from the FIle tree panel. Explore relationships between Markdown documents that contain links between documents and to URLs.
|
||||
|
||||
📶 SSH support for agents. Manage a remote agent with feature parity over SSH. Includes support for Git and File tree panels. Manage agents on remote systems or in containers. This even works for Group Chat, which is rad as hell.
|
||||
|
||||
🧙♂️ Added an in-tab wizard for generating Auto Run Playbooks via `/wizard` or a new button in the Auto Run panel.
|
||||
|
||||
# Smaller Changes in 014.x
|
||||
|
||||
- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️
|
||||
- Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆
|
||||
- Agent duplication. Pro tip: Consider a group of unused "Template" agents ✌️
|
||||
- New setting to prevent system from going to sleep while agents are active 🛏️
|
||||
- The tab menu has a new "Publish as GitHub Gist" option 📝
|
||||
- The tab menu has options to move the tab to the first or last position 🔀
|
||||
- [Maestro-Playbooks](https://github.com/pedramamini/Maestro-Playbooks) can now contain non-markdown assets 📙
|
||||
- Improved default shell detection 🐚
|
||||
- Added logic to prevent overlapping TTS notifications 💬
|
||||
- Added "Toggle Bookmark" shortcut (CTRL/CMD+SHIFT+B) ⌨️
|
||||
- Gist publishing now shows previous URLs with copy button 📋
|
||||
|
||||
Thanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer @shadown @breki @charles-dyfis-net @ronaldeddings @jlengrand @ksylvan
|
||||
|
||||
### Previous Releases in this Series
|
||||
|
||||
- **v0.14.4** (January 11, 2026) - Doc Graphs, SSH Agents, Inline Wizard
|
||||
- **v0.14.5** (January 11, 2026 — Draft) - Desktop performance fixes
|
||||
- **v0.14.4** (January 11, 2026) - SSH/wizard bug fixes, performance improvements
|
||||
- **v0.14.3** (January 9, 2026) - Doc Graphs, SSH Agents, Inline Wizard
|
||||
- **v0.14.2** (January 7, 2026) - Doc Graphs, SSH Agents, Inline Wizard
|
||||
- **v0.14.1** (January 6, 2026) - Doc Graphs, SSH Agents, Inline Wizard
|
||||
@@ -70,20 +71,20 @@ Thanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @d
|
||||
|
||||
### Changes
|
||||
|
||||
- TAKE TWO! Fixed Linux ARM64 build architecture contamination issues 🏗️
|
||||
|
||||
### v0.13.1 Changes
|
||||
- Fixed Linux ARM64 build architecture contamination issues 🏗️
|
||||
- Enhanced error handling for Auto Run batch processing 🚨
|
||||
|
||||
### v0.13.0 Changes
|
||||
- Added a global usage dashboard, data collection begins with this install 🎛️
|
||||
- Added a Playbook Exchange for downloading pre-defined Auto Run playbooks from [Maestro-Playbooks](https://github.com/pedramamini/Maestro-Playbooks) 📕
|
||||
- Bundled OpenSpec commands for structured change proposals 📝
|
||||
- Added pre-release channel support for beta/RC updates 🧪
|
||||
- Implemented global hands-on time tracking across sessions ⏱️
|
||||
- Added new keyboard shortcut for agent settings (Opt+Cmd+, | Ctrl+Alt+,) ⌨️
|
||||
- Added directory size calculation with file/folder counts in file explorer 📊
|
||||
- TAKE TWO! Fixed Linux ARM64 build architecture contamination issues 🏗️
|
||||
|
||||
### v0.13.1 Changes
|
||||
- Fixed Linux ARM64 build architecture contamination issues 🏗️
|
||||
- Enhanced error handling for Auto Run batch processing 🚨
|
||||
|
||||
### v0.13.0 Changes
|
||||
- Added a global usage dashboard, data collection begins with this install 🎛️
|
||||
- Added a Playbook Exchange for downloading pre-defined Auto Run playbooks from [Maestro-Playbooks](https://github.com/pedramamini/Maestro-Playbooks) 📕
|
||||
- Bundled OpenSpec commands for structured change proposals 📝
|
||||
- Added pre-release channel support for beta/RC updates 🧪
|
||||
- Implemented global hands-on time tracking across sessions ⏱️
|
||||
- Added new keyboard shortcut for agent settings (Opt+Cmd+, | Ctrl+Alt+,) ⌨️
|
||||
- Added directory size calculation with file/folder counts in file explorer 📊
|
||||
- Added sleep detection to exclude laptop sleep from time tracking ⏰
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -97,22 +98,22 @@ Thanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @d
|
||||
|
||||
**Latest: v0.12.3** | Released December 28, 2025
|
||||
|
||||
The big changes in the v0.12.x line are the following three:
|
||||
|
||||
## Show Thinking
|
||||
🤔 There is now a toggle to show thinking for the agent, the default for new tabs is off, though this can be changed under Settings > General. The toggle shows next to History and Read-Only. Very similar pattern. This has been the #1 most requested feature, though personally, I don't think I'll use it as I prefer to not see the details of the work, but the results of the work. Just as we work with our colleagues.
|
||||
|
||||
## GitHub Spec-Kit Integration
|
||||
🎯 Added [GitHub Spec-Kit](https://github.com/github/spec-kit) commands into Maestro with a built in updater to grab the latest prompts from the repository. We do override `/speckit-implement` (the final step) to create Auto Run docs and guide the user through their execution, which thanks to Wortrees from v0.11.x allows us to run in parallel!
|
||||
|
||||
## Context Management Tools
|
||||
📖 Added context management options from tab right-click menu. You can now compress, merge, and transfer contexts between agents. You will received (configurable) warnings at 60% and 80% context consumption with a hint to compact.
|
||||
|
||||
## Changes Specific to v0.12.3:
|
||||
- We now have hosted documentation through Mintlify 📚
|
||||
- Export any tab conversation as self-contained themed HTML file 📄
|
||||
- Publish files as private/public Gists 🌐
|
||||
- Added tab hover overlay menu with close operations and export 📋
|
||||
The big changes in the v0.12.x line are the following three:
|
||||
|
||||
## Show Thinking
|
||||
🤔 There is now a toggle to show thinking for the agent, the default for new tabs is off, though this can be changed under Settings > General. The toggle shows next to History and Read-Only. Very similar pattern. This has been the #1 most requested feature, though personally, I don't think I'll use it as I prefer to not see the details of the work, but the results of the work. Just as we work with our colleagues.
|
||||
|
||||
## GitHub Spec-Kit Integration
|
||||
🎯 Added [GitHub Spec-Kit](https://github.com/github/spec-kit) commands into Maestro with a built in updater to grab the latest prompts from the repository. We do override `/speckit-implement` (the final step) to create Auto Run docs and guide the user through their execution, which thanks to Wortrees from v0.11.x allows us to run in parallel!
|
||||
|
||||
## Context Management Tools
|
||||
📖 Added context management options from the tab hover overlay menu. You can now compress, merge, and transfer contexts between agents. You will receive (configurable) warnings at 60% and 80% context consumption with a hint to compact.
|
||||
|
||||
## Changes Specific to v0.12.3:
|
||||
- We now have hosted documentation through Mintlify 📚
|
||||
- Export any tab conversation as self-contained themed HTML file 📄
|
||||
- Publish files as private/public Gists 🌐
|
||||
- Added tab hover overlay menu with close operations and export 📋
|
||||
- Added social handles to achievement share images 🏆
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -126,12 +127,12 @@ The big changes in the v0.12.x line are the following three:
|
||||
|
||||
**Latest: v0.11.0** | Released December 22, 2025
|
||||
|
||||
🌳 Github Worktree support was added. Any agent bound to a Git repository has the option to enable worktrees, each of which show up as a sub-agent with their own write-lock and Auto Run capability. Now you can truly develop in parallel on the same project and issue PRs when you're ready, all from within Maestro. Huge improvement, major thanks to @petersilberman.
|
||||
|
||||
# Other Changes
|
||||
|
||||
- @ file mentions now include documents from your Auto Run folder (which may not live in your agent working directory) 🗄️
|
||||
- The wizard is now capable of detecting and continuing on past started projects 🧙
|
||||
🌳 Github Worktree support was added. Any agent bound to a Git repository has the option to enable worktrees, each of which show up as a sub-agent with their own write-lock and Auto Run capability. Now you can truly develop in parallel on the same project and issue PRs when you're ready, all from within Maestro. Huge improvement, major thanks to @petersilberman.
|
||||
|
||||
# Other Changes
|
||||
|
||||
- @ file mentions now include documents from your Auto Run folder (which may not live in your agent working directory) 🗄️
|
||||
- The wizard is now capable of detecting and continuing on past started projects 🧙
|
||||
- Bug fixes 🐛🐜🐞
|
||||
|
||||
---
|
||||
@@ -142,14 +143,14 @@ The big changes in the v0.12.x line are the following three:
|
||||
|
||||
### Changes
|
||||
|
||||
- Export group chats as self-contained HTML ⬇️
|
||||
- Enhanced system process viewer now has details view with full process args 💻
|
||||
- Update button hides until platform binaries are available in releases. ⏳
|
||||
- Added Auto Run stall detection at the loop level, if no documents are updated after a loop 🔁
|
||||
- Improved Codex session discovery 🔍
|
||||
- Windows compatibility fixes 🐛
|
||||
- 64-bit Linux ARM build issue fixed (thanks @LilYoopug) 🐜
|
||||
- Addressed session enumeration issues with Codex and OpenCode 🐞
|
||||
- Export group chats as self-contained HTML ⬇️
|
||||
- Enhanced system process viewer now has details view with full process args 💻
|
||||
- Update button hides until platform binaries are available in releases. ⏳
|
||||
- Added Auto Run stall detection at the loop level, if no documents are updated after a loop 🔁
|
||||
- Improved Codex session discovery 🔍
|
||||
- Windows compatibility fixes 🐛
|
||||
- 64-bit Linux ARM build issue fixed (thanks @LilYoopug) 🐜
|
||||
- Addressed session enumeration issues with Codex and OpenCode 🐞
|
||||
- Addressed pathing issues around gh command (thanks @oliveiraantoniocc) 🐝
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -165,13 +166,13 @@ The big changes in the v0.12.x line are the following three:
|
||||
|
||||
### Changes
|
||||
|
||||
- Add Sentry crashing reporting monitoring with opt-out 🐛
|
||||
- Stability fixes on v0.9.0 along with all the changes it brought along, including...
|
||||
- Major refactor to enable supporting of multiple providers 👨👩👧👦
|
||||
- Added OpenAI Codex support 👨💻
|
||||
- Added OpenCode support 👩💻
|
||||
- Error handling system detects and recovers from agent failures 🚨
|
||||
- Added option to specify CLI arguments to AI providers ✨
|
||||
- Add Sentry crashing reporting monitoring with opt-out 🐛
|
||||
- Stability fixes on v0.9.0 along with all the changes it brought along, including...
|
||||
- Major refactor to enable supporting of multiple providers 👨👩👧👦
|
||||
- Added OpenAI Codex support 👨💻
|
||||
- Added OpenCode support 👩💻
|
||||
- Error handling system detects and recovers from agent failures 🚨
|
||||
- Added option to specify CLI arguments to AI providers ✨
|
||||
- Bunch of other little tweaks and additions 💎
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -186,19 +187,19 @@ The big changes in the v0.12.x line are the following three:
|
||||
|
||||
### Changes
|
||||
|
||||
- Added "Nudge" messages. Short static copy to include with every interactive message sent, perhaps to remind the agent on how to work 📌
|
||||
- Addressed various resource consumption issues to reduce battery cost 📉
|
||||
- Implemented fuzzy file search in quick actions for instant navigation 🔍
|
||||
- Added "clear" command support to clean terminal shell logs 🧹
|
||||
- Simplified search highlighting by integrating into markdown pipeline ✨
|
||||
- Enhanced update checker to filter prerelease tags like -rc, -beta 🚀
|
||||
- Fixed RPM package compatibility for OpenSUSE Tumbleweed 🐧 (H/T @JOduMonT)
|
||||
- Added libuuid1 support alongside standard libuuid dependency 📦
|
||||
- Introduced Cmd+Shift+U shortcut for tab unread toggle ⌨️
|
||||
- Enhanced keyboard navigation for marking tabs unread 🎯
|
||||
- Expanded Linux distribution support with smart dependencies 🌐
|
||||
- Major underlying code re-structuring for maintainability 🧹
|
||||
- Improved stall detection to allow for individual docs to stall out while not affecting the entire playbook 📖 (H/T @mattjay)
|
||||
- Added "Nudge" messages. Short static copy to include with every interactive message sent, perhaps to remind the agent on how to work 📌
|
||||
- Addressed various resource consumption issues to reduce battery cost 📉
|
||||
- Implemented fuzzy file search in quick actions for instant navigation 🔍
|
||||
- Added "clear" command support to clean terminal shell logs 🧹
|
||||
- Simplified search highlighting by integrating into markdown pipeline ✨
|
||||
- Enhanced update checker to filter prerelease tags like -rc, -beta 🚀
|
||||
- Fixed RPM package compatibility for OpenSUSE Tumbleweed 🐧 (H/T @JOduMonT)
|
||||
- Added libuuid1 support alongside standard libuuid dependency 📦
|
||||
- Introduced Cmd+Shift+U shortcut for tab unread toggle ⌨️
|
||||
- Enhanced keyboard navigation for marking tabs unread 🎯
|
||||
- Expanded Linux distribution support with smart dependencies 🌐
|
||||
- Major underlying code re-structuring for maintainability 🧹
|
||||
- Improved stall detection to allow for individual docs to stall out while not affecting the entire playbook 📖 (H/T @mattjay)
|
||||
- Added option to select a static listening port for remote control 🎮 (H/T @b3nw)
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -218,35 +219,35 @@ The big changes in the v0.12.x line are the following three:
|
||||
|
||||
**Latest: v0.7.4** | Released December 12, 2025
|
||||
|
||||
Minor bugfixes on top of v0.7.3:
|
||||
|
||||
# Onboarding, Wizard, and Tours
|
||||
- Implemented comprehensive onboarding wizard with integrated tour system 🚀
|
||||
- Added project-understanding confidence display to wizard UI 🎨
|
||||
- Enhanced keyboard navigation across all wizard screens ⌨️
|
||||
- Added analytics tracking for wizard and tour completion 📈
|
||||
- Added First Run Celebration modal with confetti animation 🎉
|
||||
|
||||
# UI / UX Enhancements
|
||||
- Added expand-to-fullscreen button for Auto Run interface 🖥️
|
||||
- Created dedicated modal component and improved modal priority constants for expanded Auto Run view 📐
|
||||
- Enhanced user experience with fullscreen editing capabilities ✨
|
||||
- Fixed tab name display to correctly show full name for active tabs 🏷️
|
||||
- Added performance optimizations with throttling and caching for scrolling ⚡
|
||||
- Implemented drag-and-drop reordering for execution queue items 🎯
|
||||
- Enhanced toast context with agent name for OS notifications 📢
|
||||
|
||||
# Auto Run Workflow Improvements
|
||||
- Created phase document generation for Auto Run workflow 📄
|
||||
- Added real-time log streaming to the LogViewer component 📊
|
||||
|
||||
# Application Behavior / Core Fixes
|
||||
- Added validation to prevent nested worktrees inside the main repository 🚫
|
||||
- Fixed process manager to properly emit exit events on errors 🔧
|
||||
- Fixed process exit handling to ensure proper cleanup 🧹
|
||||
|
||||
# Update System
|
||||
- Implemented automatic update checking on application startup 🚀
|
||||
Minor bugfixes on top of v0.7.3:
|
||||
|
||||
# Onboarding, Wizard, and Tours
|
||||
- Implemented comprehensive onboarding wizard with integrated tour system 🚀
|
||||
- Added project-understanding confidence display to wizard UI 🎨
|
||||
- Enhanced keyboard navigation across all wizard screens ⌨️
|
||||
- Added analytics tracking for wizard and tour completion 📈
|
||||
- Added First Run Celebration modal with confetti animation 🎉
|
||||
|
||||
# UI / UX Enhancements
|
||||
- Added expand-to-fullscreen button for Auto Run interface 🖥️
|
||||
- Created dedicated modal component and improved modal priority constants for expanded Auto Run view 📐
|
||||
- Enhanced user experience with fullscreen editing capabilities ✨
|
||||
- Fixed tab name display to correctly show full name for active tabs 🏷️
|
||||
- Added performance optimizations with throttling and caching for scrolling ⚡
|
||||
- Implemented drag-and-drop reordering for execution queue items 🎯
|
||||
- Enhanced toast context with agent name for OS notifications 📢
|
||||
|
||||
# Auto Run Workflow Improvements
|
||||
- Created phase document generation for Auto Run workflow 📄
|
||||
- Added real-time log streaming to the LogViewer component 📊
|
||||
|
||||
# Application Behavior / Core Fixes
|
||||
- Added validation to prevent nested worktrees inside the main repository 🚫
|
||||
- Fixed process manager to properly emit exit events on errors 🔧
|
||||
- Fixed process exit handling to ensure proper cleanup 🧹
|
||||
|
||||
# Update System
|
||||
- Implemented automatic update checking on application startup 🚀
|
||||
- Added settings toggle for enabling/disabling startup update checks ⚙️
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -262,39 +263,39 @@ Minor bugfixes on top of v0.7.3:
|
||||
|
||||
**Latest: v0.6.1** | Released December 4, 2025
|
||||
|
||||
In this release...
|
||||
- Added recursive subfolder support for Auto Run markdown files 🗂️
|
||||
- Enhanced document tree display with expandable folder navigation 🌳
|
||||
- Enabled creating documents in subfolders with path selection 📁
|
||||
- Improved batch runner UI with inline progress bars and loop indicators 📊
|
||||
- Fixed execution queue display bug for immediate command processing 🐛
|
||||
- Added folder icons and better visual hierarchy for document browser 🎨
|
||||
- Implemented dynamic task re-counting for batch run loop iterations 🔄
|
||||
- Enhanced create document modal with location selector dropdown 📍
|
||||
- Improved progress tracking with per-document completion visualization 📈
|
||||
- Added support for nested folder structures in document management 🏗️
|
||||
|
||||
Plus the pre-release ALPHA...
|
||||
- Template vars now set context in default autorun prompt 🚀
|
||||
- Added Enter key support for queued message confirmation dialog ⌨️
|
||||
- Kill process capability added to System Process Monitor 💀
|
||||
- Toggle markdown rendering added to Cmd+K Quick Actions 📝
|
||||
- Fixed cloudflared detection in packaged app environments 🔧
|
||||
- Added debugging logs for process exit diagnostics 🐛
|
||||
- Tab switcher shows last activity timestamps and filters by project 🕐
|
||||
- Slash commands now fill text on Tab/Enter instead of executing ⚡
|
||||
- Added GitHub Actions workflow for auto-assigning issues/PRs 🤖
|
||||
- Graceful handling for playbooks with missing documents implemented ✨
|
||||
- Added multi-document batch processing for Auto Run 🚀
|
||||
- Introduced Git worktree support for parallel execution 🌳
|
||||
- Created playbook system for saving run configurations 📚
|
||||
- Implemented document reset-on-completion with loop mode 🔄
|
||||
- Added drag-and-drop document reordering interface 🎯
|
||||
- Built Auto Run folder selector with file management 📁
|
||||
- Enhanced progress tracking with per-document metrics 📊
|
||||
- Integrated PR creation after worktree completion 🔀
|
||||
- Added undo/redo support in document editor ↩️
|
||||
- Implemented auto-save with 5-second debounce 💾
|
||||
In this release...
|
||||
- Added recursive subfolder support for Auto Run markdown files 🗂️
|
||||
- Enhanced document tree display with expandable folder navigation 🌳
|
||||
- Enabled creating documents in subfolders with path selection 📁
|
||||
- Improved batch runner UI with inline progress bars and loop indicators 📊
|
||||
- Fixed execution queue display bug for immediate command processing 🐛
|
||||
- Added folder icons and better visual hierarchy for document browser 🎨
|
||||
- Implemented dynamic task re-counting for batch run loop iterations 🔄
|
||||
- Enhanced create document modal with location selector dropdown 📍
|
||||
- Improved progress tracking with per-document completion visualization 📈
|
||||
- Added support for nested folder structures in document management 🏗️
|
||||
|
||||
Plus the pre-release ALPHA...
|
||||
- Template vars now set context in default autorun prompt 🚀
|
||||
- Added Enter key support for queued message confirmation dialog ⌨️
|
||||
- Kill process capability added to System Process Monitor 💀
|
||||
- Toggle markdown rendering added to Cmd+K Quick Actions 📝
|
||||
- Fixed cloudflared detection in packaged app environments 🔧
|
||||
- Added debugging logs for process exit diagnostics 🐛
|
||||
- Tab switcher shows last activity timestamps and filters by project 🕐
|
||||
- Slash commands now fill text on Tab/Enter instead of executing ⚡
|
||||
- Added GitHub Actions workflow for auto-assigning issues/PRs 🤖
|
||||
- Graceful handling for playbooks with missing documents implemented ✨
|
||||
- Added multi-document batch processing for Auto Run 🚀
|
||||
- Introduced Git worktree support for parallel execution 🌳
|
||||
- Created playbook system for saving run configurations 📚
|
||||
- Implemented document reset-on-completion with loop mode 🔄
|
||||
- Added drag-and-drop document reordering interface 🎯
|
||||
- Built Auto Run folder selector with file management 📁
|
||||
- Enhanced progress tracking with per-document metrics 📊
|
||||
- Integrated PR creation after worktree completion 🔀
|
||||
- Added undo/redo support in document editor ↩️
|
||||
- Added manual save via `Cmd+S`/`Ctrl+S` in document editor 💾
|
||||
|
||||
### Previous Releases in this Series
|
||||
|
||||
@@ -308,15 +309,15 @@ Plus the pre-release ALPHA...
|
||||
|
||||
### Changes
|
||||
|
||||
- Added "Made with Maestro" badge to README header 🎯
|
||||
- Redesigned app icon with darker purple color scheme 🎨
|
||||
- Created new SVG badge for project attribution 🏷️
|
||||
- Added side-by-side image diff viewer for git changes 🖼️
|
||||
- Enhanced confetti animation with realistic cannon-style bursts 🎊
|
||||
- Fixed z-index layering for standing ovation overlay 📊
|
||||
- Improved tab switcher to show all named sessions 🔍
|
||||
- Enhanced batch synopsis prompts for cleaner summaries 📝
|
||||
- Added binary file detection in git diff parser 🔧
|
||||
- Added "Made with Maestro" badge to README header 🎯
|
||||
- Redesigned app icon with darker purple color scheme 🎨
|
||||
- Created new SVG badge for project attribution 🏷️
|
||||
- Added side-by-side image diff viewer for git changes 🖼️
|
||||
- Enhanced confetti animation with realistic cannon-style bursts 🎊
|
||||
- Fixed z-index layering for standing ovation overlay 📊
|
||||
- Improved tab switcher to show all named sessions 🔍
|
||||
- Enhanced batch synopsis prompts for cleaner summaries 📝
|
||||
- Added binary file detection in git diff parser 🔧
|
||||
- Implemented git file reading at specific refs 📁
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -331,24 +332,24 @@ Plus the pre-release ALPHA...
|
||||
|
||||
### Changes
|
||||
|
||||
- Added Tab Switcher modal for quick navigation between AI tabs 🚀
|
||||
- Implemented @ mention file completion for AI mode references 📁
|
||||
- Added navigation history with back/forward through sessions and tabs ⏮️
|
||||
- Introduced tab completion filters for branches, tags, and files 🌳
|
||||
- Added unread tab indicators and filtering for better organization 📬
|
||||
- Implemented token counting display with human-readable formatting 🔢
|
||||
- Added markdown rendering toggle for AI responses in terminal 📝
|
||||
- Removed built-in slash commands in favor of custom AI commands 🎯
|
||||
- Added context menu for sessions with rename, bookmark, move options 🖱️
|
||||
- Enhanced file preview with stats showing size, tokens, timestamps 📊
|
||||
- Added token counting with js-tiktoken for file preview stats bar 🔢
|
||||
- Implemented Tab Switcher modal for fuzzy-search navigation (Opt+Cmd+T) 🔍
|
||||
- Added Save to History toggle (Cmd+S) for automatic work synopsis tracking 💾
|
||||
- Enhanced tab completion with @ mentions for file references in AI prompts 📎
|
||||
- Implemented navigation history with back/forward shortcuts (Cmd+Shift+,/.) 🔙
|
||||
- Added git branches and tags to intelligent tab completion system 🌿
|
||||
- Enhanced markdown rendering with syntax highlighting and toggle view 📝
|
||||
- Added right-click context menus for session management and organization 🖱️
|
||||
- Added Tab Switcher modal for quick navigation between AI tabs 🚀
|
||||
- Implemented @ mention file completion for AI mode references 📁
|
||||
- Added navigation history with back/forward through sessions and tabs ⏮️
|
||||
- Introduced tab completion filters for branches, tags, and files 🌳
|
||||
- Added unread tab indicators and filtering for better organization 📬
|
||||
- Implemented token counting display with human-readable formatting 🔢
|
||||
- Added markdown rendering toggle for AI responses in terminal 📝
|
||||
- Removed built-in slash commands in favor of custom AI commands 🎯
|
||||
- Added context menu for sessions with rename, bookmark, move options 🖱️
|
||||
- Enhanced file preview with stats showing size, tokens, timestamps 📊
|
||||
- Added token counting with js-tiktoken for file preview stats bar 🔢
|
||||
- Implemented Tab Switcher modal for fuzzy-search navigation (Opt+Cmd+T) 🔍
|
||||
- Added Save to History toggle (Cmd+S) for automatic work synopsis tracking 💾
|
||||
- Enhanced tab completion with @ mentions for file references in AI prompts 📎
|
||||
- Implemented navigation history with back/forward shortcuts (Cmd+Shift+,/.) 🔙
|
||||
- Added git branches and tags to intelligent tab completion system 🌿
|
||||
- Enhanced markdown rendering with syntax highlighting and toggle view 📝
|
||||
- Added right-click context menus for session management and organization 🖱️
|
||||
- Improved mobile app with better WebSocket reconnection and status badges 📱
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -363,15 +364,15 @@ Plus the pre-release ALPHA...
|
||||
|
||||
### Changes
|
||||
|
||||
- Fixed tab handling requiring explicitly selected Claude session 🔧
|
||||
- Added auto-scroll navigation for slash command list selection ⚡
|
||||
- Implemented TTS audio feedback for toast notifications speak 🔊
|
||||
- Fixed shortcut case sensitivity using lowercase key matching 🔤
|
||||
- Added Cmd+Shift+J shortcut to jump to bottom instantly ⬇️
|
||||
- Sorted shortcuts alphabetically in help modal for discovery 📑
|
||||
- Display full commit message body in git log view 📝
|
||||
- Added expand/collapse all buttons to process tree header 🌳
|
||||
- Support synopsis process type in process tree parsing 🔍
|
||||
- Fixed tab handling requiring explicitly selected Claude session 🔧
|
||||
- Added auto-scroll navigation for slash command list selection ⚡
|
||||
- Implemented TTS audio feedback for toast notifications speak 🔊
|
||||
- Fixed shortcut case sensitivity using lowercase key matching 🔤
|
||||
- Added Cmd+Shift+J shortcut to jump to bottom instantly ⬇️
|
||||
- Sorted shortcuts alphabetically in help modal for discovery 📑
|
||||
- Display full commit message body in git log view 📝
|
||||
- Added expand/collapse all buttons to process tree header 🌳
|
||||
- Support synopsis process type in process tree parsing 🔍
|
||||
- Renamed "No Group" to "UNGROUPED" for better clarity ✨
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -384,15 +385,15 @@ Plus the pre-release ALPHA...
|
||||
|
||||
**Latest: v0.2.3** | Released November 29, 2025
|
||||
|
||||
• Enhanced mobile web interface with session sync and history panel 📱
|
||||
• Added ThinkingStatusPill showing real-time token counts and elapsed time ⏱️
|
||||
• Implemented task count badges and session deduplication for batch runner 📊
|
||||
• Added TTS stop control and improved voice synthesis compatibility 🔊
|
||||
• Created image lightbox with navigation, clipboard, and delete features 🖼️
|
||||
• Fixed UI bugs in search, auto-scroll, and sidebar interactions 🐛
|
||||
• Added global Claude stats with streaming updates across projects 📈
|
||||
• Improved markdown checkbox styling and collapsed palette hover UX ✨
|
||||
• Enhanced scratchpad with search, image paste, and attachment support 🔍
|
||||
• Enhanced mobile web interface with session sync and history panel 📱
|
||||
• Added ThinkingStatusPill showing real-time token counts and elapsed time ⏱️
|
||||
• Implemented task count badges and session deduplication for batch runner 📊
|
||||
• Added TTS stop control and improved voice synthesis compatibility 🔊
|
||||
• Created image lightbox with navigation, clipboard, and delete features 🖼️
|
||||
• Fixed UI bugs in search, auto-scroll, and sidebar interactions 🐛
|
||||
• Added global Claude stats with streaming updates across projects 📈
|
||||
• Improved markdown checkbox styling and collapsed palette hover UX ✨
|
||||
• Enhanced scratchpad with search, image paste, and attachment support 🔍
|
||||
• Added splash screen with logo and progress bar during startup 🎨
|
||||
|
||||
### Previous Releases in this Series
|
||||
@@ -407,15 +408,15 @@ Plus the pre-release ALPHA...
|
||||
|
||||
**Latest: v0.1.6** | Released November 27, 2025
|
||||
|
||||
• Added template variables for dynamic AI command customization 🎯
|
||||
• Implemented session bookmarking with star icons and dedicated section ⭐
|
||||
• Enhanced Git Log Viewer with smarter date formatting 📅
|
||||
• Improved GitHub release workflow to handle partial failures gracefully 🔧
|
||||
• Added collapsible template documentation in AI Commands panel 📚
|
||||
• Updated default commit command with session ID traceability 🔍
|
||||
• Added tag indicators for custom-named sessions visually 🏷️
|
||||
• Improved Git Log search UX with better focus handling 🎨
|
||||
• Fixed input placeholder spacing for better readability 📝
|
||||
• Added template variables for dynamic AI command customization 🎯
|
||||
• Implemented session bookmarking with star icons and dedicated section ⭐
|
||||
• Enhanced Git Log Viewer with smarter date formatting 📅
|
||||
• Improved GitHub release workflow to handle partial failures gracefully 🔧
|
||||
• Added collapsible template documentation in AI Commands panel 📚
|
||||
• Updated default commit command with session ID traceability 🔍
|
||||
• Added tag indicators for custom-named sessions visually 🏷️
|
||||
• Improved Git Log search UX with better focus handling 🎨
|
||||
• Fixed input placeholder spacing for better readability 📝
|
||||
• Updated documentation with new features and template references 📖
|
||||
|
||||
### Previous Releases in this Series
|
||||
|
||||
@@ -81,14 +81,16 @@ View your in-progress Symphony sessions:
|
||||
|
||||
|
||||
Each active contribution shows:
|
||||
- **Issue title and repository** — The GitHub issue being worked on
|
||||
- **Status badge** — Running, Paused, Creating PR, etc.
|
||||
- **Progress bar** — Documents completed vs. total
|
||||
- **Current document** — The document being processed
|
||||
- **Time elapsed** — How long the contribution has been running
|
||||
- **Token usage** — Input/output tokens and estimated cost
|
||||
- **Draft PR link** — Once created on first commit
|
||||
- **Controls** — Pause/Resume, Cancel, Finalize PR
|
||||
|
||||
- Status indicators (Running, Paused, Creating PR, etc.)
|
||||
- Progress bar showing documents completed vs. total
|
||||
- Current document being processed
|
||||
- Token usage (input/output tokens, estimated cost)
|
||||
- Draft PR link (once created on first commit)
|
||||
- Controls: Pause/Resume, Cancel, Finalize PR
|
||||
- **Check PR Status** button to detect merged/closed PRs
|
||||
Click **Check PR Status** to verify your draft PR on GitHub and detect merged/closed PRs.
|
||||
|
||||
### History Tab
|
||||
|
||||
|
||||
Reference in New Issue
Block a user