ios-agent-mcp 2.5.1 → 2.7.0

package/README.md

@@ -1,17 +1,29 @@
 # iOS Agent MCP
 
-## One install, one MCP connection (2.5.1)
+[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@2.5.1
+claude mcp add ios-agent -- npx -y ios-agent-mcp@latest
 ```
 
-The default server exposes 34 tools: 11 Swift reviews, 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:
 
 ```bash
-npx -y ios-agent-mcp@2.5.1 new MyApp --brief "A reading list with local storage" --xcodegen
+npx -y ios-agent-mcp@latest new MyApp --brief "A reading list with local storage" --xcodegen
 ```
 
 Requires Node.js 20+. Simulator operations require macOS and Xcode; XcodeGen is required to generate an Xcode project from the starter specification. The agent implements app features using the starter, source tools and verification tools. One install is not autonomous app generation. The default connection now includes tools that write files and operate the simulator; review and reference tools remain read-only.
@@ -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
 ```
 
 ---
@@ -267,3 +312,15 @@ before, which is exactly how 2.0.1 shipped with a manifest reading 1.0.0.
 ## License
 
 MIT — see [LICENSE](./LICENSE).
+
+## App-building loop preview (source checkout)
+
+The CLI now provides `loop init`, `loop resume` and `loop status` alongside the unified MCP connection. See the [workflow guide](../docs/tooling/app-building-loop.md) and [reading-list demo](../samples/ReadingList/README.md) for reproducible acceptance checks, bounded Claude repairs, simulator evidence and saved progress. Real Claude repair is not yet integration-verified; the published npm version does not include this preview.
+
+## 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.