Skip to content
View omarshahine's full-sized avatar

Block or report omarshahine

Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
omarshahine/README.md

Hi, I'm Omar Shahine

OmarKnows OmarKnows AI GitHub X

I build native macOS apps, command-line tools, MCP servers, and agent plugins for personal productivity. Most of my projects start as small tools for my own workflows: managing a Mac, automating home devices, triaging information, tracking travel, or connecting AI assistants to the apps I already use.

I work at Microsoft during the day. The projects here are nights-and-weekends work, built mostly with Claude Code.

What I'm Building Around

  • Personal AI assistants with real tools - OpenClaw plugins, Claude Code plugins, MCP servers, and local automations that can actually act on calendars, mail, notes, home devices, and services.
  • Native macOS utility apps - Swift apps that turn power-user workflows into focused, local-first tools.
  • Practical CLIs - Small command-line tools for home automation, reservations, finance, travel, and personal operations.

Featured Projects

🦞 HomeClaw - HomeKit control for lights, locks, thermostats, and scenes from Claude Desktop, Claude Code, or OpenClaw. Includes a native macOS menu bar app and split-process architecture for Apple's HomeKit constraints.

πŸ“ findmy-cli - Query Find My friend locations on macOS through UI automation, screenshots, Vision OCR, and structured CLI output.

πŸ’¬ Obsidian Chat - Agentic AI chat inside Obsidian with Anthropic and OpenAI support, note reading, note editing, and mobile-first UI.

🍎 Apple PIM CLI Tools - Native macOS access to Calendar, Reminders, Contacts, and Mail through Apple frameworks for Claude Code and OpenClaw.

πŸ“§ Fastmail Remote - Remote MCP server for Fastmail on Cloudflare Workers, secured with Cloudflare Access OAuth.

πŸ› οΈ ShellCraft - Native macOS app for managing shell configuration, including aliases, PATH, SSH keys, Git config, Homebrew, and Claude Code settings.

Agent and OpenClaw Plugins

I'm a maintainer of OpenClaw, an open source personal AI assistant. Many of these projects also ship as Claude Code plugins.

πŸ’‘ lutron-cli - Lutron Caseta lighting, shades, fans, warm-dim bulbs, Pico remotes, scenes, Smart Away, battery checks, and whole-home state export.

🟒 aqara-cli - Aqara Open Cloud API client β€” homes, devices, rooms, scenes, rename and move, OAuth browser bootstrap, and a launchd refresher so tokens never expire. The CLI everyone reaches for after the official Aqara MCP server proves too limited.

🍽️ restaurant-cli - Pluggable restaurant reservation booking across Resy and OpenTable, with search, booking, cancellation, listing, and timed-release sniping.

πŸ“¦ openclaw-parcel - Package delivery tracking through Parcel, including add, list, and status workflows from the terminal.

πŸ“š openclaw-instapaper - Instapaper reading-list management, archiving, and highlight export to Obsidian.

🎬 trakt-plugin - Movie and TV tracking through Trakt.tv with search, watch history, watchlist, show progress, and mark-as-watched flows.

🌑️ daikin-cli - Daikin One+ thermostat control from the command line and natural-language assistant workflows.

πŸ”Œ Chief-of-Staff Plugin Template - Template for building Claude Code personal assistant plugins, including email triage, travel, credit-card benefits, and file-renaming examples.

πŸ“ Rename Agent - AI-powered file renaming agent built with the Claude Agent SDK.

Other Useful Tools

πŸ”₯ Valor Fireplace CLI - Local-network control for Valor fireplaces from the command line.

🏠 homebridge-valor-fireplace - Homebridge integration for Valor fireplaces.

πŸ’° FamZoo YNAB Sync - Sync FamZoo family finance transactions with YNAB budgets.

βœ… Version Consistency Action - GitHub composite action for keeping version strings aligned across JSON manifest files.

🍺 Homebrew Tap - Homebrew formulas for my CLIs and tools.

Elsewhere

Pinned Loading

  1. chief-of-staff-template chief-of-staff-template Public template

    Template for building Claude Code personal assistant plugins

    JavaScript 8

  2. claude-rename-agent claude-rename-agent Public

    AI-powered file renaming agent built with Claude Agent SDK

    Python 7 2

  3. homebridge-valor-fireplace homebridge-valor-fireplace Public

    Connects real fire with Homebridge.

    TypeScript

  4. Apple-PIM-Agent-Plugin Apple-PIM-Agent-Plugin Public

    Native macOS integration for Calendar, Reminders, and Contacts using EventKit and Contacts frameworks

    Swift 6 7