[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-RunMaestro--Maestro":3,"tool-RunMaestro--Maestro":64},[4,17,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70612,"2026-04-05T11:12:22",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":79,"owner_twitter":80,"owner_website":81,"owner_url":82,"languages":83,"stars":106,"forks":107,"last_commit_at":108,"license":109,"difficulty_score":10,"env_os":110,"env_gpu":111,"env_ram":111,"env_deps":112,"category_tags":115,"github_topics":116,"view_count":122,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":123,"updated_at":124,"faqs":125,"releases":155},238,"RunMaestro\u002FMaestro","Maestro","Agent Orchestration Command Center","Maestro 是一个面向开发者的桌面端 AI 智能体协同指挥中心，帮助用户高效管理多个并行的 AI 编程任务。它解决了开发者在同时处理多个项目时注意力分散、上下文混乱的问题，通过为每个任务分配独立会话和干净上下文，确保长时间自动运行的稳定性（实测支持近 24 小时连续执行）。Maestro 特别适合习惯键盘操作、追求效率的开发者或技术极客，尤其适用于需要反复执行标准化开发流程的场景。其独特功能包括：基于 Git Worktree 的并行分支智能体协作、支持多 AI 模型（如 Claude Code、OpenAI Codex 等）的自动任务执行、群聊式多智能体协调、手机远程监控，以及可集成到 CI\u002FCD 或定时任务中的命令行接口。Maestro 并不替代现有 AI 工具，而是作为统一调度层，让已有 AI 能力更有序、更自动化地服务于复杂开发工作流。","# Maestro\n\n[![Made with Maestro](docs\u002Fassets\u002Fmade-with-maestro.svg)](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Us-5865F2?logo=discord&logoColor=white)](https:\u002F\u002Frunmaestro.ai\u002Fdiscord)\n[![User Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-Usage%20%26%20Documentation-blue?logo=readthedocs&logoColor=white)](https:\u002F\u002Fdocs.runmaestro.ai\u002F)\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F21112\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_4cc089988f35.png\" alt=\"RunMaestro%2FMaestro | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n> Maestro hones fractured attention into focused intent.\n\nMaestro is a cross-platform desktop app for orchestrating your fleet of AI agents and projects. It's a high-velocity solution for hackers who are juggling multiple projects in parallel. Designed for power users who live on the keyboard and rarely touch the mouse.\n\nCollaborate 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.\n\nRun multiple agents in parallel with a Linear\u002FSuperhuman-level responsive interface. Currently supporting **Claude Code**, **OpenAI Codex**, **OpenCode**, and **Factory Droid** with plans for additional agentic coding tools (Gemini CLI, Qwen3 Coder) based on user demand.\n\n> **How It Works:** Maestro is a pass-through to your AI provider. Whatever MCP tools, skills, permissions, or authentication you have configured in Claude Code, Codex, or OpenCode works identically in Maestro. The only difference is we're not running interactively—each task gets a prompt and returns a response, whether it's a new session or resuming a prior one.\n\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FfmwwTOg7cyA?si=dJ89K54tGflKa5G4\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_28c566763a55.png\"\n         alt=\"Maestro Video Thumbnail\"\n         width=\"650\" \u002F>\n  \u003C\u002Fa>\n\n  \u003Cdiv>\n    \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FfmwwTOg7cyA?si=VOkjO6oYjCSQvM0A\">~27m Walkthrough and Demo\u003C\u002Fa>\n     | \n    \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002F3wX5Q1I0sgI?si=oJkJDxgAWUvBXX4D\">~6m Onboarding Demo\u003C\u002Fa>\n  \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n\n## Features\n\n### Power Features\n\n- 🌳 **[Git Worktrees](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgit-worktrees)** - Run AI agents in parallel on isolated branches. Create worktree sub-agents from the git branch menu, each operating in their own directory. Work interactively in the main repo while sub-agents process tasks independently—then create PRs with one click. True parallel development without conflicts.\n- 🤖 **[Auto Run & Playbooks](https:\u002F\u002Fdocs.runmaestro.ai\u002Fautorun-playbooks)** - File-system-based task runner that batch-processes markdown checklists through AI agents. Create playbooks for repeatable workflows, run in loops, and track progress with full history. Each task gets its own AI session for clean conversation context.\n- 💬 **[Group Chat](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgroup-chat)** - Coordinate multiple AI agents in a single conversation. A moderator AI orchestrates discussions, routing questions to the right agents and synthesizing their responses for cross-project questions and architecture discussions.\n- 🌐 **[Mobile Remote Control](https:\u002F\u002Fdocs.runmaestro.ai\u002Fremote-access)** - Built-in web server with QR code access. Monitor and control all your agents from your phone. Supports local network access and remote tunneling via Cloudflare for access from anywhere.\n- 💻 **[Command Line Interface](https:\u002F\u002Fdocs.runmaestro.ai\u002Fcli)** - Full CLI (`maestro-cli`) for headless operation. List agents\u002Fgroups, run playbooks from cron jobs or CI\u002FCD pipelines, with human-readable or JSONL output for scripting.\n- 🚀 **Multi-Agent Management** - Run unlimited agents and terminal sessions in parallel. Each agent has its own workspace, conversation history, and isolated context.\n- 📬 **Message Queueing** - Queue messages while AI is busy; they're sent automatically when the agent becomes ready. Never lose a thought.\n\n### Core Features\n\n- 🔄 **Dual-Mode Sessions** - Each agent has both an AI Terminal and Command Terminal. Switch seamlessly between AI conversation and shell commands with `Cmd+J`.\n- ⌨️ **[Keyboard-First Design](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts)** - Full keyboard control with customizable shortcuts and [mastery tracking](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts#keyboard-mastery) that rewards you for leveling up. `Cmd+K` quick actions, rapid agent switching, and focus management designed for flow state.\n- 📋 **Session Discovery** - Automatically discovers and imports existing sessions from all supported providers, including conversations from before Maestro was installed. Browse, search, star, rename, and resume any session.\n- 🔀 **Git Integration** - Automatic repo detection, branch display, diff viewer, commit logs, and git-aware file completion. Work with git without leaving the app.\n- 📁 **[File Explorer](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgeneral-usage#file-explorer-and-preview)** - Browse project files with syntax highlighting, markdown preview, and image viewing. Reference files in prompts with `@` mentions.\n- 🔍 **[Powerful Output Filtering](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgeneral-usage#output-filtering)** - Search and filter AI output with include\u002Fexclude modes, regex support, and per-response local filters.\n- ⚡ **[Slash Commands](https:\u002F\u002Fdocs.runmaestro.ai\u002Fslash-commands)** - Extensible command system with autocomplete. Create custom commands with template variables for your workflows.\n- 💾 **Draft Auto-Save** - Never lose work. Drafts are automatically saved and restored per session.\n- 🔊 **Speakable Notifications** - Audio alerts with text-to-speech announcements when agents complete tasks.\n- 🎨 **[Beautiful Themes](THEMES.md)** - 12 themes including Dracula, Monokai, Nord, Tokyo Night, GitHub Light, and more.\n- 💰 **Cost Tracking** - Real-time token usage and cost tracking per session and globally.\n- 🏆 **[Achievements](https:\u002F\u002Fdocs.runmaestro.ai\u002Fachievements)** - Level up from Apprentice to Titan of the Baton based on cumulative Auto Run time. 11 conductor-themed ranks to unlock.\n\n### Analytics & Visualization\n\n- 📊 **Usage Dashboard** - Comprehensive analytics for tracking AI usage patterns across all sessions. View aggregated statistics with multiple time ranges (day, week, month, year, all time), compare agent performance, analyze user vs. Auto Run activity distribution, and explore activity heatmaps. Includes CSV export, real-time updates, and configurable colorblind-friendly palettes. Access via `Opt+Cmd+U` (macOS) \u002F `Alt+Ctrl+U` (Windows\u002FLinux) or the Command K menu.\n- 🕸️ **Document Graph** - Visual knowledge graph of your markdown documentation. Automatically discovers internal `[[wiki-links]]` and `[markdown](links)`, visualizes document relationships with interactive nodes and edges. Toggle between force-directed and hierarchical layouts, search\u002Ffilter documents, navigate via keyboard, and track external link references. Includes mini-map, legend, and pagination for large directories. Access from the File Explorer context menu or Command K menu.\n\n#### Keyboard Shortcuts for Analytics Features\n\n**Usage Dashboard** (`Opt+Cmd+U` \u002F `Alt+Ctrl+U`):\n| Action | Key |\n|--------|-----|\n| Navigate view tabs | Arrow Left\u002FRight\u002FUp\u002FDown |\n| Move between sections | Tab \u002F Shift+Tab |\n| Jump to first\u002Flast section | Home \u002F End |\n| Close dashboard | Escape |\n\n**Document Graph** (Command K → \"Document Graph\"):\n| Action | Key |\n|--------|-----|\n| Navigate to connected node | Arrow Up\u002FDown\u002FLeft\u002FRight |\n| Cycle through connections | Tab |\n| Open selected document\u002Flink | Enter |\n| Close graph | Escape |\n| Search documents | Focus search input, type query |\n\nAdditional interactions: Drag nodes to reposition, scroll to zoom, use mini-map for overview.\n\n> **Note**: Maestro supports Claude Code, OpenAI Codex, OpenCode, and Factory Droid. Support for additional agents (Gemini CLI, Qwen3 Coder) may be added in future releases based on community demand.\n\n## Quick Start\n\n### Installation\n\nDownload the latest release for your platform from the [Releases page](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Freleases).\n\nOr build from source:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro.git\ncd Maestro\nnpm install\nnpm run dev\n```\n\n### Requirements\n\n- At least one supported AI coding agent installed and authenticated:\n  - [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) - Anthropic's AI coding assistant\n  - [OpenAI Codex](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex) - OpenAI's coding agent\n  - [OpenCode](https:\u002F\u002Fgithub.com\u002Fsst\u002Fopencode) - Open-source AI coding assistant\n- Git (optional, for git-aware features)\n\n### Essential Keyboard Shortcuts\n\n| Action              | macOS             | Windows\u002FLinux       |\n| ------------------- | ----------------- | ------------------- |\n| Quick Actions       | `Cmd+K`           | `Ctrl+K`            |\n| New Agent           | `Cmd+N`           | `Ctrl+N`            |\n| Switch AI\u002FTerminal  | `Cmd+J`           | `Ctrl+J`            |\n| Previous\u002FNext Agent | `Cmd+[` \u002F `Cmd+]` | `Ctrl+[` \u002F `Ctrl+]` |\n| Toggle Sidebar      | `Cmd+B`           | `Ctrl+B`            |\n| New Tab             | `Cmd+T`           | `Ctrl+T`            |\n| Usage Dashboard     | `Opt+Cmd+U`       | `Alt+Ctrl+U`        |\n| All Shortcuts       | `Cmd+\u002F`           | `Ctrl+\u002F`            |\n\n[Full keyboard shortcut reference](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts)\n\n## Screenshots\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_939d6caf717a.png\" alt=\"Maestro Main Screen\" width=\"800\">\n\u003C\u002Fp>\n\n_Main screen with multiple agents and conversation_\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_e4d07088f400.png\" alt=\"Group Chat\" width=\"800\">\n\u003C\u002Fp>\n\n_Group Chat coordinates multiple AI agents in a single conversation_\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_ca070cbf9982.png\" alt=\"Command Palette\" width=\"800\">\n\u003C\u002Fp>\n\n_Quick Actions palette for rapid navigation (CTRL\u002FCMD + K)_\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_7010d2d737aa.png\" alt=\"Git Diff Viewer\" width=\"800\">\n\u003C\u002Fp>\n\n_Git diff viewer with syntax highlighting_\n\n[See more...](docs\u002Fscreenshots\u002F)\n\n## Documentation\n\nFull documentation and usage guide available at **[docs.runmaestro.ai](https:\u002F\u002Fdocs.runmaestro.ai)**\n\n- [Installation](https:\u002F\u002Fdocs.runmaestro.ai\u002Finstallation)\n- [Getting Started](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgetting-started)\n- [Features Overview](https:\u002F\u002Fdocs.runmaestro.ai\u002Ffeatures)\n- [Auto Run + Playbooks](https:\u002F\u002Fdocs.runmaestro.ai\u002Fautorun-playbooks)\n- [Git Worktrees](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgit-worktrees)\n- [Keyboard Shortcuts](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts)\n- [Context Management](https:\u002F\u002Fdocs.runmaestro.ai\u002Fcontext-management)\n- [MCP Server](https:\u002F\u002Fdocs.runmaestro.ai\u002Fmcp-server) - Connect AI apps to Maestro docs\n- [Troubleshooting](https:\u002F\u002Fdocs.runmaestro.ai\u002Ftroubleshooting)\n\n## Community\n\n- **Discord**: [Join Us](https:\u002F\u002Frunmaestro.ai\u002Fdiscord)\n- **GitHub Issues**: [Report bugs & request features](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues)\n\n## Team\n\nMeet the team behind Maestro at [runmaestro.ai\u002Fteam](https:\u002F\u002Frunmaestro.ai\u002Fteam\u002F).\n\n### Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, architecture details, and contribution guidelines.\n\n## License\n\n[AGPL-3.0 License](LICENSE)\n","# Maestro\n\n[![Made with Maestro](docs\u002Fassets\u002Fmade-with-maestro.svg)](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Us-5865F2?logo=discord&logoColor=white)](https:\u002F\u002Frunmaestro.ai\u002Fdiscord)\n[![User Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-Usage%20%26%20Documentation-blue?logo=readthedocs&logoColor=white)](https:\u002F\u002Fdocs.runmaestro.ai\u002F)\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F21112\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_4cc089988f35.png\" alt=\"RunMaestro%2FMaestro | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n> Maestro 将分散的注意力凝聚为专注的意图。\n\nMaestro 是一款跨平台桌面应用，用于编排（orchestrating）你的 AI 智能体（agent）舰队和项目。它是为同时并行处理多个项目的黑客（hacker）打造的高速解决方案，专为重度依赖键盘、极少使用鼠标的高级用户设计。\n\n与 AI 协作创建详细的规格文档，然后让 Auto Run 自动执行它们——每个任务都在一个全新的会话中运行，并拥有干净的上下文。支持长时间无人值守的运行，我目前的记录是接近 24 小时的连续运行时间。\n\n以媲美 Linear\u002FSuperhuman 的响应速度界面并行运行多个智能体。目前已支持 **Claude Code**、**OpenAI Codex**、**OpenCode** 和 **Factory Droid**，并计划根据用户需求增加更多智能体编程工具（如 Gemini CLI、Qwen3 Coder）。\n\n> **工作原理：** Maestro 是你所用 AI 提供商的直通层（pass-through）。你在 Claude Code、Codex 或 OpenCode 中配置的任何 MCP 工具、技能、权限或认证，在 Maestro 中都能完全一致地工作。唯一的区别在于，我们并非以交互方式运行——每个任务都会收到一个提示（prompt）并返回一个响应，无论是新会话还是恢复之前的会话。\n\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FfmwwTOg7cyA?si=dJ89K54tGflKa5G4\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_28c566763a55.png\"\n         alt=\"Maestro Video Thumbnail\"\n         width=\"650\" \u002F>\n  \u003C\u002Fa>\n\n  \u003Cdiv>\n    \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FfmwwTOg7cyA?si=VOkjO6oYjCSQvM0A\">~27 分钟完整演示与讲解\u003C\u002Fa>\n     | \n    \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002F3wX5Q1I0sgI?si=oJkJDxgAWUvBXX4D\">~6 分钟快速入门演示\u003C\u002Fa>\n  \u003C\u002Fdiv>\n\u003C\u002Fdiv>\n\n## 功能特性\n\n### 高级功能\n\n- 🌳 **[Git 工作树（Git Worktrees）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgit-worktrees)** - 在隔离的分支上并行运行 AI 智能体。从 Git 分支菜单创建工作树子智能体，每个子智能体在自己的目录中独立运行。你可以在主仓库中交互式工作，而子智能体则独立处理任务——完成后一键创建 PR。实现真正无冲突的并行开发。\n- 🤖 **[自动运行（Auto Run）与剧本（Playbooks）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fautorun-playbooks)** - 基于文件系统的任务运行器，通过 AI 智能体批量处理 Markdown 待办清单。为可重复的工作流创建剧本，支持循环运行，并通过完整历史记录跟踪进度。每个任务都拥有独立的 AI 会话，确保对话上下文干净。\n- 💬 **[群组聊天（Group Chat）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgroup-chat)** - 在单一对话中协调多个 AI 智能体。由一个主持人 AI 编排讨论，将问题路由给合适的智能体，并综合其回答，适用于跨项目问题和架构讨论。\n- 🌐 **[移动端远程控制（Mobile Remote Control）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fremote-access)** - 内置 Web 服务器，通过二维码访问。从手机监控和控制所有智能体。支持本地网络访问，并可通过 Cloudflare 隧道实现远程访问。\n- 💻 **[命令行界面（CLI）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fcli)** - 完整的命令行工具（`maestro-cli`），支持无头（headless）操作。可列出智能体\u002F群组、从 cron 作业或 CI\u002FCD 流水线运行剧本，并输出人类可读格式或 JSONL 格式以供脚本使用。\n- 🚀 **多智能体管理** - 并行运行无限数量的智能体和终端会话。每个智能体拥有独立的工作区、对话历史和隔离的上下文。\n- 📬 **消息队列（Message Queueing）** - 当 AI 忙碌时，可将消息排队；一旦智能体就绪，消息将自动发送。永不丢失任何想法。\n\n### 核心功能\n\n- 🔄 **双模式会话** - 每个智能体同时拥有 AI 终端和命令终端。通过 `Cmd+J` 在 AI 对话与 Shell 命令之间无缝切换。\n- ⌨️ **[键盘优先设计（Keyboard-First Design）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts)** - 全键盘控制，支持自定义快捷键，并配备[熟练度追踪（mastery tracking）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts#keyboard-mastery)，随着你技能提升给予奖励。`Cmd+K` 快速操作、快速切换智能体、专注状态管理，助你进入心流（flow state）。\n- 📋 **会话发现（Session Discovery）** - 自动发现并导入所有已支持提供商的现有会话，包括安装 Maestro 之前的对话。可浏览、搜索、收藏、重命名并恢复任意会话。\n- 🔀 **Git 集成** - 自动检测代码仓库、显示当前分支、内置差异查看器（diff viewer）、提交日志，以及具备 Git 感知能力的文件补全。无需离开应用即可高效使用 Git。\n- 📁 **[文件浏览器（File Explorer）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgeneral-usage#file-explorer-and-preview)** - 浏览项目文件，支持语法高亮、Markdown 预览和图片查看。在提示词中通过 `@` 提及引用文件。\n- 🔍 **[强大的输出过滤（Powerful Output Filtering）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgeneral-usage#output-filtering)** - 支持包含\u002F排除模式、正则表达式，以及针对每条响应的本地过滤器，用于搜索和筛选 AI 输出。\n- ⚡ **[斜杠命令（Slash Commands）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fslash-commands)** - 可扩展的命令系统，带自动补全功能。可使用模板变量为你的工作流创建自定义命令。\n- 💾 **草稿自动保存** - 永不丢失工作内容。草稿按会话自动保存并恢复。\n- 🔊 **语音通知（Speakable Notifications）** - 当智能体完成任务时，通过文本转语音（TTS）播放音频提醒。\n- 🎨 **[精美主题（Beautiful Themes）](THEMES.md)** - 提供 12 种主题，包括 Dracula、Monokai、Nord、Tokyo Night、GitHub Light 等。\n- 💰 **成本追踪（Cost Tracking）** - 实时追踪每个会话及全局的 Token 使用量和费用。\n- 🏆 **[成就系统（Achievements）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fachievements)** - 根据累计 Auto Run 运行时间，从“学徒（Apprentice）”逐步升级至“指挥大师（Titan of the Baton）”。共有 11 个以指挥家为主题的等级等待解锁。\n\n### 分析与可视化\n\n- 📊 **使用情况仪表盘（Usage Dashboard）** - 提供全面的分析功能，用于追踪所有会话中的 AI 使用模式。支持多种时间范围（日、周、月、年、全部时间）的聚合统计，可比较不同智能体（agent）的表现，分析用户活动与自动运行（Auto Run）活动的分布，并探索活动热力图。包含 CSV 导出、实时更新以及可配置的色盲友好调色板。可通过 `Opt+Cmd+U`（macOS）或 `Alt+Ctrl+U`（Windows\u002FLinux）快捷键，或通过 Command K 菜单访问。\n- 🕸️ **文档关系图（Document Graph）** - 可视化你的 Markdown 文档知识图谱。自动识别内部的 `[[wiki-links]]` 和 `[markdown](links)` 链接，以交互式节点和边展示文档之间的关系。支持在力导向布局（force-directed）和层级布局（hierarchical）之间切换，可搜索\u002F筛选文档，通过键盘导航，并追踪外部链接引用。对于大型目录，还提供小地图（mini-map）、图例（legend）和分页功能。可通过文件资源管理器上下文菜单或 Command K 菜单访问。\n\n#### 分析功能的键盘快捷键\n\n**使用情况仪表盘** (`Opt+Cmd+U` \u002F `Alt+Ctrl+U`)：\n| 操作 | 按键 |\n|--------|-----|\n| 在视图标签间导航 | 方向键（左\u002F右\u002F上\u002F下） |\n| 在各区域间移动 | Tab \u002F Shift+Tab |\n| 跳转到第一个\u002F最后一个区域 | Home \u002F End |\n| 关闭仪表盘 | Escape |\n\n**文档关系图** (Command K → \"Document Graph\")：\n| 操作 | 按键 |\n|--------|-----|\n| 导航到相连节点 | 方向键（上\u002F下\u002F左\u002F右） |\n| 循环切换连接 | Tab |\n| 打开选中的文档\u002F链接 | Enter |\n| 关闭关系图 | Escape |\n| 搜索文档 | 聚焦搜索框后输入查询 |\n\n其他交互方式：拖拽节点重新定位，滚动缩放，使用小地图查看整体概览。\n\n> **注意**：Maestro 支持 Claude Code、OpenAI Codex、OpenCode 和 Factory Droid。未来版本可能会根据社区需求增加对其他智能体（如 Gemini CLI、Qwen3 Coder）的支持。\n\n## 快速开始\n\n### 安装\n\n从 [Releases 页面](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Freleases) 下载适用于你平台的最新版本。\n\n或从源码构建：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro.git\ncd Maestro\nnpm install\nnpm run dev\n```\n\n### 依赖要求\n\n- 至少安装并认证一个受支持的 AI 编码智能体：\n  - [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) - Anthropic 的 AI 编程助手\n  - [OpenAI Codex](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex) - OpenAI 的编程智能体\n  - [OpenCode](https:\u002F\u002Fgithub.com\u002Fsst\u002Fopencode) - 开源 AI 编程助手\n- Git（可选，用于支持 Git 相关功能）\n\n### 常用键盘快捷键\n\n| 操作              | macOS             | Windows\u002FLinux       |\n| ------------------- | ----------------- | ------------------- |\n| 快速操作（Quick Actions） | `Cmd+K`           | `Ctrl+K`            |\n| 新建智能体（New Agent） | `Cmd+N`           | `Ctrl+N`            |\n| 切换 AI\u002F终端        | `Cmd+J`           | `Ctrl+J`            |\n| 上一个\u002F下一个智能体 | `Cmd+[` \u002F `Cmd+]` | `Ctrl+[` \u002F `Ctrl+]` |\n| 切换侧边栏          | `Cmd+B`           | `Ctrl+B`            |\n| 新建标签页          | `Cmd+T`           | `Ctrl+T`            |\n| 使用情况仪表盘      | `Opt+Cmd+U`       | `Alt+Ctrl+U`        |\n| 查看所有快捷键      | `Cmd+\u002F`           | `Ctrl+\u002F`            |\n\n[完整快捷键参考](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts)\n\n## 截图\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_939d6caf717a.png\" alt=\"Maestro 主界面\" width=\"800\">\n\u003C\u002Fp>\n\n_主界面显示多个智能体及其对话_\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_e4d07088f400.png\" alt=\"群聊模式\" width=\"800\">\n\u003C\u002Fp>\n\n_群聊（Group Chat）在同一对话中协调多个 AI 智能体_\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_ca070cbf9982.png\" alt=\"命令面板\" width=\"800\">\n\u003C\u002Fp>\n\n_快速操作面板，用于快速导航（CTRL\u002FCMD + K）_\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_readme_7010d2d737aa.png\" alt=\"Git 差异查看器\" width=\"800\">\n\u003C\u002Fp>\n\n_带有语法高亮的 Git 差异查看器_\n\n[查看更多...](docs\u002Fscreenshots\u002F)\n\n## 文档\n\n完整文档和使用指南请访问 **[docs.runmaestro.ai](https:\u002F\u002Fdocs.runmaestro.ai)**\n\n- [安装指南](https:\u002F\u002Fdocs.runmaestro.ai\u002Finstallation)\n- [入门教程](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgetting-started)\n- [功能概览](https:\u002F\u002Fdocs.runmaestro.ai\u002Ffeatures)\n- [自动运行 + 剧本（Auto Run + Playbooks）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fautorun-playbooks)\n- [Git 工作树（Git Worktrees）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fgit-worktrees)\n- [键盘快捷键](https:\u002F\u002Fdocs.runmaestro.ai\u002Fkeyboard-shortcuts)\n- [上下文管理（Context Management）](https:\u002F\u002Fdocs.runmaestro.ai\u002Fcontext-management)\n- [MCP Server](https:\u002F\u002Fdocs.runmaestro.ai\u002Fmcp-server) - 将 AI 应用连接到 Maestro 文档\n- [故障排除](https:\u002F\u002Fdocs.runmaestro.ai\u002Ftroubleshooting)\n\n## 社区\n\n- **Discord**: [加入我们](https:\u002F\u002Frunmaestro.ai\u002Fdiscord)\n- **GitHub Issues**: [报告 Bug 与功能请求](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues)\n\n## 团队\n\n了解 Maestro 背后的团队：[runmaestro.ai\u002Fteam](https:\u002F\u002Frunmaestro.ai\u002Fteam\u002F)\n\n### 贡献\n\n有关开发环境搭建、架构细节和贡献指南，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n## 许可证\n\n[AGPL-3.0 许可证](LICENSE)","# Maestro 快速上手指南\n\n## 环境准备\n\n- **操作系统**：支持 macOS、Windows 和 Linux\n- **前置依赖**：\n  - 至少安装并配置以下任一 AI 编码代理（需完成身份认证）：\n    - [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code)\n    - [OpenAI Codex](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex)\n    - [OpenCode](https:\u002F\u002Fgithub.com\u002Fsst\u002Fopencode)\n  - （可选）安装 Git，以启用 Git 相关功能（如分支管理、diff 查看等）\n\n> 注意：Maestro 本身不提供 AI 模型，仅作为你已有 AI 工具的调度器和增强界面。\n\n## 安装步骤\n\n### 方法一：下载预编译版本（推荐）\n\n前往 [GitHub Releases 页面](https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Freleases) 下载对应平台的安装包。\n\n> 国内用户若下载缓慢，可尝试使用 GitHub 加速镜像（如 https:\u002F\u002Fghproxy.com\u002F）或通过代理下载。\n\n### 方法二：从源码构建\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro.git\ncd Maestro\nnpm install\nnpm run dev\n```\n\n> 建议使用国内 npm 镜像加速依赖安装，例如：\n> ```bash\n> npm install --registry https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 基本使用\n\n1. **启动 Maestro**  \n   安装完成后直接运行应用。\n\n2. **创建新 Agent**  \n   使用快捷键 `Cmd+N`（macOS）或 `Ctrl+N`（Windows\u002FLinux）新建一个 AI Agent。  \n   Maestro 会自动检测你已配置的 AI 工具（如 Claude Code、Codex 等）。\n\n3. **与 AI 协作**  \n   - 在 AI Terminal 中输入任务描述（例如：“生成一个 Python Flask 的 Hello World 应用”）\n   - 使用 `@文件名` 引用项目中的文件\n   - 按 `Enter` 发送，AI 将在独立会话中执行任务\n\n4. **切换终端模式**  \n   按 `Cmd+J` \u002F `Ctrl+J` 可在 AI 对话与 Shell 命令终端之间快速切换。\n\n5. **运行自动化任务（Auto Run）**  \n   创建一个 Markdown 格式的 checklist 文件（即 Playbook），例如：\n   ```markdown\n   - [ ] 初始化项目结构\n   - [ ] 编写主程序\n   - [ ] 添加单元测试\n   ```\n   然后通过 `Cmd+K` → “Run Playbook” 启动自动执行，每个任务将在干净的 AI 会话中运行。\n\n> 提示：按 `Cmd+K` \u002F `Ctrl+K` 打开命令面板，可快速访问所有功能。","一位独立开发者正在同时维护三个开源项目：一个 Python Web 框架、一个 React 组件库和一个 CLI 工具，每个项目都需要定期更新文档、修复漏洞并响应社区 Issue。\n\n### 没有 Maestro 时\n- 需要手动在不同终端窗口间切换，为每个项目单独启动 AI 编码助手，上下文容易混淆，导致生成代码出错。\n- 处理多个项目的文档更新任务时，只能逐个执行，无法批量调度，效率低下且容易遗漏。\n- 在主分支上直接让 AI 修改代码，常因并发操作引发 Git 冲突，需反复回退和重试。\n- 无法远程查看长时间运行的自动化任务状态，必须守在电脑前等待结果。\n- 缺乏统一界面协调多个 AI 角色（如“文档专家”“测试工程师”），协作逻辑需手动编排。\n\n### 使用 Maestro 后\n- 利用 Git Worktrees 功能，为每个项目自动创建隔离分支和专属 AI 代理，互不干扰，修改完成后一键提交 PR。\n- 通过 Auto Run 执行预设的 Markdown 清单，批量处理三项目的文档生成与测试用例编写，每个任务拥有独立会话上下文。\n- Group Chat 功能让多个 AI 代理协同讨论架构问题，由“主持人”AI 整合建议，快速形成技术方案。\n- 通过手机扫描二维码即可远程监控所有代理运行状态，即使外出也能随时干预或暂停任务。\n- 借助 CLI 将日常维护流程集成到 cron 定时任务中，实现夜间自动巡检与修复。\n\nMaestro 将碎片化的多项目开发流整合为可并行、可追溯、可远程操控的高效智能工作流。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FRunMaestro_Maestro_28c56676.png","RunMaestro","RunMaestro.ai","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FRunMaestro_b8f304d2.png","Maestro is a cross-platform desktop app for conducting your fleet of AI agents and projects. ",null,"RunMaestroAI","https:\u002F\u002Frunmaestro.ai","https:\u002F\u002Fgithub.com\u002FRunMaestro",[84,88,92,96,100,103],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",99.7,{"name":89,"color":90,"percentage":91},"JavaScript","#f1e05a",0.2,{"name":93,"color":94,"percentage":95},"CSS","#663399",0.1,{"name":97,"color":98,"percentage":99},"HTML","#e34c26",0,{"name":101,"color":102,"percentage":99},"PowerShell","#012456",{"name":104,"color":105,"percentage":99},"Shell","#89e051",2637,268,"2026-04-05T06:18:32","AGPL-3.0","Linux, macOS, Windows","未说明",{"notes":113,"python":111,"dependencies":114},"需要至少安装并配置一个支持的 AI 编码代理（如 Claude Code、OpenAI Codex、OpenCode 或 Factory Droid）；Git 为可选依赖，用于启用 Git 相关功能；可通过 npm 构建和运行项目。",[],[15],[117,118,119,120,121],"ai-agents","claude-code","generative-ai","codex","opencode",4,"2026-03-27T02:49:30.150509","2026-04-06T05:17:44.513923",[126,131,136,141,146,151],{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},715,"在远程 SSH 主机上配置 Agent 时，为什么 Maestro 仍然检测本地的 CLI 工具（如 claude）而不是远程主机上的？","这是因为在 0.15.0 版本之前，Agent 检测逻辑仅在本地运行，未通过 SSH 在远程主机上执行检测命令。该问题已在 v0.15.0 中修复，现在创建 Agent 时会正确使用 SSH 配置在远程主机上检测工具。","https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues\u002F181",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},716,"点击“Compact & Continue”按钮没有反应，上下文长度限制问题如何解决？","该问题是由于 Group Chat 功能未正确支持 SSH 远程执行导致的。已在提交 b7614b25 中修复：引入了可复用的 SSH spawn 包装器，并确保 Moderator 和 Participant 的启动尊重 SSH 配置。此修复包含在 v0.15.0 版本中。","https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues\u002F172",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},717,"Windows 上已将 claude.exe 加入 PATH，但 Maestro 仍无法检测到 Claude，怎么办？","该问题在 v0.12.3 及更高版本（如 v0.14.0）中已修复。请确保使用 v0.14.0 或更新版本。如果仍存在问题，可尝试手动指定 claude.exe 的完整路径（如 C:\\Users\\\u003Cuser>\\.local\\bin\\claude.exe）。","https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues\u002F60",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},718,"提示时立即报错“命令行太长”（code 1），如何解决？","该错误通常发生在 Windows 上使用 .cmd 后缀的代理脚本时，因为 cmd.exe 有命令行长度限制。解决方案是改用 .ps1（PowerShell）或 .exe 格式的代理路径。Maestro 对 .exe 文件不会调用 cmd.exe，可避免此限制。请检查自动检测到的 Agent 路径是否为 .cmd，若是，请手动更改为 .ps1 或 .exe 版本。","https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues\u002F296",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},719,"在 Windows 上从源码构建 Maestro 时，报错“Could not find any Visual Studio installation to use”，如何解决？","Maestro 在 Windows 上构建需要 Visual Studio 构建工具（而不仅仅是 VS Code）。官方已在 BUILDING_WINDOWS.md 文档中说明构建步骤。该问题已在 v0.15.1 中修复，建议直接使用预编译版本，或按文档安装 Visual Studio Build Tools 并确保 node-gyp 能找到它。","https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fissues\u002F156",{"id":152,"question_zh":153,"answer_zh":154,"source_url":150},720,"SSH 远程连接时提示“Permission denied (publickey,password)”，但手动 ssh 命令可以正常连接，原因是什么？","这可能是因为 Maestro 在解析 SSH 密钥路径时未正确展开 ~ 符号。尝试使用绝对路径（如 C:\u002FUsers\u002F\u003Cusername>\u002F.ssh\u002Fid_ed25519）代替 ~\u002F.ssh\u002Fid_ed25519。该问题属于 Windows 下 SSH 路径处理的已知问题，已在相关构建修复中一并处理（见 #156）。",[156,161,166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241,246,251],{"id":157,"version":158,"summary_zh":159,"released_at":160},100275,"v0.15.3","# Major 0.15.x Additions\r\n\r\n🎶 **Maestro Symphony** — Contribute to open source with AI assistance! Browse curated issues from projects with the `runmaestro.ai` label, clone repos with one click, and automatically process the relevant Auto Run playbooks. Track your contributions, streaks, and stats. You're contributing CPU and tokens towards your favorite open source projects and features.\r\n\r\n🎬 **Director's Notes** — Aggregates history across all agents into a unified timeline with search, filters, and an activity graph. Includes an AI Overview tab that generates a structured synopsis of recent work. Off by default, gated behind a new \"Encore Features\" panel under settings. This is a precursor to an eventual plugin system, allowing for extensions and customizations without bloating the core app.\r\n\r\n🏷️ **Conductor Profile** — Available under Settings > General. Provide a short description on how Maestro agents should interface with you.\r\n\r\n🧠 **Three-State Thinking Toggle** — The thinking toggle now cycles through three modes: off, on, and sticky. Sticky mode keeps thinking content visible after the response completes. Cycle with CMD\u002FCTRL+SHIFT+K.\r\n\r\n🤖 **Factory.ai Droid Support** — Added support for the [Factory.ai](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli) droid agent. Full session management and output parsing integration.\r\n\r\n## Changes in v0.15.3\r\n\r\n- **CLI settings management:** Full `maestro-cli settings` command suite — list, get, set, and reset any Maestro setting from the command line. Includes per-agent configuration (custom paths, args, env vars, model overrides). Supports category filtering, verbose descriptions, and machine-readable JSON output for scripting\r\n- **Live settings reload:** Settings changes made via the CLI are automatically detected by the running desktop app — no restart required\r\n- **Plan-Mode toggle:** Claude Code and OpenCode agents now show \"Plan-Mode\" instead of \"Read-Only\" for the read-only toggle, matching their native terminology\r\n- **Solarized Dark theme:** New Solarized Dark color theme with tuned contrast for tags, code blocks, and pill labels\r\n- **Files pane icon theme:** Choose between default and rich icon themes in the files pane — rich theme adds colorful, language-specific icons for 70+ file types and folder categories. Toggle under Settings > Display\r\n- **Persistent web link:** The web\u002Fmobile interface link now persists across app restarts — no need to re-enable it each session\r\n- **OpenCode v1.2+ session support:** Automatically reads OpenCode's new SQLite session storage format alongside the legacy JSONL format\r\n- **Group chat @mentions:** Use `@agent-name` syntax in the prompt composer to direct messages to specific agents in group chat\r\n- **Group chat over SSH:** Group chat synthesis and moderation now run correctly on SSH remote agents instead of always spawning locally\r\n- **Group chat participant management:** Remove button on participant cards lets you remove stale or unwanted participants from a group chat\r\n- **Batch resume\u002Fabort:** New controls in the right panel for resuming or aborting batch operations\r\n- **Default worktree directory:** Worktree configuration now defaults to the parent of the agent's working directory instead of blank\r\n- **Drawfinity in Symphony:** Added Drawfinity to the Symphony project registry\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.15.2...v0.15.3\r\n\n\n## What's Changed\n* fix: use namespace import for os in main constants by @jeffscottward in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F555\n* Polish: group chat mentions, batch resume\u002Fabort, git push PATH fix by @pedramamini in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F580\n* feat: add SQLite session reading support for OpenCode v1.2+ by @chr1syy in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F569\n* fix: stabilize mobile remote session ui by @jeffscottward in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F564\n* fix: stop button not working on Windows for Claude Code agents by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F556\n* feat: persistent web link by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F540\n* fix: defensive guards for Sentry-reported crashes by @pedramamini in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F585\n* fix: include version manager bins in expanded PATH by @brownmike in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F562\n* feat: default worktree directory to parent of agent's cwd by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F557\n* fix(tests): make tests cross-platform for Windows, Linux, and macOS by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F565\n* fix: align numbered markdown items with bold leading content by @jeffscottward in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F424\n* fix: instructions for troubleshooting missing fonts in WSL by @chriseng in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F595\n* Clarify Spec-Kit Prerequisites by @scriptease in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F603\n*","2026-04-05T02:14:04",{"id":162,"version":163,"summary_zh":164,"released_at":165},100276,"v0.16.7-RC","🪄 **Maestro Cue** is a new trigger-based cross-agent orchestration capability. Heartbeats, GitHub issues\u002FPRs, file system monitors, and other data sources can bring your agents to life and pass work between one another.\r\n\r\n💻 **Major Shell Upgrade** — Full-featured xterm.js terminal tabs alongside your existing AI and file preview tabs. Open multiple terminals and rename them freely.\r\n\r\n🌐 **Web UX Parity** — The web\u002Fmobile interface now supports real PTY terminals, swipeable panels, notification dropdowns, and dozens of desktop-equivalent features. Full touch-friendly experience on tablets and phones.\r\n\r\n🔗 **SSH Shared History** — History synchronization across multiple Maestro instances working on the same project via SSH. Each host writes per-hostname JSONL files to `.maestro\u002Fhistory\u002F` on the remote, so all participants see each other's work.\r\n\r\n## Changes in v0.16.7-RC\r\n\r\n### New Features\r\n\r\n- **Tab filtering settings:** Two new Display settings under \"Tab Filtering\" — keep starred tabs visible and\u002For keep file preview tabs visible when the unread filter is active. Both off by default\r\n- **Static history graph with viewport indicator:** The activity graph in the History panel no longer shifts as you scroll; instead, a sliding indicator line with a timestamp label shows your current position in the timeline\r\n- **Environment variables tab:** Dedicated Environment tab in Settings for managing global environment variables passed to all agents\r\n- **Synopsis background toast:** Background synopsis completions now show a toast notification so you know when the summary is ready\r\n- **Document Graph GA:** Removed the beta badge from Document Graph — it's now a fully supported feature\r\n\r\n### Bug Fixes\r\n\r\n- **Custom notification synopsis:** TTS and custom notifications now receive the task synopsis for user-initiated tasks\r\n- **Auto Run document instructions:** Rewrote Auto Run document instructions for improved agent clarity\r\n- **Auto Run prompt hardening:** Additional hardening of the Auto Run system prompt for more reliable agent behavior\r\n- **Windows stdin transport:** Wizard prompts and remaining spawn calls now use stdin to avoid Windows command line length limits (thanks @jSydorowicz21)\r\n- **Cmd+F focus priority:** Search input now reliably gets focus when invoked, fixing cases where other handlers intercepted the shortcut\r\n- **Remote pill cleanup:** Removed superfluous Remote pill from agent headers; defaulted syncHistory to opt-in\r\n- **Director's Notes wiring:** Wired Director's Notes into the main application flow\r\n- **Dead code removal:** Removed dead sendViaStdin conditional blocks across conversation managers and document generation\r\n- **SSH phaseGenerator alignment:** Fixed phaseGenerator SSH check to align with the rest of the spawn pipeline\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.6-RC...v0.16.7-RC\n\n## What's Changed\n* fix: pass prompts via stdin to avoid Windows command line length limit (#703) by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F705\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.6-RC...v0.16.7-RC","2026-04-03T17:18:09",{"id":167,"version":168,"summary_zh":169,"released_at":170},100277,"v0.16.6-RC","🪄 **Maestro Cue** is a new trigger-based cross-agent orchestration capability. Heartbeats, GitHub issues\u002FPRs, file system monitors, and other data sources can bring your agents to life and pass work between one another.\r\n\r\n💻 **Major Shell Upgrade** — Full-featured xterm.js terminal tabs alongside your existing AI and file preview tabs. Open multiple terminals and rename them freely.\r\n\r\n🌐 **Web UX Parity** — The web\u002Fmobile interface now supports real PTY terminals, swipeable panels, notification dropdowns, and dozens of desktop-equivalent features. Full touch-friendly experience on tablets and phones.\r\n\r\n🔗 **SSH Shared History** — History synchronization across multiple Maestro instances working on the same project via SSH. Each host writes per-hostname JSONL files to `.maestro\u002Fhistory\u002F` on the remote, so all participants see each other's work.\r\n\r\n## Changes in v0.16.6-RC\r\n\r\n### New Features\r\n\r\n- **Environment variables tab:** Dedicated Environment tab in Settings for managing global environment variables passed to all agents\r\n- **Cross-host shared history:** SSH remote agents sync history entries to a shared `.maestro\u002Fhistory\u002F` directory on the remote host, with per-hostname attribution and \"Remote\" pill indicators in the UI. Toggle via \"Sync history to remote\" in SSH settings\r\n- **Web terminal PTY support:** Web\u002Fmobile terminal sessions now get real PTY backends with full resize support\r\n- **Swipeable panels on tablet:** Left-edge swipe opens the agent panel; right-edge swipe opens the right panel. Both support swipe-to-close\r\n- **Notifications dropdown:** Bell icon in web header shows completed\u002Ferrored agents with direct switch-to-agent on click\r\n- **Auto Run play button removed:** Auto Run is now accessible exclusively via the Right Panel tab and Cmd+K, decluttering the header\r\n\r\n### Bug Fixes\r\n\r\n- **Codex v0.111.0 support:** Live terminal rendering and history for the new Codex JSON format. Tool call messages now merge correctly instead of creating duplicates\r\n- **Custom notification synopsis:** TTS and custom notifications now receive the task synopsis for user-initiated tasks\r\n- **Cloudflare tunnel restart:** Tunnel now automatically restarts when the web server port changes, instead of requiring a manual toggle\r\n- **External link crashes:** Guard all external link clicks against relative paths and invalid URLs — fixes multiple reported crashes\r\n- **Agent duplication flow:** Skip the Manual\u002FGuided setup choice modal when duplicating — go directly to the config modal with source agent pre-filled\r\n- **Unread filter navigation:** Active AI tab is now always reachable via Cmd+Shift+\\]\u002F\\[ when unread filter is enabled\r\n- **WakaTime settings:** Restored WakaTime UI in Encore panel; fixed stale spinner on key change and \"installing...\" flash\r\n- **Cue GitHub poller:** Malformed `gh` CLI output no longer crashes the poll cycle\r\n- **Tab navigation glitches:** Resolved inconsistent navigation behavior when mixing AI and terminal tabs\r\n\n\n## What's Changed\n* fix: restore WakaTime settings UI in Encore tab by @kianhub in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F697\n* refactor: decompose AutoRun into modular directory structure by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F698\n* Followup: Web Interface UX Parity by @chr1syy in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F696\n* fix: update Codex integration for v0.111.0 JSONL output format by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F699\n* feat: polish Cue pipeline editor — drag fix, fan-out\u002Ffan-in, viewport centering + fix: Cue pipeline editor polish and input UX improvements by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F700\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.5-RC...v0.16.6-RC","2026-04-02T01:25:08",{"id":172,"version":173,"summary_zh":174,"released_at":175},100278,"v0.16.5-RC","🪄 Maestro Cue is a new trigger based cross-agent orchestration capability. Heartbeats, GitHub issues \u002F PRs, file system monitors and other data sources can result in your agents coming to life and passing work between one another.\r\n\r\n💻 Major shell upgrade. We now launch a full-featured xterm terminal as a tab alongside your existing AI and file preview tabs. You can open multiple terminals and rename the terminal tabs as well.\r\n\r\n## Smaller Changes in 0.16.5\r\n\r\n- Web\u002Fmobile UX parity — full mobile interface for Auto Run, Group Chat, Context Management, Cue, Usage Dashboard, Achievements, Settings, Notifications, Agent Creation, and Git Status with right-drawer, command palette, and edge-swipe gestures 📱\r\n- File Preview overhaul — decomposed into directory module with zoomable\u002Fpannable image viewer, indented fence rendering, search sync, and binary file handling 🖼️\r\n- TabBar decomposed into directory module with unread filter, hover flicker fix, and close-tab neighbor lookup 🧩\r\n- Conversational feedback UI with duplicate issue search, screenshot uploads, new agent choice modal, and breadcrumb navigation 💬\r\n- Cue `app.startup` trigger type and pipeline numbering fix 🚀\r\n- Cue boot scan scoping, graceful DB init with error surfacing to UI, and drag throttle to prevent node vanishing 🩹\r\n- Cue pipeline viewport preserved on reload, fitView deferred to view switch only 🗺️\r\n- File tree performance — decoupled tree display from stats calculation with progressive SSH loading ⚡\r\n- Cmd+K opens command palette in all terminal modes, vim\u002Fvi\u002Fnano focus recovery fallback in xterm ⌨️\r\n- Tilde path (`~\u002F…`) and media file extension support in markdown file links 🔗\r\n- Full bash commands now visible in thinking mode with structured tool display 🔍\r\n- Platform-aware default shell so terminal tabs work correctly on Windows 🖥️\r\n- Windows quit safety timeout to prevent app lingering, with follow-up cleanup reordering 🩹\r\n- Splash screen backstop timeout (8s absolute) and sessionsLoaded gate to prevent premature dismissal ⏱️\r\n- Tab hover overlay menu clamped to viewport bounds 📐\r\n- `maestro-cli send` now captures response from Claude Code 🔧\r\n- Stats collection tied to Usage & Stats feature toggle instead of separate setting 🎛️\r\n- Native title bar defaulted to `true` on Windows 🖥️\r\n- `gh` CLI paths added to `buildExpandedPath()` for Symphony and agent detection 🔧\r\n- Feedback modal layout fixes — pinned header\u002Ffooter, auto-resize textarea, Cmd+N shortcut 🩹\r\n- Silent `.catch(() => {})` in Sentry replaced with error logging 🛡️\r\n- Sidebar spacer removed for collapsed empty groups 🩹\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.4-RC...v0.16.5-RC\r\n","2026-03-31T16:53:14",{"id":177,"version":178,"summary_zh":179,"released_at":180},100279,"v0.16.4-RC","🪄 Maestro Cue is a new trigger based cross-agent orchestration capability. Heartbeats, GitHub issues \u002F PRs, file system monitors and other data sources can result in your agents coming to life and passing work between one another.\r\n\r\n💻 Major shell upgrade. We now launch a full-featured xterm terminal as a tab alongside your existing AI and file preview tabs. You can open multiple terminals and rename the terminal tabs as well.\r\n\r\n## Smaller Changes in 0.16.4\r\n\r\n- Token-efficient system prompt delivery — Claude Code now receives Maestro context via `--append-system-prompt` instead of embedding in user messages, reducing token overhead on every spawn 🎯\r\n- Files Pane Icon Theme setting — choose between Default (Lucide) and Rich (Material Icon Theme–style SVGs) for file and folder icons in the right sidebar 🎨\r\n- Publish to Gist button on AI messages — share any AI response as a GitHub Gist directly from the message action bar 📤\r\n- Cue pipeline editor fully conforms to app theme — ~100 hardcoded colors replaced with theme-aware equivalents across 28 components 🎨\r\n- Cue pipeline context menu and settings panel now dismiss on click-outside and Escape 🩹\r\n- Cue node drag stabilized in All Pipelines view — no more pipeline overlap or jump on drag 🩹\r\n- Cue duplicate agents now render as separate nodes in pipeline chains 🔗\r\n- Cue chain edge sources resolved correctly before overwriting sessionToNode mapping 🩹\r\n- Right-click context menu on file references in AI chat with Copy Path and Open actions 📂\r\n- Lightbox image copy-to-clipboard now uses Electron native clipboard API for reliable cross-platform support 📋\r\n- Jump to Nearest Terminal rebound to ⌥⌘J to avoid browser shortcut conflict ⌨️\r\n- File explorer stats bar now honors local ignore patterns and .gitignore 📊\r\n- Silent `.catch(() => {})` patterns replaced with error logging for better Sentry visibility 🛡️\r\n- Group chat `addParticipant` made idempotent and `openExternal` URL validation hardened 🔒\r\n- Windows system prompt delivery uses temp files to avoid CLI argument length limits 🖥️\r\n- Unique temp file per spawn prevents race conditions on rapid agent respawns 🩹\r\n- Drawfinity added to the Symphony registry 🎵\r\n- Spec-Kit documentation updated with prerequisites and setup instructions 📝\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.3-RC...v0.16.4-RC\r\n\n\n## What's Changed\n* Clarify Spec-Kit Prerequisites by @scriptease in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F603\n* fix(cue): theme conformity, context menu dismiss, and drag stability by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F608\n* feat: add Drawfinity to symphony registry by @needmorecowbell in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F607\n* feat: add files pane icon theme setting by @jeffscottward in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F609\n* feat: token-efficient system prompt delivery for CLI agents by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F596\n* feat: add BMAD command bundle by @jeffscottward in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F573\n\n## New Contributors\n* @scriptease made their first contribution in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F603\n* @needmorecowbell made their first contribution in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F607\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.3-RC...v0.16.4-RC","2026-03-25T20:22:55",{"id":182,"version":183,"summary_zh":184,"released_at":185},100280,"v0.16.3-RC","🪄 Maestro Cue is a new trigger based cross-agent orchestration capability. Heartbeats, GitHub issues \u002F PRs, file system monitors and other data sources can result in your agents coming to life and passing work between one another.\r\n\r\n💻 Major shell upgrade. We now launch a full-featured xterm terminal as a tab alongside your existing AI and file preview tabs. You can open multiple terminals and rename the terminal tabs as well.\r\n\r\n## Smaller Changes in 0.16.3\r\n\r\n- Right-click context menu on links in AI chat and terminal with \"Copy Link\" and \"Open in Browser\" actions 🔗\r\n- Streaming progress bar for AI Overview generation in Director's Notes — shows KB received, elapsed time, and live percentage in tab indicator 📊\r\n- macOS word\u002Fline navigation keybindings in terminal tabs — Option+Arrow for word jump, Cmd+Arrow for line start\u002Fend, Option+Backspace for word delete ⌨️\r\n- Bookmark indicator now visible next to agent name in the main header 🔖\r\n- Open working directory in Finder\u002FExplorer from the file tree header and Quick Actions 📂\r\n- Table of Contents overlay in file preview dynamically sizes to fit heading text 📑\r\n- System Process Monitor widened with tab name shown in process detail view 🔍\r\n- Live Overlay panel no longer clips behind sidebar edges 🩹\r\n- Remote Control toggle now includes a description of Cloudflare tunnel usage ☁️\r\n- Gist Publish modal widened to prevent button overflow 🩹\r\n- Cue GitHub poller uses expanded PATH to find `gh` CLI in packaged builds 🔧\r\n- CLI `send` command creates a fresh session by default, preventing session leakage across concurrent callers 🔒\r\n- Session restoration no longer blocks splash screen on slow agent detection or git operations ⚡\r\n- Terminal tab spawn loop fix — stable callback refs prevent re-render thrashing 🩹\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.2-RC...v0.16.3-RC\n\n## What's Changed\n* fix: prevent splash screen blocking on slow agent detection and git ops (#587) by @jSydorowicz21 in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F598\n* fix(cli): create fresh session by default in send command by @chr1syy in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F606\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.2-RC...v0.16.3-RC","2026-03-23T21:29:20",{"id":187,"version":188,"summary_zh":189,"released_at":190},100281,"v0.16.2-RC","🪄 Maestro Cue is a new trigger based cross-agent orchestration capability. Heartbeats, GitHub issues \u002F PRs, file system monitors and other data sources can result in your agents coming to life and passing work between one another.\r\n\r\n💻 Major shell upgrade. We now launch a full-featured xterm terminal as a tab alongside your existing AI and file preview tabs. You can open multiple terminals and rename the terminal tabs as well.\r\n\r\n## Smaller Changes in 0.16.2\r\n\r\n- Cue run processes now visible in System Process Monitor with event type badges and subscription names 🔍\r\n- \"Run Now\" play button on pipeline trigger nodes for manual one-off firing ▶️\r\n- System stays awake during active Cue scheduled subscriptions and runs 💤\r\n- Cue pipeline gear icon accessibility improvements and prompt redaction in logs 🔒\r\n- Unified markdown rendering across AI terminal, wizard, and mobile views 📝\r\n- Multi-paragraph list items and ordered list markers now render correctly in prose ✅\r\n- Terminal font size auto-scales to 85% of app font size for better visual balance 🔤\r\n- Escape key now works reliably in vi\u002Fvim\u002Fnano inside terminal tabs ⌨️\r\n- Worktree creation now defaults to the parent of the agent's working directory 🌴\r\n- Version manager paths (nvm, fnm) included in PATH expansion for agent detection 🔧\r\n- SSH startup hang fix — splash screen dismisses after 5s safety timeout 🩹\r\n- Rapid terminal spawn failures batched into a single toast notification 🩹\r\n- Orphaned PTY cleanup on session close, renderer crash, and app quit 🩹\r\n- Execution queue drag-and-drop fix for lists with exactly two items 🐛\r\n- Restored WebContents crash handler that was accidentally removed 🐛\r\n- Defensive guards for Sentry-reported crashes 🛡️\r\n- Cross-platform test fixes for Windows, Linux, and macOS 🖥️\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.1-RC...v0.16.2-RC\r\n","2026-03-20T06:38:46",{"id":192,"version":193,"summary_zh":194,"released_at":195},100282,"v0.16.1-RC","🪄 Maestro Cue is a new trigger based cross-agent orchestration capability. Heartbeats, GitHub issues \u002F PRs, file system monitors and other data sources can result in your agents coming to life and passing work between one another.\r\n\r\n💻 Major shell upgrade. We now launch a full-featured xterm terminal as a tab alongside your existing AI and file preview tabs. You can open multiple terminals and rename the terminal tabs as well.\r\n\r\n## Smaller Changes in 0.16.1\r\n\r\n- Image support in Group Chat — display, persistence, and forwarding to agents 🖼️\r\n- @mention autocomplete in Group Chat prompt composer 💬\r\n- Persistent web link option keeps the mobile\u002Fweb access URL stable across restarts 🔗\r\n- New staged splash screen with orchestra warm-up theme and file indexing progress 🎬\r\n- Confirm before closing tabs that have unsent drafts 📝\r\n- Auto-follow active document in Auto Run sidebar 📄\r\n- SSH vs Local indicator and jump-to-agent buttons in System Process Viewer 🔍\r\n- Copy Deep Link option added to the tab overlay menu 🔗\r\n- Terminal tabs now visible in the tab switcher modal 🖥️\r\n- Empty state for the unread agents filter 🔔\r\n- Log rotation — dated log files with automatic 7-day cleanup 🗂️\r\n- Worktree creation now defaults to the parent of the agent's working directory 🌴\r\n- Terminal font size auto-scales to 85% of app font size for better visual balance 🔤\r\n- Escape key now works reliably in vi\u002Fvim\u002Fnano inside terminal tabs ⌨️\r\n- Version manager paths (nvm, fnm) included in PATH expansion for agent detection 🔧\r\n- SSH startup hang fix — splash screen dismisses after 5s safety timeout 🩹\r\n- Rapid terminal spawn failures batched into a single toast notification 🩹\r\n- PTY exhaustion fix — orphaned processes cleaned up on session close, crash, and app quit 🩹\r\n- Execution queue drag-and-drop fix for lists with exactly two items 🐛\r\n- Read-only mode now properly enforced for JSON-line agents in CLI batch runs 🔒\r\n- Active theme now forwarded to runmaestro.ai URLs 🎨\r\n- Usage Dashboard label updated — no longer marked as BETA 📊\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.16.0-RC...v0.16.1-RC","2026-03-19T04:02:40",{"id":197,"version":198,"summary_zh":199,"released_at":200},100283,"v0.16.0-RC","🪄 Maestro Cue is a new trigger based cross-agent orchestration capability. Heartbeats, GitHub issues \u002F PRs, file system monitors and other data sources can result in your agents coming to life and passing work between one another.\r\n\r\n💻 Major shell upgrade. We now launch a full-featured xterm terminal as a tab alongside your existing AI and file preview tabs. You can open multiple terminals and rename the terminal tabs as well.\r\n\r\n## Smaller Changes in 0.16.0\r\n\r\n- Directors Notes view now streams in lives updates from agents as they happen 🎬\r\n- Added deep app links which are used in system notifications and available in templates. 🔗\r\n- Added filter to the bottom of the left panel to filter agents by working and unread 🔔\r\n- Moved Maestro Symphony and Usage Dashboard under Encore Features, both default on. 👏\r\n- Added command palette entry for creating a new worktrees. 🌴\r\n- Added toggle for running all Auto Run docs on new-agent Wizard completion. 🧙\r\n- Addressed poor text color combinations across all themes 🎨\r\n- The default paths for Auto Run Docs is now .maestro\u002Fplaybooks 📂\r\n- (side note) Maestro Cue docs can be found in .maestro\u002Fprompts and .maestro\u002Fcue.yaml 📂\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.15.2...v0.16.0-RC\r\n","2026-03-14T07:51:31",{"id":202,"version":203,"summary_zh":204,"released_at":205},100284,"v0.15.2","# Major 0.15.x Additions\r\n\r\n🎶 **Maestro Symphony** — Contribute to open source with AI assistance! Browse curated issues from projects with the `runmaestro.ai` label, clone repos with one click, and automatically process the relevant Auto Run playbooks. Track your contributions, streaks, and stats. You're contributing CPU and tokens towards your favorite open source projects and features.\r\n\r\n🎬 **Director's Notes** — Aggregates history across all agents into a unified timeline with search, filters, and an activity graph. Includes an AI Overview tab that generates a structured synopsis of recent work. Off by default, gated behind a new \"Encore Features\" panel under settings. This is a precursor to an eventual plugin system, allowing for extensions and customizations without bloating the core app.\r\n\r\n🏷️ **Conductor Profile** — Available under Settings > General. Provide a short description on how Maestro agents should interface with you.\r\n\r\n🧠 **Three-State Thinking Toggle** — The thinking toggle now cycles through three modes: off, on, and sticky. Sticky mode keeps thinking content visible after the response completes. Cycle with CMD\u002FCTRL+SHIFT+K.\r\n\r\n🤖 **Factory.ai Droid Support** — Added support for the [Factory.ai](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli) droid agent. Full session management and output parsing integration.\r\n\r\n## Change in v0.15.2\r\n\r\nPatch release with bug fixes, UX improvements, and cherry-picks from the 0.16.0 RC.\r\n\r\n### New Features\r\n\r\n- **Cmd+0 → Last Tab:** Remapped Cmd+0 to jump to last tab; Cmd+Shift+0 now resets font size\r\n- **Unsent draft protection:** Confirm dialog before closing tabs with unsent draft input\r\n- **Read-only CLI flag:** Added `--read-only` flag to `maestro-cli send` command\r\n- **Gemini read-only enforcement:** Gemini `-y` flag now works in read-only mode\r\n- **Capability-based providers:** Replaced hardcoded agent ID checks with capability flags and shared metadata\r\n\r\n### Bug Fixes\r\n\r\n- **Sticky overlay scroll:** Fixed sticky overlays breaking tab scroll-into-view\r\n- **Director's Notes stats:** Count only agents with entries in lookback window\r\n- **SSH remote config:** Check `sessionSshRemoteConfig` as primary SSH remote ID source\r\n- **.maestro file tree:** Always show .maestro directory even when dotfiles are hidden\r\n- **Provider hardening:** Prototype safety, capability gates, stale map cleanup\r\n- **Session search:** Per-session error resilience and metadata-based title matching\r\n- **File tree stale loads:** Load sequence counter prevents stale file tree updates\r\n- **File tree Unicode:** NFC normalization prevents duplicate entries\r\n- **File tree duplicates:** Tree-structured data resolves duplicate entries\r\n- **File tree auto-refresh:** Timer no longer destroyed on right panel tab switch\r\n- **Menu z-index:** Branding header menu renders above sidebar content\r\n- **Dropdown clipping:** Fixed hamburger menu and live overlay dropdown clipping\r\n- **Font size shortcuts:** Restored Cmd+\u002F- font size shortcuts lost with custom menu\r\n- **Draft input preservation:** Replaying a previous message no longer discards current draft\r\n- **SSH directory collision:** Skip warning when agents are on different SSH hosts\r\n- **IPC error handling:** Handle expected IPC errors gracefully\r\n- **Auto-focus on mode switch:** Input field auto-focuses when toggling AI\u002FShell mode\r\n- **OpenCode parser:** Preserve JSON error events; reset resultEmitted on step_start\r\n- **NDJSON performance:** Eliminated triple JSON parsing on hot path\r\n- **Agent config overrides:** Apply config overrides in context groomer before spawning\r\n- **Stale closure fix:** Resolved model not saving in wizard agent config\r\n\r\n### Visual Polish\r\n\r\n- **Light theme contrast:** Improved syntax highlighting contrast across all light themes\r\n- **Context warning sash:** Dark text colors in light mode for readability\r\n- **Session name dimming:** Use `textMain` color to prevent visual dimming\r\n- **Session name pill:** Allow shrinking so date doesn't collide with type pill\r\n- **Scroll-to-bottom arrow:** Removed noisy indicator from terminal output view\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.15.1...v0.15.2","2026-03-12T04:12:32",{"id":207,"version":208,"summary_zh":209,"released_at":210},100285,"v0.15.1","🎶 Maestro Symphony - Contribute to open source with AI assistance! Browse curated issues from projects with the `runmaestro.ai` label, clone repos with one click, and automatically process the relevant Auto Run playbooks. Track your contributions, streaks, and stats. You're contributing CPU and tokens towards your favorite open source projects and features. NOTE: Making changes here active based on user feedback 🙏\r\n\r\n🎬 Director's Notes. Aggregates history across all agents into a unified timeline with search, filters, and an activity graph. Includes an AI Overview tab that generates a structured synopsis of recent work. Off by default, gated behind a new \"Encore Features\" panel under settings. This is a precursor to an eventual plugin system. Allowing for extensions and customizations without bloating the core app.\r\n\r\n🏷️ Conductor Profile - Available under Settings > General. Provide a short description on how Maestro agents should interface with you.\r\n\r\n🧠 Three-State Thinking Toggle - The thinking toggle now cycles through three modes: off, on, and sticky. Sticky mode keeps thinking content visible after the response completes. Cycle with CMD\u002FCTRL+SHIFT+K ⌨️ (#165).\r\n\r\n🤖 Factory.ai Droid Support - Added support for the [Factory.ai](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli) droid agent. Full session management and output parsing integration (#223).\r\n\r\n🔧 Windows and SSH Stability Improvements - Major fixes for remote agent execution including wizard support, synopsis generation, and proper shell profile sourcing across platforms. (#131, #156, #159, #187, #195).\r\n\r\n## Security Fixes\r\n\r\nAddressed some security issues, all thanks to @VVX7\r\n- #421 History panel stored XSS\r\n- #422 Stored XSS to reverse shell\r\n- #423 Stored XSS to SSRF\r\n\r\n## Smaller Changes in 0.15.x\r\n\r\n- Added safety controls around agent working directory deletion 🔒 (#206)\r\n- Added `\u002Fskills` command for enumerate Claude Code skills 🧰  (#154)\r\n- Renamed \"Audio Notifications\" to \"Custom Notifications\" 🔔 (#168)\r\n- Auto-scroll now respects user scroll position in AI mode 📜 (#237)\r\n- Spec-Kit and OpenSpec commands now accept arguments properly ⚙️ (#238)\r\n- You can now @ message entire groups of agents in Group Chat. 👥\r\n- Group chats can be archived. 📦\r\n- You can now swap the provider behind an agent. ↪️\r\n- Added ability to scroll to latest messages as they are streamed from the agent. 📜\r\n- Expanded maestro-cli to include agent message send on new or resumed sessions, this means you can control any agent behind Maestro easily 🧵\r\n- Added VSCode-style semantic icon mapping in the file explorer ✅\r\n- New tabs are automatically named by default, this can be disabled under settings 🏷️\r\n- Added WakaTime integration ⏱️\r\n- Added window chrome options to toggle off the header bar 🪟\r\n- Broke Settings > General up, there's now a Settings > Display ⚙️\r\n- Added a table of contents jump menu for markdown files being previewed 📄\r\n- Added option to open document preview from within the graph view 📈\r\n- Added configuration options to ignore remote file patterns over SSH connections 🚯\r\n- Fixed context consumption calculation bugs 🧮\r\n- AI responses can now be saved to markdown on disk 💾\r\n- Hide Empty \"Ungrouped Agents\" Folder 📁\r\n- File preview detects updates on disk and shows refresh button ↪️\r\n- Auto Run task calculation is now dynamic to count tasks added mid-flight ✈️\r\n- When you stop an Auto Run, you can now force kill the running task 🔪\r\n- Web interface synchronization improvements 🌐\r\n- Added shortcuts to all panel search under command palette 🔍\r\n- All sorts of other bug fixes and usability improvements 🐛\r\n- Enhanced batch runner with agent prompt validation for task references ☑️\r\n- Added recovery mechanism for expired group chat sessions automatically 🔄\r\n- Improved history help modal with SSH remote session limitations notice 📝\r\n- The wand glyph on the upper right sparkles if any agent is working ✨\r\n\r\n... and of course tons of other little fixes and creature comforts too numerous to enumerate here.\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.14.5...v0.15.1","2026-03-03T06:36:58",{"id":212,"version":213,"summary_zh":214,"released_at":215},100286,"v0.15.0-RC","🎶 Maestro Symphony - Contribute to open source with AI assistance! Browse curated issues from projects with the `runmaestro.ai` label, clone repos with one click, and automatically process the relevant Auto Run playbooks. Track your contributions, streaks, and stats. You're contributing CPU and tokens towards your favorite open source projects and features. NOTE: Making changes here active based on user feedback 🙏\r\n\r\n🎬 Director's Notes. Aggregates history across all agents into a unified timeline with search, filters, and an activity graph. Includes an AI Overview tab that generates a structured synopsis of recent work. Off by default, gated behind a new \"Encore Features\" panel under settings. This is a precursor to an eventual plugin system. Allowing for extensions and customizations without bloating the core app.\r\n\r\n🏷️ Conductor Profile - Available under Settings > General. Provide a short description on how Maestro agents should interface with you.\r\n\r\n🧠 Three-State Thinking Toggle - The thinking toggle now cycles through three modes: off, on, and sticky. Sticky mode keeps thinking content visible after the response completes. Cycle with CMD\u002FCTRL+SHIFT+K ⌨️ (#165).\r\n\r\n🤖 Factory.ai Droid Support - Added support for the [Factory.ai](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli) droid agent. Full session management and output parsing integration (#223).\r\n\r\n🔧 Windows and SSH Stability Improvements - Major fixes for remote agent execution including wizard support, synopsis generation, and proper shell profile sourcing across platforms. (#131, #156, #159, #187, #195).\r\n\r\n## Security Fixes\r\n\r\nAddressed some security issues, all thanks to @VVX7\r\n- #421 History panel stored XSS\r\n- #422 Stored XSS to reverse shell\r\n- #423 Stored XSS to SSRF\r\n\r\n## Smaller Changes in 0.15.x\r\n\r\n- Added safety controls around agent working directory deletion 🔒 (#206)\r\n- Added `\u002Fskills` command for enumerate Claude Code skills 🧰  (#154)\r\n- Renamed \"Audio Notifications\" to \"Custom Notifications\" 🔔 (#168)\r\n- Auto-scroll now respects user scroll position in AI mode 📜 (#237)\r\n- Spec-Kit and OpenSpec commands now accept arguments properly ⚙️ (#238)\r\n- You can now @ message entire groups of agents in Group Chat. 👥\r\n- Group chats can be archived. 📦\r\n- You can now swap the provider behind an agent. ↪️\r\n- Added ability to scroll to latest messages as they are streamed from the agent. 📜\r\n- Expanded maestro-cli to include agent message send on new or resumed sessions, this means you can control any agent behind Maestro easily 🧵\r\n- Added VSCode-style semantic icon mapping in the file explorer ✅\r\n- New tabs are automatically named by default, this can be disabled under settings 🏷️\r\n- Added WakaTime integration ⏱️\r\n- Added window chrome options to toggle off the header bar 🪟\r\n- Broke Settings > General up, there's now a Settings > Display ⚙️\r\n- Added a table of contents jump menu for markdown files being previewed 📄\r\n- Added option to open document preview from within the graph view 📈\r\n- Added configuration options to ignore remote file patterns over SSH connections 🚯\r\n- Fixed context consumption calculation bugs 🧮\r\n- AI responses can now be saved to markdown on disk 💾\r\n- Hide Empty \"Ungrouped Agents\" Folder 📁\r\n- File preview detects updates on disk and shows refresh button ↪️\r\n- Auto Run task calculation is now dynamic to count tasks added mid-flight ✈️\r\n- When you stop an Auto Run, you can now force kill the running task 🔪\r\n- Web interface synchronization improvements 🌐\r\n- Added shortcuts to all panel search under command palette 🔍\r\n- All sorts of other bug fixes and usability improvements 🐛\r\n- Enhanced batch runner with agent prompt validation for task references ☑️\r\n- Added recovery mechanism for expired group chat sessions automatically 🔄\r\n- Improved history help modal with SSH remote session limitations notice 📝\r\n- The wand glyph on the upper right sparkles if any agent is working ✨\r\n\r\n... and of course tons of other little fixes and creature comforts too numerous to enumerate here.\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fcompare\u002Fv0.14.5...v0.15.0-RC\r\n\n\n\n## What's Changed\n* refactor: extract app lifecycle modules from main\u002Findex.ts by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F230\n* BUG FIX: dev server port must be configured via `VITE_PORT` by @ksylvan in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F234\n* refactor: extracted process listeners from main\u002Findex.ts by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F240\n* refactor: restructure web-server module with security and memory leak… by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F244\n* refactor: consolidate agents module and reorganize test structure by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F247\n* refactor: decompose stats-db into focused modules by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F252\n* perf: reduce typing lag with multiple agents on large repos by @reachraza in https:\u002F\u002Fgithub.com\u002FRunMaestro\u002FMaestro\u002Fpull\u002F255","2026-03-01T20:44:16",{"id":217,"version":218,"summary_zh":219,"released_at":220},100287,"v0.14.5","Changes in this point release include:\r\n\r\n- Desktop app performance improvements (more to come on this, we want Maestro blazing fast) 🐌\r\n- Added local manifest feature for custom playbooks 📖\r\n- Agents are now inherently aware of your activity history as seen in the history panel 📜 (this is built-in cross context memory!)\r\n- Added markdown rendering support for AI responses in mobile view 📱\r\n- Bugfix in tracking costs from JSONL files that were aged out 🏦\r\n- Added BlueSky social media handle for leaderboard 🦋\r\n- Added options to disable GPU rendering and confetti 🎊\r\n- Better handling of large files in preview 🗄️\r\n- Bug fix in Claude context calculation 🧮\r\n- Addressed bug in OpenSpec version reporting 🐛\r\n\r\nThe major contributions to 0.14.x remain:\r\n\r\n🗄️ 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.\r\n\r\n📶 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.\r\n\r\n🧙‍♂️ Added an in-tab wizard for generating Auto Run Playbooks via `\u002Fwizard` or a new button in the Auto Run panel.\r\n\r\n# Smaller Changes in 014.x\r\n\r\n- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️\r\n- Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆\r\n- Agent duplication. Pro tip: Consider a group of unused \"Template\" agents ✌️\r\n- New setting to prevent system from going to sleep while agents are active 🛏️\r\n- The tab menu has a new \"Publish as GitHub Gist\" option  📝\r\n- The tab menu has options to move the tab to the first or last position 🔀\r\n- [Maestro-Playbooks](https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro-Playbooks) can now contain non-markdown assets 📙\r\n- Improved default shell detection 🐚\r\n- Added logic to prevent overlapping TTS notifications 💬\r\n- Added \"Toggle Bookmark\" shortcut (CTRL\u002FCMD+SHIFT+B) ⌨️\r\n- Gist publishing now shows previous URLs with copy button 📋\r\n\r\nThanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer @shadown @breki @charles-dyfis-net @ronaldeddings @jlengrand @ksylvan\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.14.4...v0.14.5","2026-01-24T11:15:27",{"id":222,"version":223,"summary_zh":224,"released_at":225},100288,"v0.14.4","Changes in this point release include:\r\n\r\n- Improved the new agent wizard to allow for specification of remote host prior to commencing ☁️\r\n- Fixed a bug where the default thinking state was not being honored for the initial tab in a new agent 🧠\r\n- Addressed some SSH gaps (#176 and #177) 🐛🐜\r\n- Desktop app performance improvements 🚅\r\n- Addressed bug in leaderboard submissions (#174)🏆\r\n- Addressed bug in wizard (hopefully)  🧙‍♂️\r\n- The \u002Fwizard command now respects your configured Auto Run directory (#169) 📂\r\n\r\nThe major contributions to 0.14.x remain:\r\n\r\n🗄️ 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.\r\n\r\n📶 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.\r\n\r\n🧙‍♂️ Added an in-tab wizard for generating Auto Run Playbooks via `\u002Fwizard` or a new button in the Auto Run panel.\r\n\r\n# Smaller Changes in 014.x\r\n\r\n- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️\r\n- Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆\r\n- Agent duplication. Pro tip: Consider a group of unused \"Template\" agents ✌️\r\n- New setting to prevent system from going to sleep while agents are active 🛏️\r\n- The tab menu has a new \"Publish as GitHub Gist\" option  📝\r\n- The tab menu has options to move the tab to the first or last position 🔀\r\n- [Maestro-Playbooks](https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro-Playbooks) can now contain non-markdown assets 📙\r\n- Improved default shell detection 🐚\r\n- Added logic to prevent overlapping TTS notifications 💬\r\n- Added \"Toggle Bookmark\" shortcut (CTRL\u002FCMD+SHIFT+B) ⌨️\r\n- Gist publishing now shows previous URLs with copy button 📋\r\n\r\nThanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer @shadown @breki @charles-dyfis-net\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.14.3...v0.14.4","2026-01-11T06:08:30",{"id":227,"version":228,"summary_zh":229,"released_at":230},100289,"v0.14.3","Changes in this point release include:\r\n\r\n- Added logic to prevent overlapping TTS notifications 💬\r\n- Bug fixes in history panel rendering 🐜\r\n- Improved markdown rendering of large tables ✨\r\n- Addressed #161 where local path was overriding remote path for SSH agents 📁\r\n- Fixed \"Jump to Bottom\" shortcut ⌨️\r\n- Added \"Toggle Bookmark\" shortcut (CTRL\u002FCMD+SHIFT+B) ⌨️\r\n- Fixed leaderboard updating issue 🏆\r\n- Changes in the file tree are now reflected immediately 🌴\r\n- Fixed Windows auto-update issue 🪟\r\n- Added unique installation ID generated for better crash tracking 🆔\r\n- Gist publishing now shows previous URLs with copy button 📋\r\n\r\nThe major contributions to 0.14.x remain:\r\n\r\n🗄️ 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.\r\n\r\n📶 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.\r\n\r\n🧙‍♂️ Added an in-tab wizard for generating Auto Run Playbooks via `\u002Fwizard` or a new button in the Auto Run panel.\r\n\r\n# Smaller Changes in 014.x\r\n\r\n- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️\r\n- Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆\r\n- Agent duplication. Pro tip: Consider a group of unused \"Template\" agents ✌️\r\n- New setting to prevent system from going to sleep while agents are active 🛏️\r\n- The tab menu has a new \"Publish as GitHub Gist\" option  📝\r\n- The tab menu has options to move the tab to the first or last position 🔀\r\n- [Maestro-Playbooks](https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro-Playbooks) can now contain non-markdown assets 📙\r\n- Improved default shell detection 🐚\r\n\r\n\r\nThanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer @shadown @breki @charles-dyfis-net\r\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.14.2...v0.14.3","2026-01-09T18:20:18",{"id":232,"version":233,"summary_zh":234,"released_at":235},100290,"v0.14.2","Changes in this point release include:\r\n\r\n- Fixed a regression in OpenCode that we introduced in 0.14.1 that broke, well, everything 🔨\r\n- [Maestro-Playbooks](https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro-Playbooks) can now contain non-markdown assets 📙\r\n- Improved default shell detection 🐚\r\n\r\nThe major contributions to 0.14.x remain:\r\n\r\n🗄️ 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.\r\n\r\n📶 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.\r\n\r\n🧙‍♂️ Added an in-tab wizard for generating Auto Run Playbooks via `\u002Fwizard` or a new button in the Auto Run panel.\r\n\r\n# Smaller Changes in 014.x\r\n\r\n- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️\r\n- Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆\r\n- Agent duplication. Pro tip: Consider a group of unused \"Template\" agents ✌️\r\n- New setting to prevent system from going to sleep while agents are active 🛏️\r\n- The tab menu has a new \"Publish as GitHub Gist\" option  📝\r\n- The tab menu has options to move the tab to the first or last position 🔀\r\n\r\nThanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer @shadown @breki @charles-dyfis-net\r\n\n\n## What's Changed\n* Honor user's configured default shell instead of hardcoding zsh by @charles-dyfis-net in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F152\n\n## New Contributors\n* @charles-dyfis-net made their first contribution in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F152\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.14.1...v0.14.2","2026-01-07T10:27:42",{"id":237,"version":238,"summary_zh":239,"released_at":240},100291,"v0.14.1","This point release brings enhancements to the new agent Wizard as well as a new \"inline\" or in-tab wizard that can be triggered via `\u002Fwizard`. Additionally:\r\n\r\n- The tab menu has a new \"Publish as GitHub Gist\" option  📝\r\n- The tab menu has options to move the tab to the first or last position 🔀\r\n- Improved context compaction with multi-pass consolidation 📚\r\n- Addressed some keyboard shortcut and pathing issues specific to Windows 🪟\r\n- Added caching layer to Document Graph view 💨\r\n- Addressed a bug in sending context from one agent to another 🤝\r\n- Bugfix in custom path detection for new agents 🐛\r\n- You can now edit any text file from within Maestro 📄\r\n- Files and folders can be renamed\u002Fdeleted from the file tree 📁\r\n- Proper leaderboard sync for folks who use multiple instances of Maestro 🏆\r\n- Addressed regression where OpenCode was not launching in YOLO mode 🐜\r\n\r\nThe other major contributions to 0.14.x remain:\r\n\r\n🗄️ 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.\r\n\r\n📶 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.\r\n\r\n### Other Changes in 0.14.x\r\n- Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️\r\n- Leaderboard tracking now works across multiple systems 🏆\r\n- Agent duplication. Pro tip: Consider a group of unused \"Template\" agents ✌️\r\n- New setting to prevent system from going to sleep while agents are active 🛏️\r\n- Added debug package to the wizard process, if you have issues there, please share the logs! 🧙‍♂️\r\n\r\nThanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer @shadown @breki\n\n## What's Changed\n* Add inline \u002Fwizard command for Auto Run document creation by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F112\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.14.0...v0.14.1","2026-01-06T19:05:37",{"id":242,"version":243,"summary_zh":244,"released_at":245},100292,"v0.14.0","Two major features in this release:\r\n\r\n🗄️ The first is 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.\r\n\r\n📶 The second is 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.\r\n\r\n🎛️ Also, made hefty changes to the User Dashboard, check it out from the hamburger menu, command palette, or hotkey. Get global insights across all providers and agents.\r\n\r\n### Other Changes\r\n- Leaderboard tracking now works across multiple systems 🏆\r\n- Windows WSL compatibility improvements 🪟\r\n- Agent duplication. Pro tip: Consider a group of unused \"Template\" agents ✌️\r\n- New setting to prevent system from going to sleep while agents are active 🛏️\r\n- We were not correctly tallying user interactions in the new usage dashboard 🧮\r\n- Added debug package to the wizard process, if you have issues there, please share the logs! 🧙‍♂️\r\n- Performance improvement in Auto Run panel editor 🏃‍♂️\r\n\r\nThanks for the contributions: @t1mmen @aejfager @Crumbgrabber @whglaser @b3nw @deandebeer\n\n## What's Changed\n* feat: SSH Remote Execution for AI Agents by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F111\n* SSH Config Support by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F118\n* fix: detect Node version manager paths in process spawning by @t1mmen in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F119\n* refactor: consolidate tilde expansion and version utilities by @t1mmen in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F120\n* ssh tunneling enhancements by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F121\n* Prevent Sleep by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F126\n* graph visuals update by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F127\n* discord link fix by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F128\n* Claude smash by @pedramamini in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F129\n\n## New Contributors\n* @t1mmen made their first contribution in https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fpull\u002F119\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.13.2...v0.14.0","2026-01-02T04:20:46",{"id":247,"version":248,"summary_zh":249,"released_at":250},100293,"v0.13.2","- TAKE TWO! Fixed Linux ARM64 build architecture contamination issues 🏗️\r\n\r\n### v0.13.1 Changes\r\n- Fixed Linux ARM64 build architecture contamination issues 🏗️\r\n- Enhanced error handling for Auto Run batch processing 🚨\r\n\r\n### v0.13.0 Changes\r\n- Added a global usage dashboard, data collection begins with this install 🎛️\r\n- Added a Playbook Exchange for downloading pre-defined Auto Run playbooks from [Maestro-Playbooks](https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro-Playbooks) 📕\r\n- Bundled OpenSpec commands for structured change proposals 📝\r\n- Added pre-release channel support for beta\u002FRC updates 🧪\r\n- Implemented global hands-on time tracking across sessions ⏱️\r\n- Added new keyboard shortcut for agent settings (Opt+Cmd+, | Ctrl+Alt+,) ⌨️\r\n- Added directory size calculation with file\u002Ffolder counts in file explorer 📊\r\n- Added sleep detection to exclude laptop sleep from time tracking ⏰\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.13.0...v0.13.1\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.13.1...v0.13.2","2025-12-29T20:22:54",{"id":252,"version":253,"summary_zh":254,"released_at":255},100294,"v0.13.1","- Fixed Linux ARM64 build architecture contamination issues 🏗️\r\n- Enhanced error handling for Auto Run batch processing 🚨\r\n\r\n### v0.13.0 Changes\r\n- Added a global usage dashboard, data collection begins with this install 🎛️\r\n- Added a Playbook Exchange for downloading pre-defined Auto Run playbooks from [Maestro-Playbooks](https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro-Playbooks) 📕\r\n- Bundled OpenSpec commands for structured change proposals 📝\r\n- Added pre-release channel support for beta\u002FRC updates 🧪\r\n- Implemented global hands-on time tracking across sessions ⏱️\r\n- Added new keyboard shortcut for agent settings (Opt+Cmd+, | Ctrl+Alt+,) ⌨️\r\n- Added directory size calculation with file\u002Ffolder counts in file explorer 📊\r\n- Added sleep detection to exclude laptop sleep from time tracking ⏰\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fpedramamini\u002FMaestro\u002Fcompare\u002Fv0.13.0...v0.13.1","2025-12-29T18:49:28"]