Skip to content
Back to search

deskbridge

Local MCP server for Windows that lets AI agents read and act in desktop apps without moving your mouse or taking focus.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/omarkhan2217--deskbridge/badge.svg)](/listings/omarkhan2217--deskbridge)

HTML

<a href="/listings/omarkhan2217--deskbridge"><img src="/api/listings/omarkhan2217--deskbridge/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 51 lines
  1. # Deskbridge
  2. A local MCP server for Windows that lets AI agents read and act in desktop apps without moving your mouse, typing into the window you are using, or taking focus.
  3. **Status:** early development. Not ready for use. The plan is in [docs/plan.md](docs/plan.md) and progress by phase is in [docs/phases/](docs/phases/README.md).
  4. Taking over or joining the project: start with [docs/handover.md](docs/handover.md).
  5. ## The rule it is built around
  6. Your AI works in your apps while you keep working. Deskbridge reaches each app its own way first (its COM interface, an extension, its command line, its own MCP server), then through UI Automation patterns, then through messages sent to one window. It never moves the mouse and never types into the window you are using. A test checks the cursor position, the foreground window and the keyboard focus around every action.
  7. Every app has its own permission (Off, Read or Act), changes are confirmed in a small window that does not take focus, and every call is written to a local audit log.
  8. ## What works today
  9. 25 tools. Every call goes through the app's permission, a confirmation when the call changes something, and one line in the audit log.
  10. | Group | Tools |
  11. |---|---|
  12. | Windows and controls | `windows_list`, `windows_describe`, `ui_read`, `ui_tree`, `ui_find`, `ui_press`, `ui_toggle`, `ui_select`, `ui_set_text`, `ui_scroll` |
  13. | Apps | `apps_list_installed`, `apps_list_running`, `apps_launch`, `settings_open` |
  14. | Files | `files_search`, `files_read`, `files_write`, `files_move`, `files_delete` (to the Recycle Bin) |
  15. | Clipboard, media and notifications | `clipboard_read`, `clipboard_write`, `media_now_playing`, `media_control`, `volume_set`, `notify_show` |
  16. - Apps start at Read. The settings window (from the tray icon) sets each app to Off, Read or Act, and lists the approved clients and remembered grants.
  17. - Each new MCP client is approved once. Deleting, sending and similar buttons ask every time.
  18. - Ctrl+Alt+Shift+P pauses or resumes Deskbridge from anywhere.
  19. - The UI tools refuse Chromium and Electron apps (browsers, VS Code, Slack, Discord) until their adapters arrive in later phases.
  20. Any MCP client starts it as `deskbridge.exe mcp`.
  21. ## Build and test
  22. Requires Windows 10 or 11 and the .NET 10 SDK or later.
  23. ```powershell
  24. dotnet build Deskbridge.slnx
  25. dotnet test --project tests/Deskbridge.Tests # unit tests
  26. dotnet test --project tests/Deskbridge.E2E # end-to-end tests: they open and close real windows
  27. ```
  28. `scripts/publish-broker.ps1` publishes the broker (ReadyToRun) to `artifacts/broker` and the relay (Native AOT) to `artifacts/relay`:
  29. ```powershell
  30. powershell -ExecutionPolicy Bypass -File scripts/publish-broker.ps1
  31. ```
  32. ## Licence and signing
  33. MIT, see [LICENSE](LICENSE). Code signing: see [docs/code-signing-policy.md](docs/code-signing-policy.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.