A small, local attention layer for coding agents.
Desk Beacon places a calm, actionable prompt on your desktop when an agent genuinely needs you: connect a device, approve a decision, or answer one short question. Reply in the card, then let the agent continue.
Windows · Python 3 · local only · no dependencies
- Keeps attention requests visible on the screen where you work.
- Gives agents a small reply channel without ending the task.
- Stays local: the API listens only on
127.0.0.1. - Adapts to your display, theme, font size, corner preference, and notification sound.
& .\Start-DeskBeacon.ps1The panel launches without a console window. Use the gear icon to adjust appearance, placement, multiple-alert behaviour, and sound.
| Need | Desk Beacon behaviour |
|---|---|
| A short decision | Show a question and accept a one-line reply. |
| Acknowledgement only | Show “I’ve seen this” to close the reminder. |
| Several requests | Show the current count or expand every pending card. |
| Different desks | Remember a dragged position or anchor to any display corner. |
| Different environments | Use a built-in generated sound, silence, or a custom WAV. |
& .\plugin\plugins\desk-beacon\scripts\notify.ps1 `
-Session 'Device flash' `
-Title 'Connect the test device' `
-Detail 'The build is ready and needs the USB target.' `
-Question 'Is the device connected?' `
-Level warningThe command returns an ID. Check a reply later:
& .\plugin\plugins\desk-beacon\scripts\get-replies.ps1 -Id '<id>'For the full walkthrough, see Usage.
This repository includes a local Codex marketplace. From the repository root:
codex plugin marketplace add .\plugin
codex plugin add desk-beacon@desk-beacon-localOpen a new Codex task afterwards so it can load the skill.
Desk Beacon is a local desktop utility. It does not use a cloud service or send reminder content outside your machine. Do not expose its loopback port or place secrets in reminder text.