Mudrik mascot — a friendly cyan owl

Mudrik · مدرك

Stop pasting screenshots into AI chats. Mudrik is an open-source Windows AI assistant that sees what you see — and answers, acts, or guides you step-by-step through any task.

Windows 10/11 MIT License

Watch the 10-second demo

Get started

Install

1

Install Node.js ≥ 20

The runtime Mudrik depends on. Get the LTS installer.

2

Install the AI runtime

One global npm package. Open PowerShell and run:

$ npm i -g opencode-ai
3

Run the Mudrik installer

Download the installer and double-click.

4

Add your AI model

Open ⚙ Settings → API Keys → paste a provider key (Anthropic, OpenAI, Kimi, DeepSeek…), then pick a model. Or authenticate via CLI:

$ opencode auth login

First launch triggers Windows SmartScreen — More info → Run anyway.

What it does

Five ways Mudrik goes beyond chat.

Sees any Windows app

Reads the full UI tree — buttons, fields, text, menus — through Windows UI Automation. No more pasting screenshots into a chat. Chromium apps get auto-screenshot fallback.

Acts on your desktop

Not just a chatbot — Mudrik types, pastes, clicks, fills, and presses keys in your app. Tell it what to do and it does it.

Auto-Guide

Mudrik walks you step-by-step through multi-step tasks. An owl cursor points to each target with instructions in a speech bubble.

Quick chat

Press Alt+X — the panel opens instantly without scanning your screen. For questions that don't need screen awareness, Mudrik is always one keystroke away.

Bring your own model

Anthropic, OpenAI, Google, Groq, DeepSeek, Ollama, Z.AI, OpenRouter — paste your key in the settings panel. No terminal auth dance.

Hotkeys

Press a key, get help.

Alt + Space Scans the window's UI tree at your cursor. Mudrik opens on the opposite side of your screen, ready to help.
Alt + X Quick chat — opens the panel instantly without capturing context. For questions that don't need screen awareness.
Esc Cancel: stops streaming or closes the panel.
Enter Send — Shift+Enter for a newline

All hotkeys are rebindable from the ⚙ menu.

Privacy & Security

Sandbox first.

Mudrik defaults closed. Shell commands and filesystem writes are off. UIA actions are allow-listed. Screen capture is automatic on Chromium apps; for any app, the Capture Context button captures a screenshot with a coordinate grid.

Read the full threat model in SECURITY.md →

Shell / PowerShell exec Off
Filesystem write Off
Windows UI Automation Allow-listed
Filesystem read Working dir only
Screen pixels Auto on Chromium · Capture Context for any app
About

Hi, I'm Abdullah Magdy.

A dev who got tired of pasting screenshots into AI Chats — so I built Mudrik on nights and weekends. It's open source; contributions and ideas are welcome 🤝