أداة superwhisper CLI: كيف تثبّتها، وكل أوامرها، وخادم MCP

بقلم · نُشر في

لدى superwhisper أداة سطر أوامر، تحمل الاسم superwhisper أيضًا، لأجهزة Mac. تبحث في سجل إملاءاتك المحلي وتصدّره، وتعدّل المفردات والاستبدالات، وتتحكم في التطبيق وهو يعمل: تبدأ التسجيل وتوقفه وتبدّل الوضع وتفرّغ ملفًا. ويمكنها أيضًا العمل كخادم MCP (Model Context Protocol)، فيستطيع مساعد ذكاء اصطناعي البحث في إملاءاتك وقراءتها.

أطوّر YapToText، وهو تطبيق إملاء آخر لأجهزة Mac، فاقرأ ما أقوله عن superwhisper مع وضع ذلك في الحسبان. كل معلومة عن superwhisper هنا مأخوذة من وثائقه نفسها، وقد قُرئت في 10 أكتوبر 2026. الصفحة هي CLI and MCP server.

تنزيل YapToText من Mac App Storeالتنزيل مجاني. بلا حساب وبلا ميزات مقفلة، لنظام macOS 14 أو أحدث على Mac مزوّد بشريحة Apple. الشفرة المصدرية على GitHub.

هذا الدليل بلغات أخرى: English, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文

ثبّتها

curl -fsSL https://superwhisper.com/install-cli.sh | bash

ما الذي يحدث: يثبّت السكربت أحدث إصدار في /usr/local/bin، أو في ~/.local/bin إن تعذرت الكتابة في الأول.

إذا لم تجد الصدفة (shell) الأمر superwhisper بعد ذلك، فأضف ~/.local/bin إلى PATH. تقول الوثائق إن الملفات التنفيذية ومجاميع التحقق منشورة في مستودع superultrainc/superwhisper-cli-release على GitHub، فيمكنك قراءة سكربت التثبيت قبل تشغيله. أداة CLI لنظام macOS فقط.

أوامر تقرأ سجلك

من صفحة وثائق superwhisper المسماة CLI and MCP server، وقد قُرئت في 10 أكتوبر 2026. هذه الأوامر تقرأ قاعدة البيانات المحلية نفسها التي يقرأها التطبيق، وتعمل على جهازك.

الأمرما يفعله
searchبحث نصي كامل في كل النصوص المفرّغة. يدعم AND وOR وNOT والعبارات المقتبسة ونجمة البادئة
historyيسرد النصوص المفرّغة الأخيرة. رشّحها باستخدام --mode و--since و--before
readيقرأ نصًا مفرّغًا واحدًا، وآخر نص إن لم تحدد معرّفًا (ID). الخيار --raw يعرض النص قبل معالجة الذكاء الاصطناعي
statsإحصاءات النصوص المفرّغة
modesيسرد الأوضاع المستخدمة في تسجيلاتك مع أعدادها
exportيصدّر كل شيء، الأقدم أولًا، بصيغة jsonl أو markdown
vocabيسرد مصطلحات المفردات أو يضيفها أو يزيلها
snippetsيسرد الاستبدالات أو يضبطها أو يزيلها، وهي أزواج From وTo نفسها الموجودة في Settings, Vocabulary
doctorمعلومات تشخيصية عن قاعدة البيانات، لتقارير الأخطاء
completionsيولّد إكمالات الأوامر للصدفة

أوامر تتحكم في التطبيق

من الصفحة نفسها. هذه الأوامر ترسل طلبًا إلى التطبيق العامل، فيجب أن يكون superwhisper مفتوحًا.

الأمرما يفعله
recordيبدّل حالة التسجيل بين التشغيل والإيقاف
startيبدأ التسجيل. لا يفعل شيئًا إن كان التسجيل جاريًا
stopيوقف التسجيل. لا يفعل شيئًا إن لم يكن التسجيل جاريًا
switchيبدّل الوضع النشط بالاسم أو بالمفتاح. من دون وسيط يسرد أوضاعك
settingsيفتح نافذة الإعدادات
transcribeيرسل ملفًا صوتيًا إلى التطبيق ليفرّغه. تفريغ الملفات يحتاج إلى Pro

الأوامر start وstop وswitch تجعل superwhisper قابلًا للتحكم بالسكربت من أي شيء يستطيع تشغيل أمر في الصدفة. ويشمل ذلك مشغّل التطبيقات أو أداة إعادة تعيين المفاتيح أو زرًا في واجهة مفتاح مساعد.

