[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92541":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":12,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":15,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":16,"rankGlobal":10,"rankLanguage":10,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":18,"hasPages":18,"topics":20,"createdAt":10,"pushedAt":10,"updatedAt":36,"readmeContent":37,"aiSummary":38,"trendingCount":15,"starSnapshotCount":15,"syncStatus":39,"lastSyncTime":40,"discoverSource":41},92541,"Homekit","bolivestilo\u002FHomekit","bolivestilo","Homekit gives any AI agent direct, physical control over Apple Home. Flip lights. Lock doors. Read sensors. Through a single open interface.","https:\u002F\u002Fhomekit.builders",null,"TypeScript",66,1,5,0,40.9,"MIT License",false,"main",[21,22,23,24,25,26,27,28,29,30,31,32,33,34,35],"ai-agent","apple-home","automation","claude","cli","cursor","homekit","iot","macos","mcp","model-context-protocol","nodejs","openclaw","smart-home","typescript","2026-07-22 04:02:06","\u003Cdiv align=\"center\">\n\n\u003Cpicture>\n  \u003Cimg alt=\"Homekit\" src=\"https:\u002F\u002Fhomekit.builders\u002Ficon.png\" width=\"96\" height=\"96\" \u002F>\n\u003C\u002Fpicture>\n\n\u003Cbr \u002F>\u003Cbr \u002F>\n\n\u003Ch1>\n  \u003Csub>\u003Cem>the bridge between\u003C\u002Fem>\u003C\u002Fsub>\u003Cbr\u002F>\n  AI Agents & Reality.\n\u003C\u002Fh1>\n\n\u003Cp>\n  Homekit gives any AI agent direct, physical control over Apple Home.\u003Cbr\u002F>\n  Flip lights. Lock doors. Read sensors. Through a single open interface.\n\u003C\u002Fp>\n\n\u003Cbr\u002F>\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit\u002Factions\u002Fworkflows\u002Fci.yml\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg\" alt=\"CI\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit\u002Factions\u002Fworkflows\u002Fcodeql.yml\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit\u002Factions\u002Fworkflows\u002Fcodeql.yml\u002Fbadge.svg\" alt=\"CodeQL\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fhomekit-cli\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fhomekit-cli?label=homekit-cli&color=c0a060&logo=npm&logoColor=white\" alt=\"homekit-cli\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fhomekit-mcp\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fhomekit-mcp?label=homekit-mcp&color=c0a060&logo=npm&logoColor=white\" alt=\"homekit-mcp\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fmodelcontextprotocol.io\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMCP-Compatible-6c47ff?logo=anthropic&logoColor=white\" alt=\"MCP Compatible\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fapps.apple.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FApp_Store-macOS-000000?logo=apple&logoColor=white\" alt=\"App Store\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-3b82f6.svg\" alt=\"MIT\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit\u002Fstargazers\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Fbolivestilo\u002FHomekit?style=social\" alt=\"Stars\" \u002F>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr\u002F>\n\n\u003Cp>\n  \u003Ca href=\"#-awaken\">Awaken\u003C\u002Fa> ·\n  \u003Ca href=\"#-understand\">Understand\u003C\u002Fa> ·\n  \u003Ca href=\"#-witness\">Witness\u003C\u002Fa> ·\n  \u003Ca href=\"#-install\">Install\u003C\u002Fa> ·\n  \u003Ca href=\"#-begin\">Begin\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fhomekit.builders\">Website\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002F\">Docs\u003C\u002Fa> ·\n  \u003Ca href=\"CHANGELOG.md\">Changelog\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C\u002Fdiv>\n\n---\n\n## ✦ Awaken\n\nApple Home is powerful. But it's locked.\n\nLocked behind apps. Behind Siri. Behind tap-to-toggle UI designed for humans, not agents. Every AI model in 2025 can reason, plan, and act — but the moment you ask it to *\"turn off the kitchen lights before the meeting\"*, it hits a wall.\n\n**Homekit tears that wall down.**\n\nIt exposes your entire Apple Home — every light, lock, thermostat, sensor, scene, and automation — as structured tools that any AI agent can call. The Model Context Protocol becomes the language. Your home becomes the body.\n\nThis is the first open bridge between Apple's HomeKit framework and the agent layer.\n\n---\n\n## ✦ Understand\n\n### Architecture\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    AI Agent Layer                        │\n│         Claude · ChatGPT · Cursor · Windsurf            │\n│              Any MCP-compatible client                   │\n└────────────────────┬────────────────────────────────────┘\n                     │  Model Context Protocol (MCP)\n                     │  8 structured tools\n                     ▼\n┌─────────────────────────────────────────────────────────┐\n│                  homekit-mcp server                      │\n│           stdio transport · JSON-RPC 2.0                 │\n└────────────────────┬────────────────────────────────────┘\n                     │  Unix socket \u002F IPC\n                     ▼\n┌─────────────────────────────────────────────────────────┐\n│              Homekit macOS App                           │\n│         Native HomeKit framework bridge                  │\n│     Authorization · Accessory state · Scene control     │\n└────────────────────┬────────────────────────────────────┘\n                     │  Apple HomeKit Framework\n                     ▼\n┌─────────────────────────────────────────────────────────┐\n│                   Apple Home                             │\n│   Lights · Locks · Thermostats · Sensors · Cameras      │\n│          Scenes · Automations · Multi-Home               │\n└─────────────────────────────────────────────────────────┘\n```\n\n### Packages\n\n| Package | Description | Version |\n|---|---|---|\n| [`homekit-cli`](packages\u002Fcli\u002F) | Full terminal interface for Apple Home | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fhomekit-cli?color=c0a060)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fhomekit-cli) |\n| [`homekit-mcp`](packages\u002Fmcp\u002F) | MCP server — 8 tools for AI agents | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fhomekit-mcp?color=c0a060)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fhomekit-mcp) |\n| [`@homekit\u002Fcore`](packages\u002Fcore\u002F) | Shared bridge, types, and auth manager | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F%40homekit%2Fcore?color=c0a060)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@homekit\u002Fcore) |\n| [`@openclaw\u002Fhomekit`](packages\u002Fopenclaw\u002F) | Plugin for the @openclaw agent framework | [![npm](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F%40openclaw%2Fhomekit?color=c0a060)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@openclaw\u002Fhomekit) |\n\n### MCP Tools Reference\n\n| Tool | Description |\n|---|---|\n| `homekit_list_accessories` | List all accessories, optionally filtered by room |\n| `homekit_get_accessory` | Get the current state of an accessory |\n| `homekit_set_accessory` | Set accessory state (on\u002Foff, 0–100) |\n| `homekit_activate_scene` | Activate a scene by name |\n| `homekit_list_scenes` | List all available scenes |\n| `homekit_create_scene` | Create a new scene with specified accessory states |\n| `homekit_list_automations` | List all automations |\n| `homekit_run_automation` | Trigger an automation by name |\n\n### Requirements\n\n| Requirement | Minimum |\n|---|---|\n| macOS | 13 Ventura |\n| Node.js | 18 |\n| Apple Home | Configured on the Mac running Homekit |\n| Homekit macOS App | Required for initial authorization |\n\n---\n\n## ✦ Witness\n\n### CLI Demo\n\n```\n$ homekit list\n\n  Living Room\n  ├── Ceiling Light         ● on    100%\n  ├── Floor Lamp            ● on     40%\n  └── Smart Plug            ○ off\n\n  Bedroom\n  ├── Ceiling Light         ○ off\n  ├── Bedside Lamp          ● on     20%\n  └── Smart Lock            ● locked\n\n  Kitchen\n  ├── Under Cabinet Lights  ● on     80%\n  └── Dishwasher            ○ off\n\n  Thermostat\n  └── Ecobee                ● 72°F  cooling\n\n$ homekit scene \"Movie Night\"\n  ✓ Scene activated — Living Room Lights 15%, TV Backlight on, all others off\n\n$ homekit set \"Front Door\" unlock\n  ✓ Front Door — unlocked\n\n$ homekit automation run \"Evening Routine\"\n  ✓ Automation triggered — 6 actions queued\n```\n\n### AI Agent Demo (Claude Desktop)\n\n```\nYou:   \"I'm heading to bed. Wind things down.\"\n\nAgent: Let me check what's currently on…\n       [calls homekit_list_accessories]\n\n       Found 4 lights on and the thermostat at 72°F.\n       [calls homekit_set_accessory ×4, homekit_set_accessory for thermostat]\n\n       Done. Turned off living room, kitchen, and hallway lights.\n       Set bedroom lamp to 10% and thermostat to 68°F.\n       Want me to lock the front door too?\n\nYou:   \"Yes.\"\n\nAgent: [calls homekit_set_accessory — Front Door: locked]\n       Locked. Good night.\n```\n\n### JSON Output\n\n```bash\n$ homekit list --json\n```\n\n```json\n[\n  {\n    \"id\": \"AA:BB:CC:DD:EE:01\",\n    \"name\": \"Ceiling Light\",\n    \"room\": \"Living Room\",\n    \"type\": \"lightbulb\",\n    \"state\": { \"on\": true, \"brightness\": 100 }\n  },\n  {\n    \"id\": \"AA:BB:CC:DD:EE:02\",\n    \"name\": \"Front Door\",\n    \"room\": \"Entryway\",\n    \"type\": \"lock\",\n    \"state\": { \"locked\": true }\n  }\n]\n```\n\n---\n\n## ✦ Install\n\n### Option A — CLI\n\n```bash\nnpm install -g homekit-cli\nhomekit auth\n```\n\n### Option B — MCP Server (AI agents)\n\n```bash\nnpm install -g homekit-mcp\n```\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Claude Desktop\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nEdit `~\u002FLibrary\u002FApplication Support\u002FClaude\u002Fclaude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"homekit\": {\n      \"command\": \"npx\",\n      \"args\": [\"homekit-mcp\"]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Cursor\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n`.cursor\u002Fmcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"homekit\": {\n      \"command\": \"npx\",\n      \"args\": [\"homekit-mcp\"]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Windsurf\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n`~\u002F.codeium\u002Fwindsurf\u002Fmcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"homekit\": {\n      \"command\": \"npx\",\n      \"args\": [\"homekit-mcp\"]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Any MCP client\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n`homekit-mcp` uses stdio transport and is compatible with any client implementing the [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io).\n\n\u003C\u002Fdetails>\n\n### Option C — @openclaw Plugin\n\n```bash\nnpm install @openclaw\u002Fhomekit\n```\n\n```typescript\nimport { homekit } from '@openclaw\u002Fhomekit';\n\nconst agent = new OpenClaw({ plugins: [homekit()] });\n```\n\n### macOS App\n\n[![Download on the App Store](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDownload_on_the_App_Store-000000?logo=apple&logoColor=white&style=for-the-badge)](https:\u002F\u002Fapps.apple.com)\n\n---\n\n## ✦ Begin\n\n### Authorization\n\n```bash\nhomekit auth\n```\n\nOpens the Homekit macOS App and presents the system Home access dialog. Takes ~10 seconds.\n\n### First commands\n\n```bash\nhomekit list                           # See everything in your home\nhomekit set \"Living Room Lights\" on    # Turn on lights\nhomekit set \"Dimmer\" 75                # Set brightness\nhomekit scene \"Good Morning\"           # Activate a scene\nhomekit scene create \"Focus Mode\" \\\n  --accessories \"Desk Lamp:on:80\" \\\n               \"Ceiling Light:off\"    # Create a scene\nhomekit scene export > scenes.json     # Export all scenes\nhomekit automation list                # List automations\nhomekit automation run \"Evening\"       # Trigger an automation\nhomekit home list                      # Manage multiple Homes\nhomekit home switch \"Beach House\"\n```\n\n### CLI Reference\n\n| Command | Description |\n|---|---|\n| `homekit auth` | Authorize with Apple Home via macOS app |\n| `homekit list [room]` | List accessories, optionally filtered by room |\n| `homekit get \u003Cname>` | Get the current state of an accessory |\n| `homekit set \u003Cname> \u003Cvalue>` | Set state: `on`, `off`, or `0`–`100` |\n| `homekit scene [name]` | List all scenes or activate one by name |\n| `homekit scene create` | Interactively create a new scene |\n| `homekit scene import \u003Cfile>` | Import scenes from a JSON file |\n| `homekit scene export` | Export all scenes as JSON |\n| `homekit automation list` | List all automations with status |\n| `homekit automation run \u003Cname>` | Trigger an automation |\n| `homekit home list` | List all configured Homes |\n| `homekit home switch \u003Cname>` | Switch the active Home |\n| `homekit status` | Full Home summary — all rooms and live states |\n\n**Global flags:** `--json` · `--verbose` · `--version` · `--help`\n\n---\n\n## Contributing\n\nContributions are welcome. We have [good first issues](https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit\u002Fissues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) ready.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbolivestilo\u002FHomekit.git\ncd Homekit && npm install && npm run build && npm test\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) · [SECURITY.md](SECURITY.md) · [ROADMAP.md](ROADMAP.md)\n\n---\n\n## Contributors\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\n      \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo\">\n        \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fbolivestilo.png\" width=\"80\" alt=\"bolivestilo\" \u002F>\u003Cbr\u002F>\n        \u003Csub>\u003Cb>bolivestilo\u003C\u002Fb>\u003C\u002Fsub>\n      \u003C\u002Fa>\u003Cbr\u002F>\n      \u003Csup>💻 🎨 🤔 🚧\u003C\u002Fsup>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n\u003Cdiv align=\"center\">\n\n**[homekit.builders](https:\u002F\u002Fhomekit.builders)**\n\n*The bridge between AI Agents & Reality.*\n\nMade with ❤️ by [bolivestilo](https:\u002F\u002Fgithub.com\u002Fbolivestilo) · ⭐ Star this repo if it's useful\n\n\u003C\u002Fdiv>\n","Homekit 是一个开源桥接工具，让 AI 智能体通过标准化接口直接控制 Apple Home 设备。它基于 Model Context Protocol（MCP）实现语义化设备操作，支持灯光开关、门锁控制、传感器读取等物理动作，并提供 CLI 和 Node.js 集成。项目采用 TypeScript 开发，兼容 macOS 环境，无需依赖 Siri 或 Home App 图形界面。适用于需将大语言模型或自主智能体接入真实家居环境的自动化场景，如 AI 家居管家、多模态任务执行、本地化智能体开发等。",2,"2026-07-09 02:30:18","CREATED_QUERY"]