Documentation

Getting Started

1

Download the Desktop App

Download MyYaad for macOS from our download page. Install it like any other app — drag to Applications and launch.

2

Create Your First Vault Entry

Open MyYaad and click "Add Entry". Enter a piece of personal data you commonly share with AI — your name, company, or email address. Choose a shadow type (name, email, company, etc.) and save.

3

Install the Browser Extension

Install the MyYaad extension for Chrome (also works in Brave, Edge, and Arc). The extension will automatically connect to your desktop app.

4

Chat with any supported AI — protected

Open any supported AI chatbot — ChatGPT, Claude, Gemini, or DeepSeek. Type a prompt that includes data you’ve added to your vault. MyYaad automatically detects which provider you’re on, replaces your real data with a provider-specific shadow value, and restores the real data when the AI responds. Try it on multiple providers to see different shadow values for the same real data.

5

Check the Audit Log

Open MyYaad and check the audit log to see exactly what was shadowed, which provider received which shadow, and when.

FAQ

Frequently Asked Questions

Is my data really safe?+

Your data never leaves your device. The vault is a folder of human-readable Markdown and JSON files on your computer — you can open it in any text editor and see exactly what’s stored. Encryption keys live in your OS keychain (macOS Keychain, Windows Credential Manager). The extension communicates only with localhost:3000 — a loopback address that physically cannot reach the internet. We don’t operate any servers that receive your data.

What if an AI provider changes their UI?+

Each supported provider (ChatGPT, Claude, Gemini, DeepSeek) has its own dedicated adapter with resilient selectors and fallback strategies. If any provider makes a breaking change, we can push a selector update without a full extension release. The extension also detects when selectors fail and degrades gracefully — your prompt goes through unshadowed rather than being blocked.

Can I see what shadows were used?+

Yes. The audit log records every shadow operation with a hash-chained entry — which fields were matched, which shadows were used, and which provider received them. The log is stored locally at ~/.myyaad/logs/audit.jsonl and can be exported. Before each send, a floating preview panel shows you the exact before/after for every field.

What happens if the desktop app isn’t running?+

The extension detects the disconnect within seconds and shows a clear "Desktop app not running" message in the popup with a Retry button. Your prompts are sent normally without shadow protection — the extension never blocks your workflow. When the desktop app starts, the extension reconnects automatically.

Which AI chatbots does MyYaad support?+

MyYaad currently supports four AI chatbot providers: ChatGPT by OpenAI (chat.openai.com and chatgpt.com), Claude by Anthropic (claude.ai), Gemini by Google (gemini.google.com), and DeepSeek (chat.deepseek.com). Each provider gets a different shadow value for the same real data — so even if multiple providers were breached simultaneously, they couldn’t correlate your information across services. More providers will be added in future updates.

Does each provider see different shadow values?+

Yes. This is a core security feature called provider-specific salting. When you add "John Smith" to your vault, ChatGPT might see "Ethan Anderson", Claude sees "Sofia Rivera", Gemini sees "Marcus Lee", and DeepSeek sees "Aisha Brown". The shadows are generated using HMAC-SHA256 with a unique salt per provider — they are mathematically different and cannot be correlated.

Do I need to configure anything per provider?+

No. MyYaad automatically detects which AI chatbot you’re using and applies the correct adapter. Shadow protection activates automatically on supported sites. You don’t need to select a provider or change any settings when switching between ChatGPT, Claude, Gemini, and DeepSeek.

What about other AI chatbots (Grok, Perplexity, HuggingChat)?+

Additional providers are on our roadmap. The adapter architecture makes it straightforward to add new providers. If there’s a provider you’d like supported, let us know via our support page.

Does MyYaad work with ChatGPT’s new domain (chatgpt.com)?+

Yes. MyYaad supports both chat.openai.com and chatgpt.com. The extension automatically detects either domain and applies shadow protection.

Can't find an answer? Contact support