docs: add badges, config snippets, issue templates, and CONTRIBUTING.md

- CI/lint/license/Go Report Card badges in README
- One-click install badges for VS Code, VS Code Insiders, and Cursor
- Config snippets for Claude Desktop, Claude Code, VS Code, and Cursor
- GitHub issue templates for bug reports and feature requests
- CONTRIBUTING.md with development setup and guidelines
- Added iwdp_status tool to README tools table
- Synced marketplace.json version to 0.2.4

Author: nnemirovsky

.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "iwdp-mcp",
-  "version": "0.2.1",
+  "version": "0.2.4",
   "description": "iOS Safari debugging via ios-webkit-debug-proxy — MCP server with full WebKit Inspector Protocol support",
   "owner": {
     "name": "nnemirovsky"

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,26 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened? What did you expect?
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce the issue?
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: |
+        - OS and version
+        - iOS version
+        - iwdp-mcp version (`iwdp-mcp --version` or `iwdp-cli --version`)
+        - ios-webkit-debug-proxy version
+        - Client (Claude Code, VS Code, Cursor, CLI)

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,16 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What feature would you like? What problem does it solve?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any workarounds or alternative approaches you've considered?

CONTRIBUTING.md

@@ -0,0 +1,65 @@
+# Contributing to iwdp-mcp
+
+Thanks for your interest in contributing!
+
+## Development Setup
+
+```bash
+# Clone and build
+git clone https://github.com/nnemirovsky/iwdp-mcp.git
+cd iwdp-mcp
+make build
+
+# Install ios-webkit-debug-proxy (macOS)
+brew install ios-webkit-debug-proxy
+```
+
+## Before Submitting a PR
+
+```bash
+make fmt    # gofumpt formatting
+make lint   # golangci-lint
+make test   # all unit tests
+```
+
+## Testing
+
+- **Unit tests** (`make test`) — no device needed, uses mock WebSocket server
+- **E2E tests** (`make test-e2e`) — builds binaries, tests CLI + MCP server JSON-RPC
+- **Integration tests** (`make test-integration`) — requires `ios_webkit_debug_proxy` binary
+- **Simulator tests** (`make test-simulator`) — boots iOS Simulator, tests all tools against real Safari
+
+## Commit Messages
+
+Use [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+feat: add heap snapshot collection
+fix: prevent concurrent WebSocket write panic
+refactor: extract URL parsing into DevicePort helper
+test: add table-driven tests for proxy port parsing
+```
+
+## Branch Names
+
+Prefix branches with the change type:
+
+```
+feat/heap-snapshots
+fix/concurrent-write
+refactor/proxy-port-parsing
+```
+
+## Architecture
+
+- `internal/webkit/` — WebKit Inspector Protocol client (WebSocket + Target routing)
+- `internal/tools/` — Tool implementations shared by MCP server and CLI
+- `internal/proxy/` — iwdp process detection and management
+- `cmd/iwdp-mcp/` — MCP server binary (stdio transport)
+- `cmd/iwdp-cli/` — CLI binary
+
+All WebKit protocol communication goes through `webkit.Client`. Tools return structured results; formatting is done by the caller (MCP or CLI).
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.

README.md

@@ -1,20 +1,20 @@
 # iwdp-mcp
 
+[![CI](https://github.com/nnemirovsky/iwdp-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/nnemirovsky/iwdp-mcp/actions/workflows/test.yml)
+[![Lint](https://github.com/nnemirovsky/iwdp-mcp/actions/workflows/lint.yml/badge.svg)](https://github.com/nnemirovsky/iwdp-mcp/actions/workflows/lint.yml)
+[![Go Report Card](https://goreportcard.com/badge/github.com/nnemirovsky/iwdp-mcp)](https://goreportcard.com/report/github.com/nnemirovsky/iwdp-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=iwdp-mcp&config=%7B%22command%22%3A%22iwdp-mcp%22%7D)
+[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=iwdp-mcp&config=%7B%22command%22%3A%22iwdp-mcp%22%7D&quality=insiders)
+[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=iwdp-mcp&config=eyJjb21tYW5kIjoiaXdkcC1tY3AifQ==)
+
 MCP server + CLI for debugging iOS Safari via [ios-webkit-debug-proxy](https://github.com/google/ios-webkit-debug-proxy).
 
 Speaks **WebKit Inspector Protocol** natively — full access to all 27 WebKit Inspector domains, including httpOnly cookies, network interception, heap snapshots, and more.
 
 ## Installation
 
-### Claude Code Plugin (recommended)
-
-Inside Claude Code, run:
-
-```
-/plugin marketplace add nnemirovsky/iwdp-mcp
-/plugin install iwdp-mcp
-```
-
 ### Go Install
 
 ```bash
@@ -75,7 +75,26 @@ iwdp-cli cookies
 
 ### MCP Server
 
-Add to your Claude Code config (`.mcp.json`):
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "iwdp-mcp": {
+      "command": "iwdp-mcp"
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+Add to your project's `.mcp.json`:
 
 ```json
 {
@@ -87,6 +106,32 @@ Add to your Claude Code config (`.mcp.json`):
 }
 ```
 
+Or install as a Claude Code plugin:
+
+```
+/plugin marketplace add nnemirovsky/iwdp-mcp
+/plugin install iwdp-mcp
+```
+</details>
+
+<details>
+<summary><strong>VS Code / Cursor</strong></summary>
+
+Add to `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "servers": {
+    "iwdp-mcp": {
+      "command": "iwdp-mcp"
+    }
+  }
+}
+```
+
+Or click the install badges at the top of this README.
+</details>
+
 ### Claude Code Prompts
 
 Once the MCP server is configured, you can ask Claude Code things like:
@@ -132,6 +177,7 @@ Set a breakpoint in main.js and step through it
 ### Core
 | Tool | Description |
 |------|-------------|
+| `iwdp_status` | Check/auto-start ios-webkit-debug-proxy |
 | `list_devices` | List connected iOS devices (HTTP GET :9221) |
 | `list_pages` | List Safari tabs (HTTP GET :9222+) |
 | `select_page` | Connect to a specific tab |