English Français العربية

Desktop Steward

السجل الرسمي الذكاء الاصطناعي والوكلاء

Your own computer's files from ChatGPT or Claude: folder rules, confirmations and undo.

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Desktop Steward؟

  • Rules in plain words. You choose which folders Claude may read and which it may change. Everything else is invisible to it.
  • Asks before anything risky. Deleting, replacing a file, or moving many files opens a confirmation window on your computer. The model cannot answer it.
  • Undo for 7 days. Old versions are kept before a change; deleted files wait in a holding area; undo brings them back.
  • Off limits, always. Passwords, keys, browser data, mail, system folders, and anything that runs on double-click. No terminal, no network, no telemetry.
  • Ready-made tasks in the chat's + menu: tidy Downloads, find duplicate photos, free disk space, tidy the Desktop, find documents by topic, rename photos by date.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http desktop-steward 'https://relay.desktopsteward.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "desktop-steward": {
            "type": "http",
            "url": "https://relay.desktopsteward.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Desktop Steward
  2. What it does
  3. Install
  4. Tools
  5. Public core and the official bundle
  6. Build from source
  7. Configuration
  8. Privacy
  9. License

Desktop Steward

Safe hands for Claude on your computer. A free extension for Claude Desktop that lets Claude tidy, find and organize your files with plain folder rules, a confirmation window before anything risky, and undo for every change.

Website and download: https://desktopsteward.com

What it does

  • Rules in plain words. You choose which folders Claude may read and which it may change. Everything else is invisible to it.
  • Asks before anything risky. Deleting, replacing a file, or moving many files opens a confirmation window on your computer. The model cannot answer it.
  • Undo for 7 days. Old versions are kept before a change; deleted files wait in a holding area; undo brings them back.
  • Off limits, always. Passwords, keys, browser data, mail, system folders, and anything that runs on double-click. No terminal, no network, no telemetry.
  • Ready-made tasks in the chat's + menu: tidy Downloads, find duplicate photos, free disk space, tidy the Desktop, find documents by topic, rename photos by date.

Read SECURITY.md for the threat model, including what it does not protect against.

Install

Download the .mcpb for your platform from the website or the Releases page and double-click it. Claude Desktop installs it like a browser extension. Press Save; the defaults are sensible.

Tools

list_folder, read_file (text, PDF, DOCX, images), write_file, edit_file, create_folder, move_files, delete_files, search_files, file_info, disk_usage, find_duplicates, undo, history, show_rules.

Public core and the official bundle

This repository is the core of Desktop Steward: the file tools, the folder rules, the confirmation step and undo. Everything that touches your files is here and can be audited. The official bundle from desktopsteward.com is built from this core plus extras that are not in this repository: a local panel with Undo buttons, images-to-PDF, zip/unzip, opening files, remote access from the phone (Pro). The extras use the same rules, confirmations and undo as the core.

Build from source

npm install
npm test            # builds and runs the test suite
npm run bundle      # builds build/desktop-steward-<version>-<platform>.mcpb for this platform

Node.js 22 or newer. The bundle is platform-specific because the bundled search binary (ripgrep) is.

Configuration

Settings live in the Claude Desktop extension panel, or in ~/.desktop-steward/config.json:

KeyDefaultMeaning
readFoldersDesktop, Documents, Downloads, PicturesFolders Claude may read and search
writeFoldersDocuments/AI Workspace, DownloadsFolders Claude may change
askBeforeDeletetrueConfirmation window before deleting
confirmThreshold10Moving more items than this asks first
keepHistoryDays7How long undo copies and deleted files are kept

Privacy

Desktop Steward reads only the folders you opened to it and keeps copies of changed or deleted files for undo in ~/.desktop-steward on your own computer (7 days by default). The core sends nothing anywhere and has no telemetry. Full policy: Privacy · Security model: Security · Contact: hello@desktopsteward.com

License

MIT. Copyright ED&EU LTD. Desktop Steward is not affiliated with Anthropic.

الأسئلة الشائعة

ما هو Desktop Steward؟

Your own computer's files from ChatGPT or Claude: folder rules, confirmations and undo.

كيف أثبّت Desktop Steward؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http desktop-steward 'https://relay.desktopsteward.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Desktop Steward إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Desktop Steward مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Desktop Steward؟

ينشره desktopsteward. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.