أمثلة

superwhisper search "quarterly report"
superwhisper history --since 2026-09-01 --mode Mail
superwhisper read --raw
superwhisper export -f markdown > dictations.md
superwhisper vocab add "Superwhisper"
superwhisper switch Message
superwhisper transcribe ~/Downloads/note.m4a

ما الذي يحدث: كل سطر هو أحد أمثلة الوثائق نفسها. تقبل معظم الأوامر أيضًا الخيار --json لإخراج يستطيع السكربت قراءته.

خادم MCP

superwhisper mcp

ما الذي يحدث: تتحدث أداة CLI بروتوكول MCP عبر stdio، وتتيح أدوات للبحث والسجل وقراءة التسجيلات والأوضاع والإحصاءات والمفردات والاستبدالات (snippets).

نقطة خصوصية من الوثائق: تعمل أداة CLI نفسها بالكامل على جهازك، لكن عندما يكون مساعد ذكاء اصطناعي متصلًا عبر MCP، تُرسل النصوص المفرّغة التي يستعلم عنها إلى ذلك المساعد وتُعالَج وفق إعدادات نموذجه وبياناته. صفحة خصوصية superwhisper تشرح الباقي.

YapToText وسطر الأوامر

ليس في YapToText أداة سطر أوامر ولا خادم MCP. هو تطبيق في شريط القوائم بمفتاح واحد. وصفحة History فيه تصدّر القائمة كلها كنص عادي أو Markdown، وهذا يغطي حالة التصدير من دون Terminal.

للتفريغ من Terminal من دون شراء أي شيء، whisper.cpp هو المحرك الذي بُني عليه YapToText. دليل Whisper المحلي فيه الأوامر، وصفحة MacWhisper CLI تشرح أداة تطبيق آخر للملفات والمجلدات.

تنزيل YapToText من Mac App Storeالتنزيل مجاني. بلا حساب وبلا ميزات مقفلة، لنظام macOS 14 أو أحدث على Mac مزوّد بشريحة Apple. الشفرة المصدرية على GitHub.

الخلاصة

  • التثبيت. سطر curl واحد، لنظام macOS فقط.
  • القراءة. search وhistory وread وstats وexport.
  • التحكم. record وstart وstop وswitch وtranscribe، والتطبيق مفتوح.
  • MCP. superwhisper mcp، عبر stdio.
  • الخصوصية. محلية، إلى أن يقرأ مساعد النصوص المفرّغة عبر MCP.

إذا أضاف superwhisper أوامر أو غيّر أسماءها، فافتح issue على GitHub وسأحدّث هذه الصفحة. أقرأ كل ما يصلني.

تنزيل YapToText من Mac App Storeالتنزيل مجاني. بلا حساب وبلا ميزات مقفلة، لنظام macOS 14 أو أحدث على Mac مزوّد بشريحة Apple. الشفرة المصدرية على GitHub.

عن الكاتب. اسمي Ryleigh Newman. أطوّر البرمجيات، وأجد صعوبة في الكتابة على لوحة المفاتيح، وأُملي كل يوم باستخدام YapToText، التطبيق الذي يتناوله هذا الموقع. هذه الصفحة مترجمة من الإنجليزية. واجهة التطبيق وبقية صفحات الموقع بالإنجليزية. المزيد عن المشروع، بالإنجليزية.

الأدلة

أدلة أخرى، بالإنجليزية

المصادر

أسئلة

هل لدى superwhisper أداة CLI؟

نعم، على macOS. يبحث الأمر superwhisper في سجلك ويصدّره، ويعدّل المفردات، ويتحكم في التطبيق العامل.

كيف أثبّت أداة CLI الخاصة بـ superwhisper؟

شغّل سكربت التثبيت من وثائقه باستخدام curl. يثبّت في /usr/local/bin، أو في ~/.local/bin إن تعذرت الكتابة في الأول.

هل أستطيع بدء تسجيل superwhisper من Terminal؟

نعم. الأوامر superwhisper start وstop وrecord تتحكم في التسجيل، ما دام التطبيق مفتوحًا.

هل لدى superwhisper خادم MCP؟

نعم. الأمر superwhisper mcp يشغّل أداة CLI كخادم MCP عبر stdio، مع أدوات للبحث والسجل والمفردات والاستبدالات (snippets).

هل تعمل أداة superwhisper CLI على Windows؟

لا. تقول وثائقه إن أداة CLI متاحة على macOS فقط.