bgclick-rev

Featured

Reverse-engineer a macOS GUI automation app's background-click path and produce a Swift reproduction. Use only when the user provides a target .app and explicitly asks for IDA-backed background-click reverse engineering. Requires IDA Pro with IDA MCP attached.

AI & Automation 270 stars 3 forks Updated 3 days ago Apache-2.0

Install

View on GitHub

Quality Score: 89/100

Stars 20%
81
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Background-Click Reverse Engineering Use this skill only for research on a user-provided macOS `.app`. If IDA Pro or IDA MCP is unavailable, stop early and explain the blocker. Do not modify Uni-CLI source code from this skill; write research artifacts and reproduction code only after the binary evidence is gathered. ## Outputs Create a research bundle under `<workspace>/research/`: - `SHARED-CONTEXT.md` with target paths, bundle IDs, signing status, IDA MCP instance mapping, and priors to verify. - `findings/<phase-or-question>.md` for call-site maps and open questions. - `sub_<addr>-<label>.md` for every decompiled function used as evidence. - `frame-map.md` for Swift async task-frame offsets. - `FINAL-REPORT.md` with behavior spec, evidence table, reproduction diff, and VM test plan. If asked to build a reproduction, add: - `Sources/<Module>/BackgroundClicker.swift` - `EchoApp/main.swift` - `impl-research.md` with empirical VM runs. ## Priors To Verify Treat these as hypotheses until confirmed in the target binary: - Events are posted with `CGEvent.postToPid(_:)`. - The synthetic event starts as `NSEvent.mouseEvent(...)`, then uses `event.cgEvent`. - Explicit integer fields are `3` button, `7` subtype value `3`, `91` window under pointer, and `92` window that can handle the event. - Screen location is set, read back, translated by the target window origin, and written with `CGEventSetWindowLocation` resolved by `dlsym`. - Background targets receive `CGEventFlags...

Details

Author
olo-dot-io
Repository
olo-dot-io/Uni-CLI
Created
5 months ago
Last Updated
3 days ago
Language
TypeScript
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

reverse-engineer

Reverse engineer how an application implements a mechanism so it can be replicated. Use when the user asks how an app does something, how a feature or protocol works under the hood, or wants design notes to reimplement a behavior (download chunking, retry, sync, auth flow, caching) from a repository, an installed build, or a closed-source app known only by name.

3 Updated 2 days ago
Firzus
AI & Automation Listed

macos-computer-use

Drive the macOS desktop in the background — screenshots, mouse, keyboard, scroll, drag — without stealing the user's cursor, keyboard focus, or Space. Works with any tool-capable model. Load this skill whenever the `computer_use` tool is available.

0 Updated 1 months ago
988hj7tczd-oss
Code & Development Listed

debug-kit

Cross-platform app debug and testing skill for Codex and Claude Code. Build, launch, screenshot, tap, type, inspect, and monitor applications across 9 platforms: Electron, iOS, macOS, Web, Flutter, React Native, Android, Tauri, Chrome Extension. Auto-detects project type from package.json, pubspec.yaml, xcodeproj, build.gradle, src-tauri/, manifest.json (MV3). TRIGGER when: user says "run the app", "test the app", "take screenshot", "tap button", "debug", "launch", "check if it works", "hot reload", "monitor console", "check logs", or is working on ANY app project and wants to build, run, test, or verify changes. Also trigger when the user asks to interact with a running app, inspect UI elements, check performance, run accessibility audits, or simulate user input.

0 Updated 1 weeks ago
dxiongya