feat: add launchd service management and agent skill install

AGENTS.md

@@ -14,7 +14,10 @@ This repository provides a user-friendly CLI (`xcode-mcp`) for interacting with
 - `src/xcode.ts`: main CLI entrypoint and command definitions.
 - `src/xcode-output.ts`: text/json result formatting.
 - `src/xcode-mcp.ts`: HTTP bridge server that proxies to `xcrun mcpbridge`.
+- `src/xcode-service.ts`: launchd service management (install/uninstall/status/logs).
+- `src/xcode-skill.ts`: skill install/uninstall for agent skill directories.
 - `src/mcpbridge.ts`: generated MCP client/bindings (generated, not hand-maintained).
+- `skills/xcode-mcp/SKILL.md`: agent skill definition shipped with the package.
 - `tests/*.test.ts`: Node test suite.
 - `bin/xcode-mcp`: runtime launcher.
 

README.md

@@ -35,6 +35,36 @@ xcode-mcp --tab <tabIdentifier> build
 
 If exactly one Xcode tab is open, `--tab` is auto-detected.
 
+## Background Service (launchd)
+
+Run the bridge as a persistent background service that auto-starts on login:
+
+```bash
+# install and start the launchd service
+xcode-mcp service install
+
+# check if the bridge is running
+xcode-mcp service status
+
+# follow bridge logs
+xcode-mcp service logs -f
+
+# stop and remove the service
+xcode-mcp service uninstall
+```
+
+## Install Skill for Claude Code / Codex
+
+Install the `xcode-mcp` skill so agents know how to use the CLI:
+
+```bash
+# install skill for Claude Code
+xcode-mcp skill install --skill-root-dir ~/.claude/skills
+
+# install skill for Codex
+xcode-mcp skill install --skill-root-dir ~/.codex/skills
+```
+
 ## Use With Codex / Claude
 
 This repo includes a helper command to register the **HTTP bridge** as an MCP server with your agent.

package.json

@@ -29,6 +29,11 @@
   },
   "devDependencies": {},
   "type": "module",
+  "files": [
+    "bin/",
+    "src/",
+    "skills/"
+  ],
   "bin": {
     "xcode-mcp": "./bin/xcode-mcp"
   }