ios-agent-mcp 2.6.0 → 2.7.0

package/README.md

@@ -1,12 +1,24 @@
 # iOS Agent MCP
 
+[Explore the website](https://nagarjuna2997.github.io/ios-agent-skill/) · [Choose your AI and install](https://nagarjuna2997.github.io/ios-agent-skill/install.html)
+
+## Version 2.7.0
+
+Includes real appearance-aware color catalogs and offline SVG-layer app icons,
+Muse Code setup with verified MCP discovery, and refreshed public Apple references
+through September 16, 2026 (27.0 releases and separately labeled 27.2 betas).
+The CLI is included automatically. User accounts, signing profiles and credentials
+are not package resources. Gemini CLI uses the repository extension; ChatGPT uses
+the skills package or a separately configured MCP connection. See the
+[client setup guide](https://nagarjuna2997.github.io/ios-agent-skill/install.html).
+
 ## One install, one MCP connection
 
 ```bash
 claude mcp add ios-agent -- npx -y ios-agent-mcp@latest
 ```
 
-The default server exposes 35 tools: 12 review/metadata tools, 8 Apple reference tools, 14 simulator tools, and `create_app`. App scaffolding and simulator packages install automatically as dependencies; no separate installation or MCP connection is needed. Remove the separate knowledge/simulator connections if you previously configured them to avoid duplicate tools.
+The default server exposes 36 tools: 12 review/metadata tools, 8 Apple reference tools, 14 simulator tools, `create_app`, and the local `prepare_issue_report` tool. App scaffolding and simulator packages install automatically as dependencies; no separate installation or MCP connection is needed. Remove the separate knowledge/simulator connections if you previously configured them to avoid duplicate tools.
 
 Create a starter directly:
 
@@ -30,7 +42,7 @@ This package includes two MCP binaries: `ios-agent-mcp` for local Swift project
 npx -y --package=ios-agent-mcp@2.4.0 ios-agent-knowledge
 ```
 
-Knowledge tools search 405 technologies and 96 update/release-note sources, retrieve guides, plan an app implementation, and specify separate Icon Composer layers. They do not write apps, access arbitrary project paths or claim native icon generation. [Setup](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/mcp/installation.md).
+Knowledge tools search 405 technologies and 96 update/release-note sources, retrieve guides, plan an app implementation, and specify separate Icon Composer layers. They do not write apps, access arbitrary project paths or claim native icon generation. [Setup](https://nagarjuna2997.github.io/ios-agent-skill/install.html).
 
 # ios-agent-mcp
 
@@ -58,6 +70,8 @@ Claude → review_swift_concurrency
 
 ## Install
 
+Choose your client: [Claude](#claude-code) · [ChatGPT / Codex](#chatgpt--codex) · [Gemini CLI](#gemini-cli) · [Muse Code](#muse-code). One server package; client connection methods differ.
+
 ### Claude Code
 
 ```bash
@@ -79,28 +93,59 @@ claude mcp add ios-agent -- npx -y ios-agent-mcp
 }
 ```
 
-### Cursor
+### ChatGPT / Codex
+
+**Codex** connects to the local unified server:
+
+```bash
+codex mcp add ios-agent -- npx -y ios-agent-mcp@latest
+```
+
+**ChatGPT** has a different setup: use the skills-only release package where your account supports it, or configure a hosted HTTPS knowledge server/private MCP tunnel through a supported developer-mode flow. ChatGPT web does not run this local `npx` command itself. This project does not provide a public hosted endpoint. See the [ChatGPT setup guide](https://nagarjuna2997.github.io/ios-agent-skill/install.html#chatgpt) for account requirements and connection limits.
+
+### Gemini CLI
+
+```bash
+gemini mcp add ios-agent -- npx -y ios-agent-mcp@latest
+```
+
+This adds a local MCP connection; Gemini web chat is a different product. The repository extension additionally supplies `GEMINI.md`, but its version pin must be available on npm before installing it. Use one connection method to avoid duplicate tools. [Gemini setup and verification](https://nagarjuna2997.github.io/ios-agent-skill/install.html#gemini).
+
+### Muse Code
 
-`.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` globally:
+Install outside the agent sandbox:
+
+```bash
+npm install -g ios-agent-mcp@latest
+```
+
+Merge this into `~/.config/muse/settings.json`, preserving your existing settings:
 
 ```json
 {
+  "schema_version": 1,
   "mcpServers": {
     "ios-agent": {
-      "command": "npx",
-      "args": ["-y", "ios-agent-mcp"]
+      "command": "ios-agent-mcp",
+      "args": []
     }
   }
 }
 ```
 
+Restart Muse. If the executable is not found, use its absolute path from `command -v ios-agent-mcp`. MCP discovery and a Stop hook have been verified; complete model-driven app creation has not. [Muse setup and evidence](https://nagarjuna2997.github.io/ios-agent-skill/install.html#muse).
+
+### Other clients, including Cursor
+
+Our primary client families are **Claude, ChatGPT/Codex, Gemini CLI and Muse**. Cursor and other MCP-compatible clients may use the generic `mcpServers` configuration shown above, but are not actively verified in this support scope. [Request another client or vote on an existing issue](https://github.com/Nagarjuna2997/ios-agent-skill/issues/new?template=client_support.md).
+
 ### From source
 
 ```bash
 git clone https://github.com/Nagarjuna2997/ios-agent-skill.git
 cd ios-agent-skill/mcp-server
 npm install && npm run build
-# then point your client at: node /absolute/path/to/mcp-server/dist/index.js
+# then point your client at: node /absolute/path/to/mcp-server/dist/unified.js
 ```
 
 ---
@@ -275,3 +320,7 @@ The CLI now provides `loop init`, `loop resume` and `loop status` alongside the
 ## 2.6.0
 
 Adds `review_app_intents` with conservative SiriKit migration advice and opt-in Apple Intelligence schema/onscreen checks. Apple snapshots refreshed after the iOS 27 release. Includes the preview `loop` CLI; real Claude repair remains unverified. See [release verification](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/apple/ios-27-release-verification.md) and [complete tools](https://github.com/Nagarjuna2997/ios-agent-skill/blob/main/docs/mcp/tools.md).
+
+## Local issue previews (source build; next release)
+
+`prepare_issue_report` is included in 2.7.0. It creates a local preview from fixed failure categories and links to this project’s issue tracker. It does not collect diagnostics, open a browser, make network calls or submit issues. Show the preview to the user before opening any link. GitHub sign-in and user submission are required.