feat: Github Copilot CLI feature pairity / improvements

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,17 @@ 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>/`
+
 ## Adding New Agents
 
 To add support for a new agent:

CLAUDE.md

@@ -97,13 +97,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

@@ -644,13 +644,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).
 

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)