Add GitHub Copilot CLI support

CLAUDE-AGENTS.md

@@ -4,13 +4,14 @@ Agent support documentation for the Maestro codebase. For the main guide, see [[
 
 ## Supported Agents
 
-| ID              | Name          | Status     | Notes                                                            |
-| --------------- | ------------- | ---------- | ---------------------------------------------------------------- |
-| `claude-code`   | Claude Code   | **Active** | Primary agent, `--print --verbose --output-format stream-json`   |
-| `codex`         | Codex         | **Active** | Full support, `--json`, YOLO mode default                        |
-| `opencode`      | OpenCode      | **Active** | Multi-provider support (75+ LLMs), stub provider session storage |
-| `factory-droid` | Factory Droid | **Active** | Factory's AI coding assistant, `-o stream-json`                  |
-| `terminal`      | Terminal      | Internal   | Hidden from UI, used for shell sessions                          |
+| ID              | Name           | Status     | Notes                                                                                                      |
+| --------------- | -------------- | ---------- | ---------------------------------------------------------------------------------------------------------- |
+| `claude-code`   | Claude Code    | **Active** | Primary agent, `--print --verbose --output-format stream-json`                                             |
+| `codex`         | Codex          | **Active** | Full support, `--json`, YOLO mode default                                                                  |
+| `opencode`      | OpenCode       | **Active** | Multi-provider support (75+ LLMs), stub provider session storage                                           |
+| `factory-droid` | Factory Droid  | **Active** | Factory's AI coding assistant, `-o stream-json`                                                            |
+| `copilot`       | GitHub Copilot | **Beta**   | `-p/--prompt`, `--output-format json`, `--resume`, `@image` mentions, permission filters, reasoning stream |
+| `terminal`      | Terminal       | Internal   | Hidden from UI, used for shell sessions                                                                    |
 
 ## Agent Capabilities
 
@@ -90,6 +91,19 @@ Centralized in `src/shared/agentMetadata.ts` (importable from any process):
 - **YOLO Mode:** Auto-enabled in batch mode (no flag needed)
 - **Multi-Provider:** Supports 75+ LLMs including Ollama, LM Studio, llama.cpp
 
+### GitHub Copilot CLI
+
+- **Binary:** `copilot`
+- **JSON Output:** `--output-format json`
+- **Batch Mode:** `-p, --prompt <text>`
+- **Resume:** `--continue`, `--resume[=session-id]`
+- **Read-only:** CLI-enforced via `--allow-tool=read,url`, `--deny-tool=write,shell,memory,github`, `--no-ask-user`
+- **Thinking Display:** Streams `assistant.reasoning_delta` / `assistant.reasoning` into Maestro's thinking panel
+- **Images:** Prompt-embedded `@/tmp/...` mentions (maps Maestro uploads to Copilot file/image mentions)
+- **Session Storage:** `~/.copilot/session-state/<session-id>/`
+- **Known Limitations:**
+  - **SSH interactive mode:** PTY-based interactive Copilot sessions do not go through `wrapSpawnWithSsh()`, so interactive Copilot over SSH remote is not supported. Batch mode (`-p`) over SSH works correctly via the standard child-process spawner.
+
 ## Adding New Agents
 
 To add support for a new agent:

CLAUDE.md

@@ -102,13 +102,14 @@ Maestro is an Electron desktop app for managing multiple AI coding assistants si
 
 ### Supported Agents
 
-| ID              | Name          | Status     |
-| --------------- | ------------- | ---------- |
-| `claude-code`   | Claude Code   | **Active** |
-| `codex`         | OpenAI Codex  | **Active** |
-| `opencode`      | OpenCode      | **Active** |
-| `factory-droid` | Factory Droid | **Active** |
-| `terminal`      | Terminal      | Internal   |
+| ID              | Name           | Status     |
+| --------------- | -------------- | ---------- |
+| `claude-code`   | Claude Code    | **Active** |
+| `codex`         | OpenAI Codex   | **Active** |
+| `opencode`      | OpenCode       | **Active** |
+| `factory-droid` | Factory Droid  | **Active** |
+| `copilot`       | GitHub Copilot | **Beta**   |
+| `terminal`      | Terminal       | Internal   |
 
 See [[CLAUDE-AGENTS.md]] for capabilities and integration details.
 

CONTRIBUTING.md

@@ -645,13 +645,14 @@ Based on capabilities, these UI features are automatically enabled/disabled:
 
 ### Supported Agents Reference
 
-| Agent         | Resume                | Read-Only                   | JSON | Images | Sessions                      | Cost             | Status      |
-| ------------- | --------------------- | --------------------------- | ---- | ------ | ----------------------------- | ---------------- | ----------- |
-| Claude Code   | ✅ `--resume`         | ✅ `--permission-mode plan` | ✅   | ✅     | ✅ `~/.claude/`               | ✅               | ✅ Complete |
-| Codex         | ✅ `exec resume`      | ✅ `--sandbox read-only`    | ✅   | ✅     | ✅ `~/.codex/`                | ❌ (tokens only) | ✅ Complete |
-| OpenCode      | ✅ `--session`        | ✅ `--agent plan`           | ✅   | ✅     | ✅ `~/.local/share/opencode/` | ✅               | ✅ Complete |
-| Factory Droid | ✅ `-s, --session-id` | ✅ (default mode)           | ✅   | ✅     | ✅ `~/.factory/`              | ❌ (tokens only) | ✅ Complete |
-| Gemini CLI    | TBD                   | TBD                         | TBD  | TBD    | TBD                           | ✅               | 📋 Planned  |
+| Agent              | Resume                       | Read-Only                   | JSON | Images | Sessions                       | Cost                    | Status      |
+| ------------------ | ---------------------------- | --------------------------- | ---- | ------ | ------------------------------ | ----------------------- | ----------- |
+| Claude Code        | ✅ `--resume`                | ✅ `--permission-mode plan` | ✅   | ✅     | ✅ `~/.claude/`                | ✅                      | ✅ Complete |
+| Codex              | ✅ `exec resume`             | ✅ `--sandbox read-only`    | ✅   | ✅     | ✅ `~/.codex/`                 | ❌ (tokens only)        | ✅ Complete |
+| OpenCode           | ✅ `--session`               | ✅ `--agent plan`           | ✅   | ✅     | ✅ `~/.local/share/opencode/`  | ✅                      | ✅ Complete |
+| Factory Droid      | ✅ `-s, --session-id`        | ✅ (default mode)           | ✅   | ✅     | ✅ `~/.factory/`               | ❌ (tokens only)        | ✅ Complete |
+| GitHub Copilot CLI | ✅ `--resume` / `--continue` | ✅ permission rules         | ✅   | ✅     | ✅ `~/.copilot/session-state/` | ❌ (not exposed by CLI) | 🧪 Beta     |
+| Gemini CLI         | TBD                          | TBD                         | TBD  | TBD    | TBD                            | ✅                      | 📋 Planned  |
 
 For detailed implementation guide, see [AGENT_SUPPORT.md](AGENT_SUPPORT.md).
 
@@ -975,11 +976,11 @@ Place icons in `build/` directory:
 
 ### 2. Update Version
 
-Update in `package.json`. Use **odd** minor versions for `main` (stable) and **even** minor versions for `rc` (pre-release). See [Branching & Release Strategy](#branching--release-strategy).
+Update in `package.json`:
 
 ```json
 {
-	"version": "0.15.0"
+	"version": "X.Y.Z"
 }
 ```
 
@@ -999,16 +1000,11 @@ Output in `release/` directory.
 Create a release tag to trigger automated builds:
 
 ```bash
-# Stable release (from main)
-git tag v0.15.0
-git push origin v0.15.0
-
-# Release candidate (from rc) — use -RC suffix
-git tag v0.16.0-RC
-git push origin v0.16.0-RC
+git tag vX.Y.Z
+git push origin vX.Y.Z
 ```
 
-GitHub Actions will build for all platforms and create a release. Tags containing `-RC`, `-beta`, or `-alpha` are automatically marked as pre-releases on GitHub.
+GitHub Actions will build for all platforms and create a release.
 
 ## Documentation
 

README.md

@@ -106,6 +106,7 @@ npm run dev
   - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) - Anthropic's AI coding assistant
   - [OpenAI Codex](https://github.com/openai/codex) - OpenAI's coding agent
   - [OpenCode](https://github.com/sst/opencode) - Open-source AI coding assistant
+  - [GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli) - GitHub's terminal coding agent
 - Git (optional, for git-aware features)
 
 ### Essential Keyboard Shortcuts

docs/installation.md

@@ -20,6 +20,7 @@ Download the latest release for your platform from the [Releases](https://github
   - [Codex](https://github.com/openai/codex) — OpenAI's coding agent (fully integrated)
   - [OpenCode](https://github.com/sst/opencode) — Open-source AI coding assistant (fully integrated)
   - [Factory Droid](https://docs.factory.ai/cli) — Factory's AI coding assistant (fully integrated)
+  - [GitHub Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli) — GitHub's terminal coding agent (beta integration)
   - [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Qwen3 Coder](https://github.com/QwenLM/Qwen-Agent) — Planned support
 - Git (optional, for git-aware features)
 

docs/releases.md

@@ -17,9 +17,9 @@ Maestro can update itself automatically! This feature was introduced in **v0.8.7
 
 **Latest: v0.15.3** | Released January 1, 1
 
-# Major 0.15.x Additions
+### Major 0.15.x Additions
 
-🎶 **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.
+🎶 **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.
 
 🎬 **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.
 
@@ -29,7 +29,7 @@ Maestro can update itself automatically! This feature was introduced in **v0.8.7
 
 🤖 **Factory.ai Droid Support** — Added support for the [Factory.ai](https://factory.ai/product/cli) droid agent. Full session management and output parsing integration.
 
-## Change in v0.15.2
+### Changes in v0.15.2
 
 Patch release with bug fixes, UX improvements, and cherry-picks from the 0.16.0 RC.
 
@@ -88,7 +88,7 @@ Changes in this point release include:
 
 - Desktop app performance improvements (more to come on this, we want Maestro blazing fast) 🐌
 - Added local manifest feature for custom playbooks 📖
-- Agents are now inherently aware of your activity history as seen in the history panel 📜 (this is built-in cross context memory!)
+- Agents are now inherently aware of your activity history as seen in the history panel 📜 (this is built-in cross-context memory!)
 - Added markdown rendering support for AI responses in mobile view 📱
 - Bugfix in tracking costs from JSONL files that were aged out 🏦
 - Added BlueSky social media handle for leaderboard 🦋
@@ -105,7 +105,7 @@ The major contributions to 0.14.x remain:
 
 🧙‍♂️ Added an in-tab wizard for generating Auto Run Playbooks via `/wizard` or a new button in the Auto Run panel.
 
-# Smaller Changes in 0.14.x
+### Smaller Changes in 0.14.x
 
 - Improved User Dashboard, available from hamburger menu, command palette or hotkey 🎛️
 - Leaderboard tracking now works across multiple systems and syncs level from cloud 🏆
@@ -174,11 +174,11 @@ The big changes in the v0.12.x line are the following three:
 
 ## GitHub Spec-Kit Integration
 
-🎯 Added [GitHub Spec-Kit](https://github.com/github/spec-kit) commands into Maestro with a built in updater to grab the latest prompts from the repository. We do override `/speckit-implement` (the final step) to create Auto Run docs and guide the user through their execution, which thanks to Wortrees from v0.11.x allows us to run in parallel!
+🎯 Added [GitHub Spec-Kit](https://github.com/github/spec-kit) commands into Maestro with a built-in updater to grab the latest prompts from the repository. We do override `/speckit-implement` (the final step) to create Auto Run docs and guide the user through their execution, which thanks to Worktrees from v0.11.x allows us to run in parallel!
 
 ## Context Management Tools
 
-📖 Added context management options from tab right-click menu. You can now compress, merge, and transfer contexts between agents. You will received (configurable) warnings at 60% and 80% context consumption with a hint to compact.
+📖 Added context management options from tab right-click menu. You can now compress, merge, and transfer contexts between agents. You will receive (configurable) warnings at 60% and 80% context consumption with a hint to compact.
 
 ## Changes Specific to v0.12.3:
 
@@ -199,9 +199,9 @@ The big changes in the v0.12.x line are the following three:
 
 **Latest: v0.11.0** | Released December 22, 2025
 
-🌳 Github Worktree support was added. Any agent bound to a Git repository has the option to enable worktrees, each of which show up as a sub-agent with their own write-lock and Auto Run capability. Now you can truly develop in parallel on the same project and issue PRs when you're ready, all from within Maestro. Huge improvement, major thanks to @petersilberman.
+🌳 GitHub Worktree support was added. Any agent bound to a Git repository has the option to enable worktrees, each of which show up as a sub-agent with their own write-lock and Auto Run capability. Now you can truly develop in parallel on the same project and issue PRs when you're ready, all from within Maestro. Huge improvement, major thanks to @petersilberman.
 
-# Other Changes
+### Other Changes
 
 - @ file mentions now include documents from your Auto Run folder (which may not live in your agent working directory) 🗄️
 - The wizard is now capable of detecting and continuing on past started projects 🧙
@@ -238,7 +238,7 @@ The big changes in the v0.12.x line are the following three:
 
 ### Changes
 
-- Add Sentry crashing reporting monitoring with opt-out 🐛
+- Added Sentry crash reporting with opt-out 🐛
 - Stability fixes on v0.9.0 along with all the changes it brought along, including...
   - Major refactor to enable supporting of multiple providers 👨‍👩‍👧‍👦
   - Added OpenAI Codex support 👨‍💻
@@ -264,7 +264,7 @@ The big changes in the v0.12.x line are the following three:
 - Implemented fuzzy file search in quick actions for instant navigation 🔍
 - Added "clear" command support to clean terminal shell logs 🧹
 - Simplified search highlighting by integrating into markdown pipeline ✨
-- Enhanced update checker to filter prerelease tags like -rc, -beta 🚀
+- Enhanced update checker to filter pre-release tags like -rc, -beta 🚀
 - Fixed RPM package compatibility for OpenSUSE Tumbleweed 🐧 (H/T @JOduMonT)
 - Added libuuid1 support alongside standard libuuid dependency 📦
 - Introduced Cmd+Shift+U shortcut for tab unread toggle ⌨️
@@ -293,15 +293,15 @@ The big changes in the v0.12.x line are the following three:
 
 Minor bugfixes on top of v0.7.3:
 
-# Onboarding, Wizard, and Tours
+### Onboarding, Wizard, and Tours
 
 - Implemented comprehensive onboarding wizard with integrated tour system 🚀
 - Added project-understanding confidence display to wizard UI 🎨
 - Enhanced keyboard navigation across all wizard screens ⌨️
 - Added analytics tracking for wizard and tour completion 📈
 - Added First Run Celebration modal with confetti animation 🎉
 
-# UI / UX Enhancements
+### UI / UX Enhancements
 
 - Added expand-to-fullscreen button for Auto Run interface 🖥️
 - Created dedicated modal component and improved modal priority constants for expanded Auto Run view 📐
@@ -311,18 +311,18 @@ Minor bugfixes on top of v0.7.3:
 - Implemented drag-and-drop reordering for execution queue items 🎯
 - Enhanced toast context with agent name for OS notifications 📢
 
-# Auto Run Workflow Improvements
+### Auto Run Workflow Improvements
 
 - Created phase document generation for Auto Run workflow 📄
 - Added real-time log streaming to the LogViewer component 📊
 
-# Application Behavior / Core Fixes
+### Application Behavior / Core Fixes
 
 - Added validation to prevent nested worktrees inside the main repository 🚫
 - Fixed process manager to properly emit exit events on errors 🔧
 - Fixed process exit handling to ensure proper cleanup 🧹
 
-# Update System
+### Update System
 
 - Implemented automatic update checking on application startup 🚀
 - Added settings toggle for enabling/disabling startup update checks ⚙️