Home / omarshahine / homeclaw · AGENTS.md · GitHub

AGENTS.md agentsB

AGENTS.md is agent-read markdown (agents) from omarshahine/homeclaw.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# HomeClaw

HomeClaw exposes Apple HomeKit accessories via a CLI tool, plugins for Claude Code and OpenClaw, and a stdio MCP server for Claude Desktop. It uses a unified Mac Catalyst architecture with an AppKit bridge bundle for the macOS menu bar.

## Architecture

```
Claude Code → Plugin (.claude-plugin/) → stdio MCP server (Node.js) ─┐
Claude Desktop → stdio MCP server (Node.js) ─────────────────────────┤
OpenClaw → Plugin (openclaw/) → homeclaw-cli ────────────────────────┤
                                                                     ▼
                                              /tmp/homeclaw.sock (JSON newline-delimited)
                                                                     │
                                              HomeClaw (Mac Catalyst UIKit app)
                                                ├── HomeKitManager (direct, in-process)
                                                ├── SocketServer (for CLI/MCP clients)
                                                └── macOSBridge.bundle (NSStatusItem menu bar)
```
…

Read the whole file at its exact version.

How to install

Latest version
mdr add omarshahine/homeclaw/AGENTS.md@git:20260921.36fc7c8
Exact content
mdr add omarshahine/homeclaw/AGENTS.md@sha256:74ea9a24c7651d24

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rl5xwffrty6emcja.svg)](https://markdownregistry.com/a/art_rl5xwffrty6emcja)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260921.36fc7c8 latest2026-09-21 36fc7c8 41,192 BB view · diff
git:20260831.97cee772026-08-31 97cee77 40,592 BA view · diff
git:20260823.b4ada022026-08-23 b4ada02 40,322 BA view · diff
git:20260823.f1251fe2026-08-23 f1251fe 39,376 BA view · diff
git:20260718.324a3402026-07-18 324a340 38,910 BA view · diff
git:20260531.7d6e7072026-05-31 7d6e707 38,915 BA view

Audit of the latest version

B  13 of 14 checks passed. Deterministic, no model, same answer every run.
  • fail: No link to a raw IP address (matched: http://127.0.0.1:9090)
  • pass: Size between 200 bytes and 200 KB (41192 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No script tag

Source

GitHub

omarshahine/homeclaw · 173 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rl5xwffrty6emcja
GET https://markdownregistry.com/api/v1/resolve?ref=omarshahine/homeclaw/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/74ea9a24c7651d24401f672ae8a7c1b25bc27101829b5d8bea44f3302f23c83c

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from omarshahine/homeclaw

app-resizability skill
omarshahine/homeclaw · .claude/skills/app-resizability/SKILL.md · Use when an app's layout must adapt to a window that changes size while the app runs, or when an app must support more…
git:20260921.6652fd0 · audit A · 173 stars
ios-app-intents skill
omarshahine/homeclaw · .claude/skills/ios-app-intents/SKILL.md · Design and implement App Intents, app entities, and App Shortcuts for iOS apps so useful actions and content are…
git:20260510.35d37d5 · audit A · 173 stars
ios-debugger-agent skill
omarshahine/homeclaw · .claude/skills/ios-debugger-agent/SKILL.md · Use XcodeBuildMCP to build, run, launch, and debug the current iOS project on a booted simulator. Trigger when asked to…
git:20260510.35d37d5 · audit A · 173 stars
ios-ettrace-performance skill
omarshahine/homeclaw · .claude/skills/ios-ettrace-performance/SKILL.md · Capture and interpret ETTrace profiles for iOS simulator apps, including symbolicated launch and runtime flamegraphs…
git:20260510.35d37d5 · audit A · 173 stars
ios-memgraph-leaks skill
omarshahine/homeclaw · .claude/skills/ios-memgraph-leaks/SKILL.md · Capture, inspect, compare, and root-cause iOS memory graph leaks using Apple's leaks and memgraph tools. Use when…
git:20260510.35d37d5 · audit A · 173 stars
spm-build-analysis skill
omarshahine/homeclaw · .claude/skills/spm-build-analysis/SKILL.md · Analyze Swift Package Manager dependencies, package plugins, module variants, and CI-oriented build overhead that slow…
git:20260510.35d37d5 · audit A · 173 stars
swiftui-expert-skill skill
omarshahine/homeclaw · .claude/skills/swiftui-expert-skill/SKILL.md · Use when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state management, view…
git:20260510.35d37d5 · audit A · 173 stars
swiftui-liquid-glass skill
omarshahine/homeclaw · .claude/skills/swiftui-liquid-glass/SKILL.md · Implement, review, or improve SwiftUI features using the iOS 26+ Liquid Glass API. Use when asked to adopt Liquid Glass…
git:20260510.35d37d5 · audit A · 173 stars
swiftui-performance-audit skill
omarshahine/homeclaw · .claude/skills/swiftui-performance-audit/SKILL.md · Audit and improve SwiftUI runtime performance from code review and architecture. Use for requests to diagnose slow…
git:20260510.35d37d5 · audit A · 173 stars
swiftui-specialist skill
omarshahine/homeclaw · .claude/skills/swiftui-specialist/SKILL.md · Authoritative SwiftUI best practices and performance guidance from Apple; supersedes prior training on these topics…
git:20260921.6652fd0 · audit A · 173 stars
swiftui-ui-patterns skill
omarshahine/homeclaw · .claude/skills/swiftui-ui-patterns/SKILL.md · Best practices and example-driven guidance for building SwiftUI views and components, including navigation hierarchies…
git:20260510.35d37d5 · audit A · 173 stars
swiftui-view-refactor skill
omarshahine/homeclaw · .claude/skills/swiftui-view-refactor/SKILL.md · Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow…
git:20260510.35d37d5 · audit A · 173 stars

Every file in omarshahine/homeclaw

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

Browse by kind, by grade B, or by owner.