ChristianYang37 / LOLPingYourAI

# LOLPingYourAI
**Ping anywhere on your desktop. Your AI teammate gets the context.**
Hold ⌥ Option , drag, release on a signal. A League-style ping sends the spot you pointed at, the window it belongs to and what the signal means to your Codex, Claude or DSH teammate. It pings back, explains, works in that window, and stops the moment you call **Danger**.
**English** · 简体中文 · Download · ▶ Demo video · Architecture · Verification
 🔊 Full demo with sound (47 s): English · 中文 
## Why
Writing *"in the PDF on the right, second equation, why divide by √d?"* takes longer than the question itself. In League you'd ping it. LOLPingYourAI brings that to your desktop. One gesture hands your AI teammate three things at once:
- **Where:** a 512×512 square around the pointer, mapped back to real screen coordinates.
- **What:** the window it belongs to (app, title, bounds, a stable window ID).
- **Intent:** the signal's instruction, such as *explain*, *help finish this*, *stop*, or *check back in 30 minutes*.
The teammate is your existing Codex, Claude or DSH harness, with its own model, account, tools and memory. LOLPingYourAI adds no planner and no separate history service. It supplies the ping, a bundled skill and a narrow set of desktop tools.
 Point, don't describe The screenshot, window and intent arrive as structured data, not as text typed into whichever terminal has focus. 
 Recovers what you meant When a ping is ambiguous, the skill searches relevant sessions, project files and memory first. It asks you one focused question only if that isn't enough. 
 Interrupt any time Danger and Retreat revoke desktop actions at once. "Stopped" means the harness actually confirmed the cancellation. 
 It pings you back Replies show up on screen as reverse pings: on my way , all in , ? . They play one at a time, across displays, without moving your cursor. 
 Wards that come back Ward a window and the teammate looks again once, 30 minutes later. The visit survives restarts and sleep, and never runs twice. 
 Your wheel, your emotes Rebind slots and messages, import or crop emotes, or ask the teammate to draw one. Send a Weak! and it may talk back. 
## Teammate experience
- The app opens to a dedicated chat home with full replies, a fixed composer and task status. Use the Settings button for configuration; switching back keeps your draft.
- You can also type directly on the chat home to start a conversation. Text-only chat needs no desktop capture permissions; ping a region when you want to share visual context.
- A small reply card appears near the target without requesting focus. Expand, copy, ask a follow-up or answer a clarification there.
- Agent pings and emotes stay visible for **6 seconds** by default. Adjust **Signals & Sound → AI reply duration** (3–15 seconds). Replies wait for both the preceding visual and sound to finish; sounds play once.
- Live status uses LoL icons: **received → understanding → working / waiting for you → done**. A completion reaction pl