.TH MISE 1
.SH "نام (NAME)"
mise \- ابزارهای توسعه، متغیرهای محیطی و وظایف در یک رابط خط فرمان (CLI)
.SH "خلاصه دستور (SYNOPSIS)"
\fBmise\fR [OPTIONS] [<TASK>] [<TASK_ARGS>] ... [<TASK_ARGS_LAST>] ... [COMMAND]
.SH "توضیحات (DESCRIPTION)"
دستور mise محیط توسعهٔ شما را پیش از اجرای هر دستور آماده می‌کند. https://github.com/jdx/mise
.PP
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-c, \-\-continue\-on\-error\fR
ادامه دادن به اجرای وظایف حتی در صورت شکست خوردن یکی از آن‌ها
.TP
\fB\-C, \-\-cd\fR \fI<DIR>\fR
تغییر دایرکتوری پیش از اجرای دستور
.TP
\fB\-E, \-\-env\fR \fI<ENV>\fR
تنظیم محیط برای بارگذاری `mise.<ENV>.toml`
.TP
\fB\-f, \-\-force\fR
اجبار در انجام عملیات
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارهای هم‌روند جهت اجرا؛ مقادیر کمتر از ۱ برابر ۱ در نظر گرفته می‌شوند [پیش‌فرض: 8]
.RS
\fIمحیط: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-n, \-\-dry\-run\fR
اجرای آزمایشی، در عمل هیچ کاری انجام نمی‌دهد
.TP
\fB\-P, \-\-profile\fR \fI<PROFILE>\fR
تنظیم نمایه (محیط)
.TP
\fB\-q, \-\-quiet\fR
پنهان‌سازی پیام‌های غیرخطا
.RS
\fIمحیط: \fR\fBMISE_QUIET\fR
.RE
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
.TP
\fB\-t, \-\-tool\fR \fI<TOOL@VERSION>\fR
ابزار(ها) جهت اجرا علاوه بر موارد موجود در فایل‌های mise.toml، مانند: node@20 python@3.10
.TP
\fB\-v, \-\-verbose\fR
نمایش خروجی بیشتر (برای جزئیات بیشتر از \-vv استفاده کنید)
.TP
\fB\-V, \-\-version\fR
.TP
\fB\-y, \-\-yes\fR
پاسخ مثبت (yes) به تمام اعلان‌های تأیید
.TP
\fB\-\-debug\fR
تنظیم سطح گزارش‌گیری روی debug
.TP
\fB\-\-log\-level\fR \fI<LEVEL>\fR
.TP
\fB\-\-no\-config\fR
هیچ فایل پیکربندی‌ای بارگذاری نشود

همچنین می‌توان از `MISE_NO_CONFIG=1` استفاده کرد
.TP
\fB\-\-no\-env\fR
متغیرهای محیطی از فایل‌های پیکربندی بارگذاری نشوند

همچنین می‌توان از `MISE_NO_ENV=1` استفاده کرد
.TP
\fB\-\-no\-hooks\fR
قلاب‌ها (hooks) از فایل‌های پیکربندی اجرا نشوند

همچنین می‌توان از `MISE_NO_HOOKS=1` استفاده کرد
.TP
\fB\-\-no\-timings\fR
پنهان‌سازی زمان سپری‌شده پس از اتمام هر وظیفه

پیش‌فرضِ همیشه پنهان با `MISE_TASK_TIMINGS=0`
.TP
\fB\-\-output\fR \fI<OUTPUT>\fR
.TP
\fB\-\-raw\fR
خواندن/نوشتن مستقیم روی stdin/stdout/stderr به جای خط به خط
.TP
\fB\-\-locked\fR
الزام به وجود نشانی‌های وب (URLs) فایل قفل هنگام نصب

در صورتی که ابزارها آدرس‌های از پیش تفکیک‌شده در فایل قفل برای پلتفرم فعلی نداشته باشند، با شکست مواجه می‌شود.
این کار مانع از فراخوانی API به GitHub، رجیستری aqua و غیره می‌شود.
همچنین می‌تواند از طریق MISE_LOCKED=1 یا settings.locked=true فعال شود
.TP
\fB\-\-silent\fR
پنهان‌سازی تمام خروجی‌های وظایف و پیام‌های غیرخطای mise
.TP
\fB\-\-timings\fR
نمایش زمان سپری‌شده پس از اتمام هر وظیفه

پیش‌فرضِ همیشه نمایان با `MISE_TASK_TIMINGS=1`
.TP
\fB\-\-trace\fR
تنظیم سطح گزارش‌گیری روی trace
.TP
\fB\-h, \-\-help\fR
چاپ راهنما.SH "آرگومان‌ها (ARGUMENTS)"
.TP
\fB<TASK>\fR
تسک (وظیفه) برای اجرا.

کوتاه‌نوشتی برای `mise tasks run <TASK>`.
.TP
\fB<TASK_ARGS>\fR
آرگومان‌های تسک
.SH "دستورها (COMMANDS)"
.TP
\fBactivate\fR
مقداردهی اولیه mise در نشست فعلی شل
.TP
\fBtool\-alias\fR
مدیریت نام‌های مستعار (alias) نسخه ابزار.
.RS
\fIنام‌های مستعار: \fRalias, aliases
.RE
.TP
\fBtool\-alias get\fR
نمایش یک نام مستعار برای یک ابزار
.TP
\fBtool\-alias ls\fR
فهرست کردن نام‌های مستعار نسخه‌های ابزار
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBtool\-alias set\fR
افزودن یا به‌روزرسانی یک نام مستعار برای یک ابزار/backend
.RS
\fIنام‌های مستعار: \fRadd, create
.RE
.TP
\fBtool\-alias unset\fR
پاک کردن یک نام مستعار برای یک ابزار/backend
.RS
\fIنام‌های مستعار: \fRrm, remove, delete, del
.RE
.TP
\fBbackends\fR
مدیریت backendها
.RS
\fIنام‌های مستعار: \fRb, backend, backend\-list
.RE
.TP
\fBbackends ls\fR
فهرست کردن backendهای توکار
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBbin\-paths\fR
فهرست کردن تمام مسیرهای اجرایی (bin) فعال محیط زمان اجرا
.TP
\fBbootstrap\fR
راه‌اندازی سیستم برای پیکربندی فعلی تنها با یک دستور
.RS
\fIنام‌های مستعار: \fRbs
.RE
.TP
\fBbootstrap accounts\fR
مدیریت کاربران و گروه‌های لینوکس از `[bootstrap.users]` و `[bootstrap.groups]`
.TP
\fBbootstrap accounts apply\fR
اعمال کاربران و گروه‌های پیکربندی‌شده لینوکس
.TP
\fBbootstrap accounts status\fR
نمایش وضعیت کاربران و گروه‌های پیکربندی‌شده لینوکس
.TP
\fBbootstrap compose\fR
مدیریت پروژه‌های Docker Compose از `[bootstrap.compose]`
.TP
\fBbootstrap compose apply\fR
اعمال وضعیت پیکربندی‌شده پروژه‌های Docker Compose
.TP
\fBbootstrap compose status\fR
نمایش وضعیت پیکربندی‌شده پروژه‌های Docker Compose
.TP
\fBbootstrap dotfiles\fR
مدیریت دات‌فایل‌ها (dotfiles) از `[dotfiles]`
.TP
\fBbootstrap dotfiles add\fR
افزودن یا به‌روزرسانی دات‌فایل‌ها در `[dotfiles]`
.TP
\fBbootstrap dotfiles apply\fR
اعمال دات‌فایل‌ها از `[dotfiles]`
.TP
\fBbootstrap dotfiles diff\fR
نمایش تغییرات مورد نیاز برای اعمال دات‌فایل‌ها از `[dotfiles]`
.TP
\fBbootstrap dotfiles edit\fR
ویرایش منبع دات‌فایل مدیریت‌شده
.TP
\fBbootstrap dotfiles status\fR
نمایش وضعیت دات‌فایل‌ها از `[dotfiles]`
.RS
\fIنام‌های مستعار: \fRls
.RE
.TP
\fBbootstrap dotfiles unapply\fR
حذف دات‌فایل‌های اعمال‌شده از `[dotfiles]`
.TP
\fBbootstrap files\fR
مدیریت فایل‌ها و دایرکتوری‌های دارای دسترسی ویژه از `[bootstrap.files]` و `[bootstrap.directories]`
.TP
\fBbootstrap files apply\fR
اعمال فایل‌ها و دایرکتوری‌های دارای دسترسی ویژه پیکربندی‌شده
.TP
\fBbootstrap files status\fR
نمایش وضعیت فایل‌ها و دایرکتوری‌های دارای دسترسی ویژه پیکربندی‌شده
.TP
\fBbootstrap firewall\fR
مدیریت فایروال میزبان لینوکس از `[bootstrap.linux.firewall]`
.TP
\fBbootstrap firewall apply\fR
اعمال فایروال پیکربندی‌شده میزبان لینوکس
.TP
\fBbootstrap firewall status\fR
نمایش وضعیت فایروال پیکربندی‌شده میزبان لینوکس
.TP
\fBbootstrap linux\fR
مدیریت پیکربندی راه‌اندازی لینوکس از `[bootstrap.linux]`
.TP
\fBbootstrap linux systemd\-units\fR
مدیریت سرویس‌های کاربری systemd از `[bootstrap.linux.systemd.units]`
.RS
\fIنام‌های مستعار: \fRsystemd
.RE
.TP
\fBbootstrap linux systemd\-units apply\fR
.TP
\fBbootstrap linux systemd\-units status\fR
.TP
\fBbootstrap macos\fR
مدیریت پیکربندی راه‌اندازی macOS از `[bootstrap.macos]`
.TP
\fBbootstrap macos defaults\fR
مدیریت defaults در macOS از `[bootstrap.macos.defaults]`
.TP
\fBbootstrap macos defaults apply\fR
.TP
\fBbootstrap macos defaults status\fR
.TP
\fBbootstrap macos launchd\-agents\fR
مدیریت LaunchAgents در macOS از `[bootstrap.macos.launchd.agents]`
.RS
\fIنام‌های مستعار: \fRlaunchd
.RE
.TP
\fBbootstrap macos launchd\-agents apply\fR
.TP
\fBbootstrap macos launchd\-agents status\fR
.TP
\fBbootstrap mise\-shell\-activate\fR
مدیریت فعال‌سازی شل mise از `[bootstrap.mise_shell_activate]`
.RS
\fIنام‌های مستعار: \fRshell
.RE
.TP
\fBbootstrap mise\-shell\-activate apply\fR
.TP
\fBbootstrap mise\-shell\-activate status\fR
.TP
\fBbootstrap packages\fR
مدیریت بسته‌های سیستم راه‌اندازی از `[bootstrap.packages]`
.TP
\fBbootstrap packages apply\fR
اعمال بسته‌های سیستمی از `[bootstrap.packages]`
.RS
\fIنام‌های مستعار: \fRi, install
.RE
.TP
\fBbootstrap packages brew\fR
مدیریت مخازن tap در Homebrew استفاده‌شده توسط بسته‌های راه‌اندازی
.TP
\fBbootstrap packages brew tap\fR
افزودن نشانی اینترنتی Homebrew tap به [bootstrap.brew.taps]
.TP
\fBbootstrap packages brew untap\fR
حذف نشانی‌های اینترنتی Homebrew tap از [bootstrap.brew.taps]
.RS
\fIنام‌های مستعار: \fRremove, rm
.RE.TP
\fBbootstrap packages import\fR
وارد کردن بسته‌های سیستمی نصب‌شده به `[bootstrap.packages]`
.TP
\fBbootstrap packages prune\fR
پاکسازی بسته‌های سیستمی نصب‌شده که دیگر در `[bootstrap.packages]` تعریف نشده‌اند
.TP
\fBbootstrap packages status\fR
نمایش وضعیت بسته‌های سیستمی از `[bootstrap.packages]`
.RS
\fIنام‌های مستعار: \fRls
.RE
.TP
\fBbootstrap packages upgrade\fR
ارتقای بسته‌های bootstrap نصب‌شده از `[bootstrap.packages]`
.RS
\fIنام‌های مستعار: \fRup
.RE
.TP
\fBbootstrap packages use\fR
افزودن بسته‌های bootstrap به [bootstrap.packages] و نصب آن‌ها
.RS
\fIنام‌های مستعار: \fRu
.RE
.TP
\fBbootstrap plan\fR
نمایش تغییراتی که منابع تعریفی bootstrap اعمال خواهند کرد
.TP
\fBbootstrap plugins\fR
مدیریت افزونه‌های مدیر بستهٔ تعریف‌شده در `[bootstrap.plugins]`
.TP
\fBbootstrap plugins apply\fR
.TP
\fBbootstrap plugins status\fR
.TP
\fBbootstrap remote\fR
راه‌اندازی اولیه (bootstrap) یک یا چند ماشین از طریق OpenSSH
.TP
\fBbootstrap repos\fR
مدیریت دریافت مخازن git از `[bootstrap.repos]`
.TP
\fBbootstrap repos apply\fR
.TP
\fBbootstrap repos exec\fR
.TP
\fBbootstrap repos status\fR
.TP
\fBbootstrap repos update\fR
.TP
\fBbootstrap secrets\fR
بررسی ورودی‌های محرمانهٔ bootstrap بدون فاش کردن مقادیر آن‌ها
.TP
\fBbootstrap secrets status\fR
نمایش در دسترس بودن ورودی‌های محرمانهٔ تعریف‌شده برای bootstrap
.TP
\fBbootstrap services\fR
مدیریت سرویس‌های سیستمی لینوکس از `[bootstrap.services]`
.TP
\fBbootstrap services apply\fR
اعمال وضعیت پیکربندی‌شدهٔ سرویس‌های سیستمی لینوکس
.TP
\fBbootstrap services status\fR
نمایش وضعیت پیکربندی‌شدهٔ سرویس‌های سیستمی لینوکس
.TP
\fBbootstrap status\fR
نمایش وضعیت تجمیعی bootstrap
.RS
\fIنام‌های مستعار: \fRls
.RE
.TP
\fBbootstrap user\fR
مدیریت تنظیمات bootstrap کاربر فعلی از `[bootstrap.user]`
.TP
\fBbootstrap user apply\fR
.TP
\fBbootstrap user status\fR
.TP
\fBcache\fR
مدیریت حافظهٔ پنهان mise
.TP
\fBcache clear\fR
حذف تمام فایل‌های حافظهٔ پنهان در mise
.RS
\fIنام‌های مستعار: \fRc, clean
.RE
.TP
\fBcache path\fR
نمایش مسیر دایرکتوری حافظهٔ پنهان
.RS
\fIنام‌های مستعار: \fRdir
.RE
.TP
\fBcache prune\fR
حذف فایل‌های کهنهٔ حافظهٔ پنهان mise
.RS
\fIنام‌های مستعار: \fRp
.RE
.TP
\fBcache task\fR
بررسی مدخل‌های حافظهٔ پنهان خروجی برای یک تسک
.TP
\fBcompletion\fR
تولید تکمیل خودکار پوسته
.RS
\fIنام‌های مستعار: \fRcomplete, completions
.RE
.TP
\fBconfig\fR
مدیریت فایل‌های پیکربندی
.RS
\fIنام‌های مستعار: \fRcfg, toml
.RE
.TP
\fBconfig get\fR
نمایش مقدار یک تنظیم در فایل mise.toml
.TP
\fBconfig ls\fR
فهرست کردن فایل‌های پیکربندی در حال استفاده
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBconfig set\fR
تنظیم مقدار یک مشخصه در فایل mise.toml
.TP
\fBdeactivate\fR
غیرفعال‌سازی mise برای نشست فعلی پوسته
.TP
\fBdoctor\fR
بررسی نصب mise برای یافتن مشکلات احتمالی
.RS
\fIنام‌های مستعار: \fRdr
.RE
.TP
\fBdoctor path\fR
چاپ مدخل‌های فعلی PATH که توسط mise ارائه شده‌اند
.RS
\fIنام‌های مستعار: \fRpaths
.RE
.TP
\fBen\fR
راه‌اندازی یک پوسته جدید با محیط mise ایجادشده از روی پیکربندی فعلی
.TP
\fBenv\fR
برون‌ریزی متغیرهای محیطی برای یک بار فعال‌سازی mise
.RS
\fIنام‌های مستعار: \fRe
.RE
.TP
\fBexec\fR
اجرای یک دستور با ابزار(های) تعیین‌شده
.RS
\fIنام‌های مستعار: \fRx
.RE
.TP
\fBfmt\fR
قالب‌بندی فایل mise.toml
.TP
\fBgenerate\fR
تولید فایل‌ها برای ابزارها و سرویس‌های گوناگون
.RS
\fIنام‌های مستعار: \fRgen, g
.RE
.TP
\fBgenerate config\fR
تولید یک فایل mise.toml
.TP
\fBgenerate devcontainer\fR
تولید یک devcontainer برای اجرای mise
.TP
\fBgenerate git\-pre\-commit\fR
تولید یک قلاب (hook) برای git pre\-commit
.RS
\fIنام‌های مستعار: \fRpre\-commit
.RE
.TP
\fBgenerate github\-action\fR
تولید یک فایل گردش کار (workflow) برای GitHub Action
.TP
\fBgenerate install\-script\fR
تولید یک اسکریپت برای بارگیری و اجرای mise.TP
\fBgenerate task\-docs\fR
تولید مستندات برای وظایف در یک پروژه
.TP
\fBgenerate task\-stubs\fR
ایجاد shims برای اجرای وظایف mise
.TP
\fBgenerate tool\-stub\fR
تولید یک tool stub برای ابزارهای مبتنی بر HTTP
.TP
\fBimplode\fR
حذف CLI ابزار mise و تمامی داده‌های مرتبط
.TP
\fBedit\fR
ویرایش تعاملی mise.toml
.TP
\fBinstall\fR
نصب نسخه یک ابزار
.RS
\fIنام‌های مستعار: \fRi
.RE
.TP
\fBinstall\-into\fR
نصب نسخه یک ابزار در یک مسیر مشخص
.TP
\fBlatest\fR
دریافت آخرین نسخه موجود برای یک افزونه
.TP
\fBlink\fR
ایجاد پیوند نمادین (symlink) از نسخه یک ابزار در mise
.RS
\fIنام‌های مستعار: \fRln
.RE
.TP
\fBlock\fR
به‌روزرسانی چک‌سام‌ها و URLهای lockfile برای تمام پلتفرم‌های مشخص‌شده
.TP
\fBls\fR
فهرست کردن نسخه‌های نصب‌شده و فعال ابزارها
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBls\-remote\fR
فهرست کردن نسخه‌های runtime موجود برای نصب.
.RS
\fIنام‌های مستعار: \fRlist\-all, list\-remote
.RE
.TP
\fBmcp\fR
اجرای سرور Model Context Protocol (MCP)
.TP
\fBoci\fR
[آزمایشی] ساخت ایمیج‌های کانتینر OCI از یک mise.toml
.TP
\fBoci build\fR
[آزمایشی] ساخت یک ایمیج OCI از mise.toml فعلی
.TP
\fBoci push\fR
[آزمایشی] ساخت یک ایمیج OCI و ارسال (push) آن به یک رجیستری
.TP
\fBoci run\fR
[آزمایشی] ساخت یک ایمیج OCI از mise.toml فعلی و اجرای یک دستور در آن
.TP
\fBoutdated\fR
نمایش نسخه‌های قدیمی ابزارها
.TP
\fBpatrons\fR
نمایش افرادی که به عنوان حامیان سطح Patron از mise پشتیبانی می‌کنند
.TP
\fBplugins\fR
مدیریت افزونه‌ها
.RS
\fIنام‌های مستعار: \fRp, plugin, plugin\-list
.RE
.TP
\fBplugins install\fR
نصب یک افزونه
.RS
\fIنام‌های مستعار: \fRi, a, add
.RE
.TP
\fBplugins link\fR
ایجاد پیوند نمادین (symlink) از یک افزونه در mise
.RS
\fIنام‌های مستعار: \fRln
.RE
.TP
\fBplugins ls\fR
فهرست کردن افزونه‌های نصب‌شده
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBplugins ls\-remote\fR

.RS
\fIنام‌های مستعار: \fRlist\-remote, list\-all
.RE
.TP
\fBplugins uninstall\fR
حذف یک افزونه
.RS
\fIنام‌های مستعار: \fRremove, rm
.RE
.TP
\fBplugins update\fR
به‌روزرسانی یک افزونه به آخرین نسخه
.RS
\fIنام‌های مستعار: \fRup, upgrade
.RE
.TP
\fBdeps\fR
[آزمایشی] مدیریت وابستگی‌های پروژه
.RS
\fIنام‌های مستعار: \fRdep, prepare
.RE
.TP
\fBdeps add\fR
افزودن یک وابستگی
.TP
\fBdeps install\fR
نصب تمامی وابستگی‌های پروژه
.TP
\fBdeps remove\fR
حذف یک وابستگی
.TP
\fBprune\fR
حذف نسخه‌های استفاده‌نشده ابزارها
.TP
\fBregistry\fR
فهرست کردن ابزارهای در دسترس برای نصب
.TP
\fBreshim\fR
ایجاد shims جدید بر اساس مسیرهای bin از ابزارهای نصب‌شده فعلی.
.TP
\fBrun\fR
اجرای وظیفه(ها)
.RS
\fIنام‌های مستعار: \fRr
.RE
.TP
\fBsearch\fR
جستجو برای ابزارها در رجیستری
.TP
\fBself\-update\fR
به‌روزرسانی خود mise.
.TP
\fBset\fR
تنظیم متغیرهای محیطی در mise.toml
.RS
\fIنام‌های مستعار: \fRev, env\-vars
.RE
.TP
\fBsettings\fR
مدیریت تنظیمات
.TP
\fBsettings add\fR
افزودن یک تنظیم به فایل پیکربندی
.TP
\fBsettings get\fR
نمایش یک تنظیم فعلی
.TP
\fBsettings ls\fR
نمایش تنظیمات فعلی
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBsettings set\fR
افزودن/به‌روزرسانی یک تنظیم
.RS
\fIنام‌های مستعار: \fRcreate
.RE
.TP
\fBsettings unset\fR
پاک کردن یک تنظیم
.RS
\fIنام‌های مستعار: \fRrm, remove, delete, del
.RE.TP
\fBshell\fR
تنظیم نسخه یک ابزار برای نشست جاری.
.RS
\fIنام‌های مستعار: \fRsh
.RE
.TP
\fBshell\-alias\fR
مدیریت نام‌های مستعار پوسته.
.TP
\fBshell\-alias get\fR
نمایش دستور مربوط به یک نام مستعار پوسته
.TP
\fBshell\-alias ls\fR
فهرست کردن نام‌های مستعار پوسته
.RS
\fIنام‌های مستعار: \fRlist
.RE
.TP
\fBshell\-alias set\fR
افزودن یا به‌روزرسانی یک نام مستعار پوسته
.RS
\fIنام‌های مستعار: \fRadd, create
.RE
.TP
\fBshell\-alias unset\fR
حذف یک نام مستعار پوسته
.RS
\fIنام‌های مستعار: \fRrm, remove, delete, del
.RE
.TP
\fBsponsors\fR
نمایش شرکت‌های حامی مالی mise و ابزارهای متن‌باز jdx.dev
.TP
\fBsync\fR
همگام‌سازی ابزارها از سایر مدیرهای نسخه با mise
.TP
\fBsync node\fR
ایجاد پیوند نمادین از تمام نسخه‌های ابزار بیرونی به mise
.TP
\fBsync python\fR
ایجاد پیوند نمادین از تمام نسخه‌های ابزار بیرونی به mise
.TP
\fBsync ruby\fR
ایجاد پیوند نمادین از تمام نسخه‌های ابزار ruby بیرونی به mise
.TP
\fBtasks\fR
مدیریت وظایف
.RS
\fIنام‌های مستعار: \fRt, task
.RE
.TP
\fBtasks add\fR
ایجاد یک وظیفه جدید
.TP
\fBtasks deps\fR
نمایش ساختار درختی گراف وابستگی‌ها
.TP
\fBtasks edit\fR
ویرایش یک وظیفه با $EDITOR
.TP
\fBtasks graph\fR
[آزمایشی] بررسی گراف پروژه فضای کاری
.TP
\fBtasks info\fR
دریافت اطلاعات درباره یک وظیفه
.TP
\fBtasks ls\fR
فهرست کردن وظایف موجود برای اجرا
.TP
\fBtasks run\fR
اجرای وظیفه(ها)
.RS
\fIنام‌های مستعار: \fRr
.RE
.TP
\fBtasks validate\fR
اعتبارسنجی وظایف برای بررسی خطاها و مشکلات رایج
.TP
\fBtest\-tool\fR
آزمایش نصب و اجرای یک ابزار
.TP
\fBtoken\fR
نمایش توکن‌های ارائه‌دهنده گیت که mise استفاده خواهد کرد
.TP
\fBtoken forgejo\fR
نمایش توکن Forgejo که mise برای میزبان مشخص‌شده استفاده خواهد کرد
.TP
\fBtoken github\fR
نمایش توکن GitHub که mise برای میزبان مشخص‌شده استفاده خواهد کرد
.TP
\fBtoken gitlab\fR
نمایش توکن GitLab که mise برای میزبان مشخص‌شده استفاده خواهد کرد
.TP
\fBtool\fR
دریافت اطلاعات درباره یک ابزار
.TP
\fBtool\-stub\fR
اجرای یک جانشین موقت (stub) ابزار
.TP
\fBtrust\fR
علامت‌گذاری یک فایل پیکربندی به‌عنوان قابل‌اعتماد
.TP
\fBuninstall\fR
حذف نسخه‌های نصب‌شده ابزار
.TP
\fBunset\fR
حذف متغیر(های) محیطی از فایل پیکربندی.
.TP
\fBuntrust\fR
حذف اعتماد صریح به یک پیکربندی
.TP
\fBunuse\fR
حذف نسخه‌های نصب‌شده ابزار از mise.toml
.RS
\fIنام‌های مستعار: \fRrm, remove
.RE
.TP
\fBupgrade\fR
ارتقای ابزارهای قدیمی
.RS
\fIنام‌های مستعار: \fRup
.RE
.TP
\fBuse\fR
نصب یک ابزار و افزودن نسخه آن به mise.toml.
.RS
\fIنام‌های مستعار: \fRu
.RE
.TP
\fBversion\fR
نمایش نسخه mise
.RS
\fIنام‌های مستعار: \fRv
.RE
.TP
\fBwatch\fR
اجرای وظیفه(ها) و نظارت بر تغییرات جهت اجرای مجدد آن
.RS
\fIنام‌های مستعار: \fRw
.RE
.TP
\fBwhere\fR
نمایش مسیر نصب یک ابزار
.TP
\fBwhich\fR
نمایش مسیری که فایل اجرایی (bin) یک ابزار به آن اشاره دارد..SH "MISE ACTIVATE"
مقداردهی اولیه mise در نشست جاری پوسته

این دستور باید در فایل rc یا پوستهٔ ورود (login shell) شما قرار گیرد.
در غیر این صورت، تنها در نشست جاری اعمال خواهد شد.
(برای مثال: ~/.zshrc، ~/.zprofile، ~/.zshenv، ~/.bashrc، ~/.bash_profile، ~/.profile، ~/.config/fish/config.fish یا $PROFILE برای powershell)

به‌طور معمول، این مورد را می‌توان با دستوری شبیه به زیر افزود:

    echo 'eval "$(mise activate zsh)"' >> ~/.zshrc

با این حال، این کار نیازمند آن است که "mise" در PATH شما قرار داشته باشد. اگر چنین نیست، باید مسیر کامل را به‌این صورت مشخص کنید:

    echo 'eval "$(/path/to/mise activate zsh)"' >> ~/.zshrc

سفارشی‌سازی خروجی وضعیت با تنظیمات `status` امکان‌پذیر است.
.PP
\fBنحوه استفاده:\fR mise activate [OPTIONS] [<SHELL_TYPE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-q, \-\-quiet\fR
عدم نمایش پیام‌های غیرخطا
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
نوع پوسته برای تولید اسکریپت
.TP
\fB\-\-no\-hook\-env\fR
عدم فراخوانی خودکار hook\-env

این گزینه می‌تواند برای اشکال‌زدایی mise مفید باشد. اگر دستور `eval "$(mise activate \-\-no\-hook\-env)"` را اجرا کنید، می‌توانید `mise hook\-env` را به‌صورت دستی فراخوانی کنید که متغیرهای محیطی را بدون تغییر واقعی در محیط، در stdout چاپ می‌کند. به‌این ترتیب می‌توانید کارهایی مانند `mise hook\-env \-\-trace` را برای دریافت اطلاعات بیشتر انجام دهید یا صرفاً مقادیری را که hook\-env در خروجی تولید می‌کند ببینید.
.TP
\fB\-\-shims\fR
استفاده از shimها به‌جای تغییر PATH
در عمل معادل است با:

    PATH="$HOME/.local/share/mise/shims:$PATH"

دستور `mise activate \-\-shims` از تمام ویژگی‌های `mise activate` پشتیبانی نمی‌کند.
برای اطلاعات بیشتر به <https://mise.jdx.dev/dev\-tools/shims.html#shims\-vs\-path> مراجعه کنید
.TP
\fB\-\-status\fR
نمایش پیام "mise: <TOOL>@<VERSION>" هنگام تغییر دایرکتوری‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SHELL_TYPE>\fR
نوع پوسته برای تولید اسکریپت
.SH "MISE TOOL-ALIAS"
مدیریت نام‌های مستعار نگارش‌های ابزار.
.PP
\fBنحوه استفاده:\fR mise tool\-alias [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-p, \-\-tool\fR \fI<TOOL>\fR
فیلتر کردن نام‌های مستعار بر اساس ابزار
.TP
\fB\-\-no\-header\fR
عدم نمایش سربرگ جدول
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE TOOL-ALIAS GET"
نمایش یک نام مستعار برای یک ابزار

این دستور محتوای یک مدخل tool_alias.<TOOL> در ~/.config/mise/config.toml است
.PP
\fBنحوه استفاده:\fR mise tool\-alias get [OPTIONS] <TOOL> <ALIAS>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
ابزاری که نام مستعار آن نمایش داده می‌شود
.TP
\fB<ALIAS>\fR
نام مستعاری که باید نمایش داده شود.SH "MISE TOOL-ALIAS LS"
فهرست کردن نام‌های مستعار نسخه‌های ابزار
نام‌های مستعاری که می‌توان تعیین کرد را نشان می‌دهد.
این موارد می‌توانند از پیکربندی کاربر یا از افزونه‌ها در `bin/list\-aliases` بیایند.

برای پیکربندی کاربر، نام‌های مستعار مانند زیر در `~/.config/mise/config.toml` تعریف می‌شوند:

    [tool_alias.node.versions]
    lts = "22.0.0"
.PP
\fBنحوه استفاده:\fR mise tool\-alias ls [OPTIONS] [<TOOL>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-no\-header\fR
عدم نمایش سربرگ جدول
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
نمایش نام‌های مستعار برای <TOOL>
.SH "MISE TOOL-ALIAS SET"
افزودن یا به‌روزرسانی یک نام مستعار برای یک ابزار/backend

این دستور محتوای ~/.config/mise/config.toml را تغییر می‌دهد
.PP
\fBنحوه استفاده:\fR mise tool\-alias set [OPTIONS] <TOOL> <ALIAS> [<VALUE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
ابزار/backend مورد نظر برای تنظیم نام مستعار
.TP
\fB<ALIAS>\fR
نام مستعار جهت تنظیم
.TP
\fB<VALUE>\fR
مقداری که باید برای نام مستعار تنظیم شود
.SH "MISE TOOL-ALIAS UNSET"
پاک کردن یک نام مستعار برای یک ابزار/backend

این دستور محتوای ~/.config/mise/config.toml را تغییر می‌دهد
.PP
\fBنحوه استفاده:\fR mise tool\-alias unset [OPTIONS] <TOOL> [<ALIAS>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
ابزار/backend مورد نظر برای حذف نام مستعار
.TP
\fB<ALIAS>\fR
نام مستعار جهت حذف
.SH "MISE BACKENDS"
مدیریت backendها
.PP
\fBنحوه استفاده:\fR mise backends [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BACKENDS LS"
فهرست کردن backendهای توکار (built\-in)
.PP
\fBنحوه استفاده:\fR mise backends ls [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BIN-PATHS"
فهرست کردن تمام مسیرهای bin فعال زمان اجرا
.PP
\fBکاربرد:\fR mise bin\-paths [OPTIONS] [<TOOL@VERSION>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-bin\-names\fR
نمایش نام‌های فایل‌های اجرایی به جای دایرکتوری‌های bin
.TP
\fB\-J, \-\-json\fR
نمایش ورودی‌های اجرایی در قالب JSON (شامل \-\-bin\-names نیز می‌شود)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) جهت جستجو
برای نمونه: ruby@3
.SH "MISE BOOTSTRAP"
راه‌اندازی و آماده‌سازی سیستم بر اساس پیکربندی فعلی با یک دستور

مراحل راه‌اندازی (bootstrap) را به ترتیب برای پیکربندی فعلی اجرا می‌کند:

0. `mise bootstrap accounts apply` — همگام‌سازی `[bootstrap.users]` و
   `[bootstrap.groups]` (لینوکس)
1. `mise bootstrap plugins apply` — نصب `[bootstrap.plugins]`
   1.7. `[bootstrap.hooks.pre\-packages]` — قلاب راه‌اندازی اختیاری
2. نصب ورودی‌های built\-in\-manager از `[bootstrap.packages]`
3. `mise bootstrap files apply` — همگام‌سازی `[bootstrap.files]` و
   `[bootstrap.directories]`
4. `mise bootstrap services apply` — همگام‌سازی سرویس‌های سیستمی systemd در
   `[bootstrap.services]` (لینوکس)
5. `mise bootstrap firewall apply` — همگام‌سازی سیاست‌ها و قوانین فایروال میزبان در
   `[bootstrap.linux.firewall]` (لینوکس)
6. `mise bootstrap compose apply` — همگام‌سازی پروژه‌های Docker Compose در
   `[bootstrap.compose]`
7. `mise bootstrap repos apply` — کلون/همگام‌سازی `[bootstrap.repos]`
   محصور شده با قلاب‌های `pre\-repos`/`post\-repos`
8. `mise bootstrap dotfiles apply` — اعمال dotfiles از `[dotfiles]`
   محصور شده با قلاب‌های `pre\-dotfiles`/`post\-dotfiles`
9. `mise bootstrap mise\-shell\-activate apply` — پیکربندی فعال‌سازی پوسته
   از `[bootstrap.mise_shell_activate]`
10. `mise bootstrap macos defaults apply` — نوشتن ورودی‌های
    `[bootstrap.macos.defaults]` (سیستم‌عامل macOS)
    محصور شده با قلاب‌های `pre\-defaults`/`post\-defaults`
11. `mise bootstrap macos launchd\-agents apply` — نصب/بارگذاری
    `[bootstrap.macos.launchd.agents]`
12. `mise bootstrap linux systemd\-units apply` — نصب/راه‌اندازی
    `[bootstrap.linux.systemd.units]`
13. `mise bootstrap user apply` — تنظیم `[bootstrap.user].login_shell`
    (یونیکس)
    محصور شده با قلاب‌های `pre\-user`/`post\-user`
14. `mise install` — نصب ابزارهای ناموجود از `[tools]`
    محصور شده با قلاب‌های `pre\-tools`/`post\-tools`؛ ورودی‌های package\-plugin
    از `[bootstrap.packages]` پس از آن نصب می‌شوند، و به دنبال آن
    `[bootstrap.hooks.post\-packages]` اجرا می‌گردد
15. `mise run bootstrap` — در صورت تعریف بودن وظیفه‌ای با نام `bootstrap`
16. `[bootstrap.hooks.final]` — قلاب نهایی اختیاری

مراحل توصیفی (declarative) همگام‌سازی می‌شوند — هر موردی که از قبل در وضعیت مطلوب
خود باشد نادیده گرفته می‌شود، بنابراین اجرای مجدد آن امن است. وظیفهٔ `bootstrap` با
هر بار فراخوانی اجرا می‌شود؛ آن را خودتوان (idempotent) نگه دارید. از آن برای هرگونه
راه‌اندازی مختص پروژه که در بخش‌های توصیفی نمی‌گنجد (مقداردهی اولیه پایگاه‌داده،
جریان‌های احراز هویت و غیره) استفاده کنید — این دستور همراه با ابزارهای نصب‌شده روی PATH
اجرا می‌شود.

برای نادیده گرفتن بخش‌های مشخص‌شده از `\-\-skip <part>` یا برای اجرای صرفاً همان
بخش‌ها از `\-\-only <part>` استفاده کنید. هر دو پرچم می‌توانند تکرار شوند یا با کاما
از هم جدا گردند، اما نمی‌توان آن‌ها را هم‌زمان با یکدیگر به کار برد.
.PP
\fBکاربرد:\fR mise bootstrap [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-from\fR \fI<GIT_URL>\fR
کلون کردن یک مخزن git و راه‌اندازی (bootstrap) بر اساس پیکربندی آن
.TP
\fB\-\-from\-dir\fR \fI<DIR>\fR
دایرکتوری مورد استفاده برای مخزن کلون‌شده با \-\-from
.TP
\fB\-n, \-\-dry\-run\fR
نمایش رویدادها بدون نصب هیچ موردی
.TP
\fB\-y, \-\-yes\fR
نادیده گرفتن پیام‌های تایید
.TP
\fB\-\-skip\-dirty\fR
نادیده گرفتن مخازن پیکربندی‌شده دارای تغییرات محلی به جای ناموفق شدن عملیات
.TP
\fB\-\-force\-dotfiles\fR
بازنویسی روی فایل‌های موجود که با ورودی‌های تمام‌فایلیِ dotfile تداخل دارند
.TP
\fB\-\-only\fR \fI<ONLY>\fR
اجرای تنها یک یا چند بخش راه‌اندازی (bootstrap)

می‌تواند چندین بار ارسال شده یا به عنوان فهرستی جداشده با کاما باشد. نمی‌توان آن را همراه با `\-\-skip` به کار برد.
.TP
\fB\-\-prompt\-secrets\fR
درخواست امن ورودی‌های محرمانهٔ ناموجود برای راه‌اندازی
.TP
\fB\-\-skip\fR \fI<SKIP>\fR
نادیده گرفتن یک یا چند بخش راه‌اندازی (bootstrap)

می‌تواند چندین بار ارسال شده یا به عنوان فهرستی جداشده با کاما باشد.
.TP
\fB\-\-update\fR
تازه‌سازی فراداده‌های مدیر بسته و به‌روزرسانی مخازن پیکربندی‌شده
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP ACCOUNTS"
مدیریت کاربران و گروه‌های لینوکس از `[bootstrap.users]` و `[bootstrap.groups]`
.PP
\fBنحوه استفاده:\fR mise bootstrap accounts [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP ACCOUNTS APPLY"
اعمال کاربران و گروه‌های پیکربندی‌شده لینوکس
.PP
\fBنحوه استفاده:\fR mise bootstrap accounts apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش تغییرات بدون اعمال هیچ تغییری
.TP
\fB\-y, \-\-yes\fR
رد کردن پیام درخواست تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP ACCOUNTS STATUS"
نمایش وضعیت کاربران و گروه‌های پیکربندی‌شده لینوکس
.PP
\fBنحوه استفاده:\fR mise bootstrap accounts status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورت عدم همگرایی هر یک از حساب‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP COMPOSE"
مدیریت پروژه‌های Docker Compose از `[bootstrap.compose]`
.PP
\fBنحوه استفاده:\fR mise bootstrap compose [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP COMPOSE APPLY"
اعمال وضعیت پیکربندی‌شده پروژه‌های Docker Compose
.PP
\fBنحوه استفاده:\fR mise bootstrap compose apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش تغییرات بدون اعمال هیچ تغییری
.TP
\fB\-y, \-\-yes\fR
رد کردن پیام درخواست تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP COMPOSE STATUS"
نمایش وضعیت پیکربندی‌شده پروژه‌های Docker Compose
.PP
\fBنحوه استفاده:\fR mise bootstrap compose status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورت عدم همگرایی هر یک از پروژه‌های Compose
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP DOTFILES"
مدیریت dotfileها از `[dotfiles]`
.PP
\fBنحوه استفاده:\fR mise bootstrap dotfiles [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP DOTFILES ADD"
افزودن یا به‌روزرسانی dotfileها در `[dotfiles]`

اگر هدف از قبل مدیریت شده باشد، این دستور منبع آن را از هدف زنده به‌روزرسانی می‌کند. در غیر این صورت، یک مدخل `[dotfiles]` ایجاد کرده و منبع را در `dotfiles.root` قرار می‌دهد، مگر اینکه `\-\-source` مشخص شده باشد.
.PP
\fBنحوه استفاده:\fR mise bootstrap dotfiles add [OPTIONS] [<TARGET>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-changed\fR
به‌روزرسانی منابع تمام فایل‌های تغییریافته که در حالت copy مدیریت می‌شوند
.TP
\fB\-f, \-\-force\fR
بازنویسی منابع موجود بدون درخواست تأیید
.TP
\fB\-g, \-\-global\fR
نوشتن در پیکربندی سراسری (global)
.TP
\fB\-l, \-\-local\fR
نوشتن در پیکربندی محلی (local) به جای پیکربندی سراسری
.TP
\fB\-m, \-\-mode\fR \fI<MODE>\fR
حالت dotfile برای نوشتن
.TP
\fB\-n, \-\-dry\-run\fR
چاپ به‌روزرسانی‌های پیکربندی/منبع بدون نوشتن هیچ تغییری
.TP
\fB\-\-no\-apply\fR
افزودن مدخل بدون اعمال آن
.TP
\fB\-p, \-\-path\fR \fI<PATH>\fR
نوشتن در این فایل پیکربندی یا دایرکتوری
.TP
\fB\-s, \-\-source\fR \fI<PATH>\fR
مسیر منبع برای استفاده جهت یک هدف تکی
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر از اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
هدف‌ها برای افزودن یا به‌روزرسانی
.SH "MISE BOOTSTRAP DOTFILES APPLY"
اعمال dotfileها از `[dotfiles]`

مدخل‌های پیکربندی‌شده به‌صورت کل فایل (whole\-file) و ویرایش‌هایی را که در وضعیت مطلوب خود نیستند، اعمال می‌کند. مدخل‌های کل فایل ممکن است پیوند نمادین (symlink)، کپی، یا قالب‌ها را رندر (render) کنند. مدخل‌های ویرایش، یک بلوک محدودشده با نشانگر یا یک خط منفرد را در فایلی مدیریت می‌کنند که mise در حالت عادی مالکیتی بر آن ندارد.
.PP
\fBنحوه استفاده:\fR mise bootstrap dotfiles apply [OPTIONS] [<TARGET>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
بازنویسی فایل‌های موجود که با مدخل‌های dotfile از نوع کل فایل تداخل دارند
.TP
\fB\-n, \-\-dry\-run\fR
چاپ اقداماتی که اجرا خواهند شد بدون نوشتن هیچ تغییری
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر از اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
تنها اعمال این هدف‌ها.SH "MISE BOOTSTRAP DOTFILES DIFF"
نمایش تغییرات لازم جهت اعمال دات‌فایل‌ها از `[dotfiles]`
.PP
\fBکاربرد:\fR mise bootstrap dotfiles diff [OPTIONS] [<TARGET>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
تنها نمایش این هدف‌ها
.SH "MISE BOOTSTRAP DOTFILES EDIT"
ویرایش منبع یک دات‌فایل مدیریت‌شده
.PP
\fBکاربرد:\fR mise bootstrap dotfiles edit [OPTIONS] <TARGET>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-apply\fR
اعمال این هدف پس از خروج از ویرایشگر
.TP
\fB\-m, \-\-mode\fR \fI<MODE>\fR
حالت دات‌فایل مورد استفاده در صورتی که هدف هنوز مدیریت نشده باشد
.TP
\fB\-s, \-\-source\fR \fI<PATH>\fR
مسیر منبع مورد استفاده در صورتی که هدف هنوز مدیریت نشده باشد
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از اعلان تأیید هنگام افزودن یک هدف مدیریت‌نشده
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
هدف جهت ویرایش
.SH "MISE BOOTSTRAP DOTFILES STATUS"
نمایش وضعیت دات‌فایل‌ها از `[dotfiles]`
.PP
\fBکاربرد:\fR mise bootstrap dotfiles status [OPTIONS] [<TARGET>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از دات‌فایل‌های پیکربندی‌شده در وضعیت
مطلوب خود نباشند (ناموجود، منبع ناموجود، دارای تفاوت)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
تنها نمایش این هدف‌ها
.SH "MISE BOOTSTRAP DOTFILES UNAPPLY"
حذف دات‌فایل‌های اعمال‌شده از `[dotfiles]`

مدخل‌های فایل کامل و ویرایش‌های پیکربندی‌شده را حذف می‌کند، در حالی که فایل‌هایی
را که mise نمی‌تواند به‌عنوان مدیریت‌شده شناسایی کند حفظ می‌نماید. رونوشت‌های
تغییریافته، قالب‌ها و ویرایش‌های خطوط ساده نیازمند `\-\-force` هستند.
.PP
\fBکاربرد:\fR mise bootstrap dotfiles unapply [OPTIONS] [<TARGET>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
حذف فایل‌ها و خطوط مدیریت‌شدهٔ تغییریافته یا به‌نوعی مبهم
.TP
\fB\-n, \-\-dry\-run\fR
چاپ اقداماتی که بدون نوشتن هیچ داده‌ای اجرا خواهند شد
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
تنها لغو اعمال این هدف‌ها.SH "MISE BOOTSTRAP FILES"
مدیریت فایل‌ها و دایرکتوری‌های دارای دسترسی ویژه از `[bootstrap.files]` و `[bootstrap.directories]`
.PP
\fBکاربرد:\fR mise bootstrap files [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP FILES APPLY"
اعمال فایل‌ها و دایرکتوری‌های دارای دسترسی ویژهٔ پیکربندی‌شده
.PP
\fBکاربرد:\fR mise bootstrap files apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش تغییرات احتمالی بدون اعمال هیچ تغییری
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از اعلان تأیید
.TP
\fB\-\-prompt\-secrets\fR
درخواست امن برای ورودی‌های محرمانهٔ (secret) ناموجود bootstrap
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP FILES STATUS"
نمایش وضعیت فایل‌ها و دایرکتوری‌های دارای دسترسی ویژهٔ پیکربندی‌شده
.PP
\fBکاربرد:\fR mise bootstrap files status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد 1 هنگامی که هر یک از منابع همگرا نشده باشند
.TP
\fB\-\-prompt\-secrets\fR
درخواست امن برای ورودی‌های محرمانهٔ (secret) ناموجود bootstrap
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP FIREWALL"
مدیریت فایروال میزبان لینوکس از `[bootstrap.linux.firewall]`
.PP
\fBکاربرد:\fR mise bootstrap firewall [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP FIREWALL APPLY"
اعمال فایروال پیکربندی‌شدهٔ میزبان لینوکس
.PP
\fBکاربرد:\fR mise bootstrap firewall apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش تغییرات احتمالی بدون اعمال هیچ تغییری
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP FIREWALL STATUS"
نمایش وضعیت فایروال پیکربندی‌شدهٔ میزبان لینوکس
.PP
\fBکاربرد:\fR mise bootstrap firewall status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد 1 هنگامی که فایروال همگرا نشده باشد
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP LINUX"
مدیریت پیکربندی راه‌اندازی لینوکس از `[bootstrap.linux]`
.PP
\fBکاربرد:\fR mise bootstrap linux [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP LINUX SYSTEMD-UNITS"
مدیریت سرویس‌های کاربری systemd از `[bootstrap.linux.systemd.units]`
.PP
\fBکاربرد:\fR mise bootstrap linux systemd\-units [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP LINUX SYSTEMD-UNITS APPLY"
\fBکاربرد:\fR mise bootstrap linux systemd\-units apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش دستوراتی که اجرا خواهند شد، بدون اجرای واقعی آن‌ها
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP LINUX SYSTEMD-UNITS STATUS"
\fBکاربرد:\fR mise bootstrap linux systemd\-units status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد وضعیت ۱ در صورتی که هر یک از سرویس‌های کاربری پیکربندی‌شدهٔ systemd در وضعیت مطلوب خود نباشد
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MACOS"
مدیریت پیکربندی راه‌اندازی macOS از `[bootstrap.macos]`
.PP
\fBکاربرد:\fR mise bootstrap macos [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MACOS DEFAULTS"
مدیریت پیش‌فرض‌های macOS از `[bootstrap.macos.defaults]`
.PP
\fBکاربرد:\fR mise bootstrap macos defaults [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MACOS DEFAULTS APPLY"
\fBکاربرد:\fR mise bootstrap macos defaults apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش دستوراتی که اجرا خواهند شد، بدون اجرای واقعی آن‌ها
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP MACOS DEFAULTS STATUS"
\fBکاربرد:\fR mise bootstrap macos defaults status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از تنظیمات پیش‌فرض (defaults) پیکربندی‌شده در وضعیت مطلوب خود نباشند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MACOS LAUNCHD-AGENTS"
مدیریت LaunchAgentهای macOS از طریق `[bootstrap.macos.launchd.agents]`
.PP
\fBکاربرد:\fR mise bootstrap macos launchd\-agents [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MACOS LAUNCHD-AGENTS APPLY"
\fBکاربرد:\fR mise bootstrap macos launchd\-agents apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش دستوراتی که بدون اجرای واقعی، اجرا خواهند شد
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MACOS LAUNCHD-AGENTS STATUS"
\fBکاربرد:\fR mise bootstrap macos launchd\-agents status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از LaunchAgentهای پیکربندی‌شده در وضعیت مطلوب خود نباشند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MISE-SHELL-ACTIVATE"
مدیریت فعال‌سازی پوسته mise از طریق `[bootstrap.mise_shell_activate]`
.PP
\fBکاربرد:\fR mise bootstrap mise\-shell\-activate [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MISE-SHELL-ACTIVATE APPLY"
\fBکاربرد:\fR mise bootstrap mise\-shell\-activate apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش اقداماتی که بدون اعمال و نوشتن هیچ تغییری انجام خواهند شد
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP MISE-SHELL-ACTIVATE STATUS"
\fBکاربرد:\fR mise bootstrap mise\-shell\-activate status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از فعال‌سازی‌های پیکربندی‌شده پوسته در وضعیت مطلوب خود نباشند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP PACKAGES"
مدیریت بسته‌های سیستمی راه‌اندازی (bootstrap) از `[bootstrap.packages]`
.PP
\fBطرز استفاده:\fR mise bootstrap packages [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PACKAGES APPLY"
اعمال بسته‌های سیستمی از `[bootstrap.packages]`

بررسی می‌کند که کدام بسته‌های پیکربندی‌شده موجود نیستند و آن‌ها را با مدیر
بسته‌ی سیستم نصب می‌کند. مدیرهای بسته سیستمی توکار ممکن است در صورت اجرا
نشدن توسط کاربر ریشه (root)، دسترسی را با sudo ارتقا دهند (به `system_packages.sudo`
مراجعه کنید)؛ پلاگین‌های بسته هرگز این کار را انجام نمی‌دهند.

بسته‌ها همچنین می‌توانند صراحتاً در قالب `manager:package` مشخص شوند (مانند
`apk:zlib\-dev`، `apt:curl`، `brew:jq`)؛ این بسته‌ها صرف‌نظر از این‌که در
پیکربندی باشند یا خیر، نصب می‌شوند. بسته‌های صریح و `\-\-manager` دامنه‌ی اجرا
را تنها به همان بسته‌ها محدود می‌کنند. دستور `install` به عنوان یک نام مستعار
برای این دستور پذیرفته می‌شود.
.PP
\fBطرز استفاده:\fR mise bootstrap packages apply [OPTIONS] [<PACKAGE>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-m, \-\-manager\fR \fI<MANAGER>\fR
فقط بسته‌ها برای این مدیر بسته توکار یا پلاگین نصب شوند
.TP
\fB\-n, \-\-dry\-run\fR
چاپ دستوراتی که اجرا خواهند شد بدون اجرای واقعی آن‌ها
.TP
\fB\-y, \-\-yes\fR
رد کردن پیام تأیید
.TP
\fB\-\-update\fR
تازه‌سازی فراداده‌های مدیر بسته پیش از شروع (در apk: `\-\-update\-cache`، در apt: `apt\-get update`)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PACKAGE>\fR
بسته‌ها در قالب `manager:package`؛ مقدار پیش‌فرض تمام موارد پیکربندی‌شده در [bootstrap.packages] است
.SH "MISE BOOTSTRAP PACKAGES BREW"
مدیریت مخازن (taps) ابزار Homebrew مورد استفاده بسته‌های راه‌اندازی

این دستورها `[bootstrap.brew.taps]` را ویرایش می‌کنند تا فرمول‌ها و caskهای tapشده
بتوانند مستقیماً توسط mise بدون نیاز به نصب بودن Homebrew دریافت شوند.
.PP
\fBطرز استفاده:\fR mise bootstrap packages brew [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PACKAGES BREW TAP"
افزودن نشانی اینترنتی (URL) یک مخزن Homebrew به [bootstrap.brew.taps]
.PP
\fBطرز استفاده:\fR mise bootstrap packages brew tap [OPTIONS] <TAP> [<URL>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-local\fR
نوشتن در پیکربندی محلی به‌جای پیکربندی سراسری
.TP
\fB\-n, \-\-dry\-run\fR
چاپ تغییرات پیکربندی بدون ذخیره کردن آن‌ها
.TP
\fB\-p, \-\-path, \-\-file\fR \fI<PATH>\fR
نوشتن در این فایل یا دایرکتوری پیکربندی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TAP>\fR
نام tap، مانند `owner/repo`
.TP
\fB<URL>\fR
نشانی اینترنتی گیت‌هاب برای tap. مقدار پیش‌فرض: https://github.com/<owner>/homebrew\-<repo>.git.SH "MISE BOOTSTRAP PACKAGES BREW UNTAP"
حذف آدرس‌های tap مربوط به Homebrew از [bootstrap.brew.taps]
.PP
\fBنحوه استفاده:\fR mise bootstrap packages brew untap [OPTIONS] <TAPS> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-local\fR
نوشتن در پیکربندی محلی به جای پیکربندی سراسری
.TP
\fB\-n, \-\-dry\-run\fR
چاپ تغییرات پیکربندی بدون نوشتن آن
.TP
\fB\-p, \-\-path, \-\-file\fR \fI<PATH>\fR
نوشتن در این فایل یا دایرکتوری پیکربندی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TAPS>\fR
نام tap(ها)، مانند `owner/repo`
.SH "MISE BOOTSTRAP PACKAGES IMPORT"
وارد کردن بسته‌های نصب‌شده سیستمی به `[bootstrap.packages]`

در حال حاضر تنها از فرمول‌های (formulae) Homebrew پشتیبانی می‌کند. به‌طور پیش‌فرض، فرمول‌های پیوندخورده‌ای که رسید فعال keg آن‌ها نشان می‌دهد بنا به درخواست کاربر نصب شده‌اند، وارد می‌شوند. برای وارد کردن تمامی فرمول‌های پیوندخورده از جمله وابستگی‌ها، `\-\-all` را ارسال کنید.
.PP
\fBنحوه استفاده:\fR mise bootstrap packages import [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-e, \-\-env\fR \fI<ENV>\fR
نوشتن در فایل پیکربندی مربوط به این محیط (mise.<ENV>.toml)
.TP
\fB\-g, \-\-global\fR
نوشتن در پیکربندی سراسری (~/.config/mise/config.toml)
.TP
\fB\-m, \-\-manager\fR \fI<MANAGER>\fR
تنها وارد کردن بسته‌های مربوط به این مدیر بسته. در حال حاضر فقط `brew` پشتیبانی می‌شود.
.RS
\fIپیش‌فرض: \fRbrew
.RE
.TP
\fB\-\-all\fR
وارد کردن تمام فرمول‌های پیوندخورده، از جمله وابستگی‌ها
.TP
\fB\-n, \-\-dry\-run\fR
چاپ تغییرات پیکربندی بدون نوشتن فایل پیکربندی
.TP
\fB\-p, \-\-path, \-\-file\fR \fI<PATH>\fR
نوشتن در این فایل یا دایرکتوری پیکربندی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PACKAGES PRUNE"
پاکسازی بسته‌های نصب‌شده سیستمی که دیگر در `[bootstrap.packages]` تعریف نشده‌اند

از فرمول‌های Homebrew، caskهای متعلق به mise که با احتیاط قابل حذف هستند، و بسته‌های نصب‌شده توسط افزونه‌های بسته‌ای که `PackageUninstall` را پیاده‌سازی می‌کنند پشتیبانی می‌کند. پاکسازی، بسته‌های مورد نیاز پیکربندی فعلی یا پیکربندی‌های ردیابی‌شده، قابل بارگیری و معتبر را حفظ می‌کند. بسته‌های افزونه که پیش از اعمال اولیه آن‌ها توسط mise نصب شده بودند، هرگز تحت مالکیت قرار نگرفته و حذف نمی‌شوند.
.PP
\fBنحوه استفاده:\fR mise bootstrap packages prune [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-m, \-\-manager\fR \fI<MANAGER>\fR
تنها پاکسازی بسته‌های مربوط به این مدیر بسته
.RS
\fIپیش‌فرض: \fRbrew
.RE
.TP
\fB\-n, \-\-dry\-run\fR
چاپ مواردی که حذف خواهند شد بدون پاک کردن هیچ چیز
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP PACKAGES STATUS"
نمایش وضعیت بسته‌های سیستم از `[bootstrap.packages]`
.PP
\fBنحوه استفاده:\fR mise bootstrap packages status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از بسته‌های پیکربندی‌شده در وضعیت مطلوب خود نباشند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PACKAGES UPGRADE"
ارتقای بسته‌های bootstrap نصب‌شده از `[bootstrap.packages]`

متادیتای مدیر بسته را تازه‌سازی کرده و بسته‌های پیکربندی‌شده‌ای را که پیش‌تر نصب شده‌اند ارتقا می‌دهد: apk/apt/dnf/pacman به جدیدترین نسخه موجود ارتقا می‌یابند (apk، apt و dnf از نسخه پین‌شده در پیکربندی پیروی می‌کنند)، brew نسخه bottle فعلی فرمول را می‌ریزد (pour) و keg قدیمی را جایگزین می‌کند، brew\-cask آرتفکت جاری cask را نصب می‌کند، flatpak و flatpak\-user برنامه‌ها و زمان‌های اجرا (runtimes) را به‌روزرسانی می‌کنند، و mas برنامه‌های App Store را ارتقا می‌دهد. بسته‌هایی که هنوز نصب نشده‌اند نادیده گرفته می‌شوند — برای آن‌ها از `mise bootstrap packages apply` استفاده کنید.

بسته‌ها را می‌توان به‌طور صریح در قالب `manager:package` نیز مشخص کرد.
.PP
\fBنحوه استفاده:\fR mise bootstrap packages upgrade [OPTIONS] [<PACKAGE>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-m, \-\-manager\fR \fI<MANAGER>\fR
تنها ارتقای بسته‌ها برای این مدیر بسته توکار یا افزونه
.TP
\fB\-n, \-\-dry\-run\fR
چاپ دستوراتی که بدون اجرا شدن، قرار بود اجرا شوند
.TP
\fB\-y, \-\-yes\fR
رد کردن پیام تایید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PACKAGE>\fR
بسته‌ها در قالب `manager:package`؛ به‌طور پیش‌فرض شامل تمام موارد پیکربندی‌شده در [bootstrap.packages] است
.SH "MISE BOOTSTRAP PACKAGES USE"
افزودن بسته‌های bootstrap به [bootstrap.packages] و نصب آن‌ها

مشابه `mise use` برای ابزارها: ورودی‌های `"manager:package" = "version"` را در mise.toml می‌نویسد (به‌طور پیش‌فرض در پیکربندی محلی، و با `\-g` در پیکربندی سراسری) و سپس هر آنچه را که موجود نیست نصب می‌کند.

نسخه‌ها با استفاده از `@` پین (ثابت) می‌شوند: `mise bootstrap packages use apt:curl@8.5.0\-2`. بدون `@` (یا با `@latest`) هیچ پینی ثبت نمی‌شود. فرمول‌ها و caskهای brew در عوض از طریق نام‌هایشان نسخه‌بندی می‌شوند (برای مثال `brew:postgresql@17`، `brew\-cask:temurin@17`)، که در آن‌ها `@` بخشی از نام Homebrew است نه انتخاب‌گر نسخه mise. مدیر بسته mas از شناسه‌های عددی ADAM استفاده می‌کند و از پین کردن نسخه پشتیبانی نمی‌کند.
.PP
\fBنحوه استفاده:\fR mise bootstrap packages use [OPTIONS] <PACKAGE> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-e, \-\-env\fR \fI<ENV>\fR
نوشتن در فایل پیکربندی مربوط به این محیط (mise.<ENV>.toml)
.TP
\fB\-g, \-\-global\fR
نوشتن در پیکربندی سراسری (~/.config/mise/config.toml) به جای پیکربندی محلی
.TP
\fB\-n, \-\-dry\-run\fR
چاپ دستوراتی که بدون نوشتن پیکربندی یا نصب، قرار بود اجرا شوند
.TP
\fB\-p, \-\-path, \-\-file\fR \fI<PATH>\fR
نوشتن در این فایل یا دایرکتوری پیکربندی
.TP
\fB\-y, \-\-yes\fR
رد کردن پیام تایید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PACKAGE>\fR
بسته‌ها در قالب `manager:package[@version]`.SH "MISE BOOTSTRAP PLAN"
نمایش تغییراتی که منابع راه‌اندازی (bootstrap) توصیفی اعمال خواهند کرد
.PP
\fBکاربرد:\fR mise bootstrap plan [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی دادن یک برنامهٔ پایدار و ماشین‌خوان در قالب JSON
.TP
\fB\-\-detailed\-exitcode\fR
خروج با کد ۲ هنگام وجود تغییرات در برنامه، ۰ هنگام عدم تغییر، و ۱ در صورت بروز خطا
.TP
\fB\-\-prompt\-secrets\fR
درخواست امن برای ورودی‌های محرمانهٔ (secret) ناموجود راه‌اندازی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PLUGINS"
مدیریت افزونه‌های مدیر بستهٔ تعریف‌شده در `[bootstrap.plugins]`
.PP
\fBکاربرد:\fR mise bootstrap plugins [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PLUGINS APPLY"
\fBکاربرد:\fR mise bootstrap plugins apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
چاپ آنچه رخ خواهد داد بدون نصب افزونه‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP PLUGINS STATUS"
\fBکاربرد:\fR mise bootstrap plugins status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورت مفقود بودن یک افزونهٔ تعریف‌شده
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP REMOTE"
راه‌اندازی یک یا چند ماشین از طریق OpenSSH
.PP
\fBکاربرد:\fR mise bootstrap remote [OPTIONS] [<TARGET>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-all\fR
انتخاب تمام میزبان‌های پیکربندی‌شده در inventory
.TP
\fB\-\-bootstrap\-command\fR \fI<COMMAND>\fR
دستور شل راه دور صریح که mise را نصب کرده و آن را در PATH قرار می‌دهد
.TP
\fB\-\-connect\-timeout\fR \fI<CONNECT_TIMEOUT>\fR
مهلت زمانی اتصال SSH به ثانیه
.RS
\fIپیش‌فرض: \fR10
.RE
.TP
\fB\-\-copy\-link\fR \fI<PATH>\fR
دنبال کردن پیوند نمادین وابسته به مبدأ (dereference)؛ برای چند پیوند تکرار شود
.TP
\fB\-\-copy\-links\fR
دنبال کردن و رونوشت مستقیم تمام پیوندهای نمادین در آرشیو مبدأ (dereference)
.TP
\fB\-\-exclude\fR \fI<PATTERN>\fR
الگوی آرشیو اضافی برای مستثنی کردن؛ برای چندین الگو تکرار شود
.TP
\fB\-\-fail\-fast\fR
توقف بلافاصله پس از نخستین هدف ناموفق
.TP
\fB\-\-force\-dotfiles\fR
اجازه به جایگزینی تداخل‌های فایل‌های dotfile در مقصد راه دور
.TP
\fB\-\-host\fR \fI<[USER@]HOST>\fR
مقصد SSH موردی (`[user@]host`)؛ برای چندین میزبان تکرار شود
.TP
\fB\-i, \-\-identity\-file\fR \fI<IDENTITY_FILE>\fR
نادیده‌گرفتن و جایگزینی فایل هویت (identity file) در SSH
.TP
\fB\-n, \-\-dry\-run\fR
چاپ تغییرات راه‌اندازی راه دور بدون اعمال آن‌ها
.TP
\fB\-\-install\-mise\fR \fI<PATH>\fR
نصب mise آماده‌شده روی هر میزبان به جای نگه‌داشتن صرف آن در مرحلهٔ آماده‌سازی (staging)

پیش‌فرض `~/.local/bin/mise` است؛ برای مسیری دیگر `\-\-install\-mise=<PATH>` را ارسال کنید.
.TP
\fB\-\-keep\-staging\fR
نگه‌داشتن دایرکتوری آماده‌سازی (staging) راه دور برای اشکال‌زدایی
.TP
\fB\-\-mise\-bin\fR \fI<MISE_BIN>\fR
باینری محلی mise برای بارگذاری (راهکار فرار برای معماری‌های سفارشی)
.TP
\fB\-\-no\-install\-mise\fR
عدم نصب mise روی میزبان، حتی زمانی که میزبان‌های انتخاب‌شده آن را پیکربندی کرده باشند
.TP
\fB\-\-only\fR \fI<ONLY>\fR
اجرای تنها یک یا چند بخش از راه‌اندازی راه دور
.TP
\fB\-\-port\fR \fI<PORT>\fR
جایگزینی پورت سفارشی SSH
.TP
\fB\-\-prompt\-secrets\fR
درخواست امن برای ورودی‌های محرمانهٔ ناموجود در میزبان راه دور
.TP
\fB\-\-remote\-env\fR \fI<ENV>\fR
محیط‌های پیکربندی برای بارگذاری روی میزبان راه دور؛ تکرار کنید یا با کاما جدا کنید (برای نمونه ci,dotfiles)
.TP
\fB\-\-remote\-mise\fR \fI<COMMAND>\fR
نام یا مسیر فایل اجرایی mise موجود؛ مسیرهای نسبی از پروژهٔ آماده‌شده (staged) استفاده می‌کنند
.TP
\fB\-\-skip\fR \fI<SKIP>\fR
رد کردن یک یا چند بخش از راه‌اندازی راه دور
.TP
\fB\-\-source\fR \fI<SOURCE>\fR
دایرکتوری محلی که آرشیو شده و به هر هدف ارسال می‌شود
.TP
\fB\-\-ssh\-option\fR \fI<OPTION>\fR
گزینهٔ `\-o` در OpenSSH؛ برای گزینه‌های متعدد تکرار شود
.TP
\fB\-\-tag\fR \fI<TAG>\fR
انتخاب میزبان‌های پیکربندی‌شده با این برچسب؛ برای تطبیق با هر برچسبی تکرار شود
.TP
\fB\-\-update\fR
تازه‌سازی فراداده‌های مدیر بسته و به‌روزرسانی مخازن پیکربندی‌شده از راه دور
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان‌های تأیید راه دور
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TARGET>\fR
نام‌های میزبان inventory از `[bootstrap.remote.hosts]`.SH "MISE BOOTSTRAP REPOS"
مدیریت مخازن گیت دریافت‌شده از `[bootstrap.repos]`
.PP
\fBکاربرد:\fR mise bootstrap repos [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP REPOS APPLY"
\fBکاربرد:\fR mise bootstrap repos apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش دستوراتی که قرار است اجرا شوند، بدون اجرای واقعی آن‌ها
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان تأیید
.TP
\fB\-\-skip\-dirty\fR
نادیده گرفتن مخازن دارای تغییرات محلی به‌جای متوقف شدن با خطا
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP REPOS EXEC"
\fBکاربرد:\fR mise bootstrap repos exec [OPTIONS] [<PATH>] ... <COMMAND> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-c, \-\-continue\-on\-error\fR
ادامه اجرا در سایر مخازن پس از بروز خطا در یک دستور
.TP
\fB\-n, \-\-dry\-run\fR
نمایش دستوراتی که قرار است اجرا شوند، بدون اجرای واقعی آن‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PATH>\fR
اجرا تنها در مسیرهای منطبق با مسیرهای پیکربندی‌شده یا گسترش‌یافته
.TP
\fB<COMMAND>\fR
دستور و آرگومان‌ها برای اجرا در هر مخزن
.SH "MISE BOOTSTRAP REPOS STATUS"
\fBکاربرد:\fR mise bootstrap repos status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی با قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از مخازن پیکربندی‌شده در وضعیت مطلوب خود نباشد
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP REPOS UPDATE"
\fBکاربرد:\fR mise bootstrap repos update [OPTIONS] [<PATH>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش دستوراتی که قرار است اجرا شوند، بدون اجرای واقعی آن‌ها
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان تأیید
.TP
\fB\-\-skip\-dirty\fR
نادیده گرفتن مخازن دارای تغییرات محلی به‌جای متوقف شدن با خطا
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PATH>\fR
به‌روزرسانی تنها در مسیرهای منطبق با مسیرهای پیکربندی‌شده یا گسترش‌یافته.SH "MISE BOOTSTRAP SECRETS"
بررسی ورودی‌های محرمانه bootstrap بدون فاش کردن مقادیر آن‌ها
.PP
\fBنحوه استفاده:\fR mise bootstrap secrets [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP SECRETS STATUS"
نمایش وضعیت در دسترس بودن ورودی‌های محرمانه تعریف‌شده bootstrap
.PP
\fBنحوه استفاده:\fR mise bootstrap secrets status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورت در دسترس نبودن هر یک از ورودی‌های محرمانه تعریف‌شده
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP SERVICES"
مدیریت سرویس‌های سیستم لینوکس از `[bootstrap.services]`
.PP
\fBنحوه استفاده:\fR mise bootstrap services [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP SERVICES APPLY"
اِعمال وضعیت پیکربندی‌شده سرویس‌های سیستم لینوکس
.PP
\fBنحوه استفاده:\fR mise bootstrap services apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
نمایش تغییرات احتمالی بدون اِعمال هیچ تغییری
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر کردن از درخواست تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP SERVICES STATUS"
نمایش وضعیت پیکربندی‌شده سرویس‌های سیستم لینوکس
.PP
\fBنحوه استفاده:\fR mise bootstrap services status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورت عدم همگرایی هر یک از سرویس‌ها به وضعیت مطلوب
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP STATUS"
نمایش وضعیت تجمیعی bootstrap
.PP
\fBنحوه استفاده:\fR mise bootstrap status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از وضعیت‌های پیکربندی‌شده bootstrap در وضعیت مطلوب خود نباشد
.TP
\fB\-\-prompt\-secrets\fR
درخواست امن برای دریافت ورودی‌های محرمانه ناموجود bootstrap
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE BOOTSTRAP USER"
مدیریت تنظیمات راه‌اندازی اولیه (bootstrap) کاربر جاری از `[bootstrap.user]`
.PP
\fBنحوه استفاده:\fR mise bootstrap user [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP USER APPLY"
\fBنحوه استفاده:\fR mise bootstrap user apply [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
چاپ دستورهایی که قرار است اجرا شوند بدون اجرای واقعی آن‌ها
.TP
\fB\-y, \-\-yes\fR
رد کردن اعلان تأیید
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE BOOTSTRAP USER STATUS"
\fBنحوه استفاده:\fR mise bootstrap user status [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی با قالب JSON
.TP
\fB\-\-missing\fR
خروج با کد ۱ در صورتی که هر یک از تنظیمات پیکربندی‌شده کاربر در وضعیت مطلوب نباشد
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE CACHE"
مدیریت حافظهٔ موقت (cache) نرم‌افزار mise

برای مشاهده دایرکتوری فعلی حافظهٔ موقت، `mise cache` را بدون هیچ آرگومانی اجرا کنید.
.PP
\fBنحوه استفاده:\fR mise cache [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE CACHE CLEAR"
حذف تمامی فایل‌های حافظهٔ موقت در mise
.PP
\fBنحوه استفاده:\fR mise cache clear [OPTIONS] [<TOOL>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-outdate\fR
علامت‌گذاری تمامی فایل‌های حافظهٔ موقت به عنوان قدیمی
.TP
\fB\-\-task\fR \fI<TASK>\fR
پاک‌سازی مدخل‌های حافظهٔ موقت خروجی برای یک نام یا الگوی تسک
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
ابزار(هایی) که حافظهٔ موقت آن‌ها پاک می‌شود؛ مانند: node, python
.SH "MISE CACHE PATH"
نمایش مسیر دایرکتوری حافظهٔ موقت
.PP
\fBنحوه استفاده:\fR mise cache path [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE CACHE PRUNE"
حذف فایل‌های کهنهٔ حافظهٔ موقت mise

به‌طور پیش‌فرض، این دستور فایل‌هایی را که در ۳۰ روز گذشته مورد دسترسی قرار نگرفته‌اند حذف می‌کند.
این مقدار را می‌توانید با متغیر محیطی MISE_CACHE_PRUNE_AGE تغییر دهید.
.PP
\fBکاربرد:\fR mise cache prune [OPTIONS] [<TOOL>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-v, \-\-verbose\fR
نمایش فایل‌های پاک‌سازی‌شده
.TP
\fB\-\-dry\-run\fR
صرفاً نمایش مواردی که پاک‌سازی خواهند شد
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
ابزار(هایی) که حافظهٔ موقت آن‌ها پاک‌سازی می‌شود؛ مانند: node، python
.SH "MISE CACHE TASK"
بررسی مدخل‌های حافظهٔ موقت خروجی برای یک وظیفه
.PP
\fBکاربرد:\fR mise cache task [OPTIONS] <TASK>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
ارائهٔ خروجی در قالب JSON
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASK>\fR
نام یا الگوی وظیفه جهت بررسی
.SH "MISE COMPLETION"
تولید تکمیل خودکار پوسته
.PP
\fBکاربرد:\fR mise completion [OPTIONS] [<SHELL>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
نوع پوسته برای تولید تکمیل خودکار
.TP
\fB\-\-include\-bash\-completion\-lib\fR
برای سازگاری با تولیدکننده‌های قدیمی‌تر تکمیل خودکار نگه‌داشته شده است.

اسکریپت bash درونی usage\-rs خودکفا (self\-contained) است، بنابراین این گزینه اکنون هیچ عملی انجام نمی‌دهد (no\-op).
.TP
\fB\-\-usage\fR
برای سازگاری با تولیدکننده‌های قدیمی‌تر تکمیل خودکار نگه‌داشته شده است.

تکمیل‌های خودکار اکنون همیشه از پروتکل درونی usage\-rs استفاده می‌کنند، بنابراین این گزینه هیچ عملی انجام نمی‌دهد (no\-op).
.TP
\fB\-\-install\fR
نصب اسکریپت در محلی که این پوسته به‌دنبال آن می‌گردد، به‌جای چاپ آن در خروجی

فایل اسکریپت را می‌نویسد و کار دیگری نمی‌کند: هیچ فایل rc متعلق به پوسته و هیچ نمایهٔ PowerShell
ویرایش نمی‌شود. در مواردی که یک پوسته به یک سطر اختصاصی و یک‌باره نیاز دارد — مانند `fpath+=` در zsh یا dot\-source در
PowerShell — آن سطر چاپ می‌شود تا خودتان آن را اضافه کنید.
.TP
\fB\-\-force\fR
جایگزینی فایلی در مسیر هدف که توسط mise نوشته نشده است
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SHELL>\fR
نوع پوسته برای تولید تکمیل خودکار.SH "MISE CONFIG"
مدیریت فایل‌های پیکربندی
.PP
\fBکاربرد:\fR mise config [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-no\-header\fR
عدم چاپ سرآیند جدول
.TP
\fB\-\-tracked\-configs\fR
فهرست کردن تمام فایل‌های پیکربندی ردیابی‌شده
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE CONFIG GET"
نمایش مقدار یک تنظیم در فایل mise.toml
.PP
\fBکاربرد:\fR mise config get [OPTIONS] [<KEY>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-file, \-\-path\fR \fI<FILE>\fR
مسیر فایل mise.toml جهت خواندن

می‌تواند مسیر یک فایل یا دایرکتوری باشد. اگر یک دایرکتوری مشخص شود، از فایل پیکربندی درون آن دایرکتوری استفاده می‌شود.

در صورت عدم ارائه، از نزدیک‌ترین فایل mise.toml استفاده خواهد شد
.TP
\fB\-g, \-\-global\fR
خواندن فایل پیکربندی سراسری.
.TP
\fB\-\-system\fR
خواندن فایل پیکربندی سیستمی.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<KEY>\fR
مسیر پیکربندی مورد نظر برای نمایش
.SH "MISE CONFIG LS"
فهرست کردن فایل‌های پیکربندی در حال استفاده
.PP
\fBکاربرد:\fR mise config ls [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-no\-header\fR
عدم چاپ سرآیند جدول
.TP
\fB\-\-tracked\-configs\fR
فهرست کردن تمام فایل‌های پیکربندی ردیابی‌شده
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE CONFIG SET"
تنظیم مقدار یک مشخصه در فایل mise.toml
.PP
\fBکاربرد:\fR mise config set [OPTIONS] <KEY> [<VALUE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-file, \-\-path\fR \fI<FILE>\fR
مسیر فایل mise.toml جهت ویرایش

می‌تواند مسیر یک فایل یا دایرکتوری باشد. اگر یک دایرکتوری مشخص شود، از فایل پیکربندی درون آن دایرکتوری استفاده می‌شود.

در صورت عدم ارائه، از نزدیک‌ترین فایل mise.toml استفاده خواهد شد
.TP
\fB\-g, \-\-global\fR
ویرایش فایل پیکربندی سراسری.
.TP
\fB\-\-system\fR
ویرایش فایل پیکربندی سیستمی.
.TP
\fB\-\-append\fR
افزودن مقدار بدون ایجاد ورودی تکراری.
.TP
\fB\-\-remove\fR
حذف مقدار از یک مجموعه موجود.
.TP
\fB\-t, \-\-type\fR \fI<TYPE>\fR
.RS
\fIپیش‌فرض: \fRinfer
.RE
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<KEY>\fR
مسیر پیکربندی مورد نظر برای نمایش
.TP
\fB<VALUE>\fR
مقداری که کلید باید با آن تنظیم شود (در صورت مشخص شدن به صورت KEY=VALUE اختیاری است).SH "MISE DEACTIVATE"
غیرفعال‌سازی mise برای نشست پوسته فعلی

این دستور می‌تواند برای غیرفعال‌سازی موقت mise در یک نشست پوسته استفاده شود.
.PP
\fBنحوه استفاده:\fR mise deactivate [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE DOCTOR"
بررسی نصب mise برای مشکلات احتمالی
.PP
\fBنحوه استفاده:\fR mise doctor [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE DOCTOR PATH"
چاپ ورودی‌های فعلی PATH که mise فراهم می‌کند
.PP
\fBنحوه استفاده:\fR mise doctor path [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-full\fR
چاپ همه ورودی‌ها شامل مواردی که توسط mise فراهم نشده‌اند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE EN"
شروع یک پوسته جدید با محیط mise ایجادشده بر اساس پیکربندی فعلی

این یک جایگزین برای `mise activate` است که به شما امکان می‌دهد صریحاً یک نشست mise را آغاز کنید.
این نشست ابزارها و متغیرهای محیطی موجود در پیکربندی‌ها را بارگذاری خواهد کرد.
توجه داشته باشید که تغییر دایرکتوری‌ها محیط mise را به‌روزرسانی نخواهد کرد.
.PP
\fBنحوه استفاده:\fR mise en [OPTIONS] [<DIR>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
پوسته برای اجرا

پیش‌فرض: $SHELL
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<DIR>\fR
دایرکتوری برای شروع پوسته در آن
.RS
\fIپیش‌فرض: \fR.
.RE
.SH "MISE ENV"
برون‌ریزی متغیرهای محیطی برای فعال‌سازی یک‌بارهٔ mise

اگر نمی‌خواهید mise را به‌صورت دائمی نصب کنید، از این دستور استفاده کنید. در صورتی که `mise activate` را در فایل rc پوسته خود دارید، نیازی به استفاده از این دستور نیست.
.PP
\fBنحوه استفاده:\fR mise env [OPTIONS] [<TOOL@VERSION>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-D, \-\-dotenv\fR
خروجی در قالب dotenv
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
نوع پوسته برای تولید متغیرهای محیطی برای آن
.TP
\fB\-\-json\-extended\fR
خروجی در قالب JSON با اطلاعات تکمیلی (source، tool)
.TP
\fB\-\-redacted\fR
تنها نمایش متغیرهای محیطی مخدوش‌شده (redacted)
.TP
\fB\-\-values\fR
تنها نمایش مقادیر متغیرهای محیطی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) برای استفاده.SH "MISE EXEC"
اجرای یک دستور به همراه ابزار(های) مشخص‌شده

از این دستور برای جلوگیری از تغییر نشست پوسته یا اجرای دستورهای موردی (ad\-hoc) همراه با ابزارهای تنظیم‌شده mise استفاده کنید.

ابزارها از mise.toml بارگذاری خواهند شد، هرچند می‌توان آن‌ها را با آرگومان‌های <RUNTIME> بازنویسی کرد.
توجه داشته باشید که تنها افزونهٔ مشخص‌شده بازنویسی خواهد شد؛ بنابراین اگر یک فایل `mise.toml` شامل «node 20» باشد ولی شما `mise exec python@3.11` را اجرا کنید، همچنان node@20 بارگذاری خواهد شد.

علامت «\-\-» زمان‌های اجرا (runtimes) را از دستوراتی که باید به زیرپروسه ارسال شوند جدا می‌کند.
.PP
\fBکاربرد:\fR mise exec [OPTIONS] [<TOOL@VERSION>] ... [<COMMAND>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-c, \-\-command\fR \fI<COMMAND>\fR
رشته دستوری برای اجرا
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد وظایف برای اجرای موازی
مقادیر کمتر از ۱ به عنوان ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
.RS
\fIمتغیر محیطی: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-\-allow\-env\fR \fI<VAR>\fR
مجاز کردن عبور متغیر محیطی مشخص (به طور ضمنی به معنای \-\-deny\-env برای سایر متغیرها است)
از نویسه‌های عام (wildcards) پشتیبانی می‌کند، مانند \-\-allow\-env=\(aqMYAPP_*\(aq
.TP
\fB\-\-allow\-net\fR \fI<HOST>\fR
مجاز کردن شبکه به میزبان مشخص (به طور ضمنی به معنای \-\-deny\-net برای سایر موارد است)
در نسخه ۱ فقط مخصوص macOS است؛ در Linux به مجاز بودن کل شبکه بازمی‌گردد
.TP
\fB\-\-allow\-read\fR \fI<PATH>\fR
مجاز کردن خواندن از مسیر مشخص (به طور ضمنی به معنای \-\-deny\-read برای سایر مسیرها است)
.TP
\fB\-\-allow\-write\fR \fI<PATH>\fR
مجاز کردن نوشتن در مسیر مشخص (به طور ضمنی به معنای \-\-deny\-write برای سایر مسیرها است)
.TP
\fB\-\-deny\-all\fR
مسدود کردن خواندن، نوشتن، شبکه و متغیرهای محیطی
.TP
\fB\-\-deny\-env\fR
مسدود کردن ارث‌بری متغیرهای محیطی (تنها متغیرهای PATH، HOME، USER، SHELL، TERM و LANG عبور می‌کنند)
.TP
\fB\-\-deny\-net\fR
مسدود کردن تمامی دسترسی‌های شبکه
.TP
\fB\-\-deny\-read\fR
مسدود کردن خواندن از سیستم‌فایل (کتابخانه‌های سیستم و دایرکتوری‌های ابزار همچنان در دسترس خواهند بود)
.TP
\fB\-\-deny\-write\fR
مسدود کردن تمام عملیات‌های نوشتن روی سیستم‌فایل
.TP
\fB\-\-fresh\-env\fR
دور زدن حافظه موقت (cache) محیط و محاسبهٔ مجدد متغیرهای محیطی
.TP
\fB\-\-no\-deps\fR
صرف‌نظر کردن از آماده‌سازی خودکار وابستگی‌ها
.TP
\fB\-\-raw\fR
اتصال مستقیم ورودی/خروجی/خطای استاندارد (stdin/stdout/stderr) دستور نصب backend به ترمینال؛ به طور ضمنی مقدار \-\-jobs=1 را فعال می‌کند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) برای اجرا؛ برای نمونه: node@20 python@3.10
.TP
\fB<COMMAND>\fR
رشته دستوری برای اجرا (مشابه \-\-command)
.SH "MISE FMT"
قالب‌بندی فایل mise.toml

مرتب‌سازی کلیدها و پاک‌سازی فاصله‌های خالی در mise.toml
.PP
\fBکاربرد:\fR mise fmt [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
قالب‌بندی تمام فایل‌های دایرکتوری فعلی
.TP
\fB\-c, \-\-check\fR
بررسی اینکه آیا پیکربندی‌ها قالب‌بندی شده‌اند یا خیر؛ تغییری اعمال نمی‌شود
.TP
\fB\-s, \-\-stdin\fR
خواندن پیکربندی از ورودی استاندارد (stdin) و نوشتن نسخه قالب‌بندی‌شده در خروجی استاندارد (stdout)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE GENERATE"
تولید فایل‌ها برای ابزارها/سرویس‌های گوناگون
.PP
\fBنحوه استفاده:\fR mise generate [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE GENERATE CONFIG"
تولید یک فایل mise.toml
.PP
\fBنحوه استفاده:\fR mise generate config [OPTIONS] [<PATH>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-g, \-\-global\fR
تولید فایل پیکربندی سراسری (~/.config/mise/config.toml)
.TP
\fB\-n, \-\-dry\-run\fR
نمایش آنچه تولید خواهد شد بدون نوشتن در فایل
.TP
\fB\-t, \-\-tool\-versions\fR \fI<TOOL_VERSIONS>\fR
مسیر یک فایل .tool\-versions جهت وارد کردن ابزارها از آن
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PATH>\fR
مسیر فایل پیکربندی برای ایجاد
.SH "MISE GENERATE DEVCONTAINER"
تولید یک devcontainer برای اجرای mise
.PP
\fBنحوه استفاده:\fR mise generate devcontainer [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-i, \-\-image\fR \fI<IMAGE>\fR
ایمیج مورد استفاده برای devcontainer
.TP
\fB\-m, \-\-mount\-mise\-data\fR
اتصال (bind) حجم mise\-data\-volume به devcontainer
.TP
\fB\-n, \-\-name\fR \fI<NAME>\fR
نام devcontainer
.TP
\fB\-w, \-\-write\fR
نوشتن در .devcontainer/devcontainer.json
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE GENERATE GIT-PRE-COMMIT"
تولید یک هوک pre\-commit برای git

این دستور یک هوک pre\-commit در git تولید می‌کند که هنگام ثبت (commit) تغییرات در مخزن شما، یک تسک mise مانند `mise run pre\-commit` را اجرا می‌کند.

فایل‌های مرحله‌بندی‌شده (staged) به عنوان `STAGED` به تسک ارسال می‌شوند.

برای قابلیت‌های پیشرفته‌تر pre\-commit، پروژه همزاد mise را بررسی کنید: https://hk.jdx.dev
.PP
\fBنحوه استفاده:\fR mise generate git\-pre\-commit [OPTIONS] [<MISE_ARG>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-t, \-\-task\fR \fI<TASK>\fR
تسکی که با فعال شدن هوک pre\-commit اجرا می‌شود
.RS
\fIپیش‌فرض:\& \fRpre\-commit
.RE
.TP
\fB\-w, \-\-write\fR
نوشتن در .git/hooks/pre\-commit و اجرایی کردن آن
.TP
\fB\-\-hook\fR \fI<HOOK>\fR
مشخص می‌کند کدام هوک تولید شود (در .git/hooks/$hook ذخیره می‌شود)
.RS
\fIپیش‌فرض:\& \fRpre\-commit
.RE
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<MISE_ARG>\fR
پرچم‌های mise برای گنجاندن در هوک تولیدشده، که پس از `\-\-` مشخص می‌شوند

این موارد بین `mise` و `run` درج می‌شوند، بنابراین هوک همان زمینه‌ای را حمل می‌کند که در خط فرمان وارد می‌کردید. این ویژگی زمانی مفید است که فایل پیکربندی در ریشه مخزن نباشد، زیرا git هوک‌ها را از بالاترین سطح اجرا می‌کند: استفاده از `\-\- \-C subdir` باعث می‌شود هوک بتواند آن را پیدا کند..SH "MISE GENERATE GITHUB-ACTION"
تولید یک فایل گردش‌کار GitHub Action

این دستور یک فایل گردش‌کار GitHub Action تولید می‌کند که با ارسال تغییرات (push) به مخزن شما، یک تسک mise مانند `mise run ci` را اجرا می‌کند.
.PP
\fBکاربرد:\fR mise generate github\-action [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-t, \-\-task\fR \fI<TASK>\fR
تسکی که با فعال شدن گردش‌کار اجرا می‌شود
.RS
\fIپیش‌فرض: \fRci
.RE
.TP
\fB\-w, \-\-write\fR
نوشتن در .github/workflows/$name.yml
.TP
\fB\-\-name\fR \fI<NAME>\fR
نام گردش‌کار برای تولید
.RS
\fIپیش‌فرض: \fRci
.RE
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE GENERATE INSTALL-SCRIPT"
تولید اسکریپتی برای دانلود و اجرای mise

این دستور برای استفاده در پروژه‌ای طراحی شده است که در آن ممکن است مشارکت‌کنندگان mise را نصب نداشته باشند.

نام آن از `mise generate bootstrap` تغییر یافته است، که به شکل حالتی از `mise bootstrap` (راه‌اندازی ماشین) برداشت می‌شد. نام قدیمی همچنان کار می‌کند اما منسوخ شده است و در نسخه mise 2027.9.0 حذف خواهد شد.
.PP
\fBکاربرد:\fR mise generate install\-script [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-localize\fR
دایرکتوری‌های داخلی mise مانند MISE_DATA_DIR و MISE_CACHE_DIR را درون یک دایرکتوری `.mise` در پروژه ایزوله (sandbox) می‌کند

این مورد در صورتی ضروری است که کاربران ممکن است از نسخه متفاوتی از mise خارج از پروژه استفاده کنند.
.TP
\fB\-V, \-\-version\fR \fI<VERSION>\fR
مشخص کردن نسخه mise جهت دریافت
.TP
\fB\-w, \-\-write\fR \fI<WRITE>\fR
به جای ارسال اسکریپت به stdout، آن را در یک فایل می‌نویسد و اجرایی می‌کند
.TP
\fB\-\-localized\-dir\fR \fI<LOCALIZED_DIR>\fR
دایرکتوری برای قرار دادن داده‌های محلی
.RS
\fIپیش‌فرض: \fR.mise
.RE
.TP
\fB\-\-windows\fR
همچنین یک اجراکننده ویندوز به نام `<WRITE>.cmd` می‌نویسد

ویندوز قادر به اجرای اسکریپت `#!/usr/bin/env bash` نیست، بنابراین مشارکت‌کننده‌ای که پروژه را در ویندوز clone می‌کند، بدون این فایل چیزی برای اجرا نخواهد داشت.

روی تمام میزبان‌ها تولید می‌شود، نه فقط در ویندوز: فایل commit می‌شود و کسی که آن را در ویندوز اجرا می‌کند، فردی نیست که آن را تولید کرده است. نیازمند `\-\-write` است، زیرا stdout نمی‌تواند حامل دو فایل باشد.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE GENERATE TASK-DOCS"
تولید مستندات برای تسک‌ها در یک پروژه
.PP
\fBکاربرد:\fR mise generate task\-docs [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-i, \-\-inject\fR
مستندات را درون یک فایل موجود درج می‌کند

این گزینه به دنبال کامنت ویژه `<!\-\- mise\-tasks \-\->` می‌گردد و آن را با مستندات تولیدشده جایگزین می‌کند.
تمام محتوای بین این کامنت و کامنت بعدی، یعنی `<!\-\- /mise\-tasks \-\->` جایگزین خواهد شد، بنابراین می‌توان آن را چندین بار روی همان فایل برای به‌روزرسانی مستندات اجرا کرد.
فایل باید از قبل حاوی هر دو کامنت باشد؛ در صورت نبود آن‌ها، mise به جای دستکاری فایل، با خطا متوقف می‌شود.
.TP
\fB\-I, \-\-index\fR
تنها فهرستی از تسک‌ها را می‌نویسد، در نظر گرفته شده برای استفاده با `\-\-multi`
.TP
\fB\-m, \-\-multi\fR
رندر کردن هر تسک به عنوان سندی جداگانه، نیازمند این است که `\-\-output` یک دایرکتوری باشد
.TP
\fB\-o, \-\-output\fR \fI<OUTPUT>\fR
مستندات تولیدشده را در یک فایل/دایرکتوری می‌نویسد
.TP
\fB\-r, \-\-root\fR \fI<ROOT>\fR
دایرکتوری ریشه برای جستجوی تسک‌ها
.TP
\fB\-s, \-\-style\fR \fI<STYLE>\fR
.RS
\fIپیش‌فرض: \fRsimple
.RE
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE GENERATE TASK-STUBS"
تولید شیم‌ها برای اجرای تسک‌های mise

به‌طور پیش‌فرض، این دستور شیم‌هایی مانند ./bin/<task> را می‌سازد. این شیم‌ها می‌توانند با `mise generate install\-script` جفت شوند تا مشارکت‌کنندگان یک پروژه بتوانند بدون نیاز به نصب mise روی سیستم خود، تسک‌های mise را اجرا کنند.
هنگامی که هر دو تسک والد و تو در تو وجود داشته باشند، استاب والد در `<parent>/_default` نوشته می‌شود.
.PP
\fBکاربرد:\fR mise generate task\-stubs [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-d, \-\-dir\fR \fI<DIR>\fR
دایرکتوری برای ایجاد استاب‌های تسک در داخل آن
.RS
\fIپیش‌فرض: \fRbin
.RE
.TP
\fB\-m, \-\-mise\-bin\fR \fI<MISE_BIN>\fR
مسیر باینری mise برای استفاده هنگام اجرای استاب تسک.

برای استفاده از باینری mise تولید شده توسط `mise generate install\-script` از `\-\-mise\-bin=./bin/mise` استفاده کنید

در Windows یک مسیر همان‌طور که نوشته شده اجرا می‌شود، بنابراین آن اسکریپت به لانچر اختصاصی خود در کنارش نیاز دارد:
آن را با `mise generate install\-script \-\-write ./bin/mise \-\-windows` تولید کنید. مقدار پیش‌فرض
`mise` یک نام خالی است و از طریق PATH شناسایی می‌شود، که به چیز اضافه‌ای نیاز ندارد.
.RS
\fIپیش‌فرض: \fRmise
.RE
.TP
\fB\-\-windows\-launcher\fR \fI<WINDOWS_LAUNCHER>\fR
آنچه باید در کنار هر استاب برای راه‌اندازی در Windows نوشته شود

مقدار `cmd` فایل `<task>.cmd` را می‌نویسد. برنامه cmd.exe قبل از بسط یافتن `%*` کل خط را دوباره تجزیه می‌کند، بنابراین اگر لانچر از PowerShell فراخوانی شود، آرگومانی که شامل `& ^ | " %VAR%` باشد به صورت دست‌نخورده به تسک نمی‌رسد.

مقدار `exe` در عوض یک فایل بومی `<task>.exe` می‌نویسد که آرگومان‌های خود را از هر پوسته‌ای بدون تغییر دریافت می‌کند. این یک کپی از mise\-shim.exe است که همراه با ساخت Windows عرضه می‌شود، بنابراین فقط در Windows قابل تولید است و به ازای هر تسک حدود ۲۲۰ کیلوبایت به دایرکتوری‌ای اضافه می‌کند که معمولاً کامیت می‌شود.
.RS
\fIپیش‌فرض: \fRcmd
.RE
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE GENERATE TOOL-STUB"
تولید یک استاب ابزار برای ابزارهای مبتنی بر HTTP

این دستور استاب‌های ابزاری را تولید می‌کند که می‌توانند به‌طور خودکار ابزارها را از نشانی‌های HTTP دانلود و اجرا کنند. این دستور می‌تواند با دانلود و تجزیه‌وتحلیل ابزار، چکسام‌ها، اندازه‌های فایل و مسیرهای باینری را به‌طور خودکار شناسایی کند.

هنگام تولید استاب‌ها با نشانی‌های مختص پلتفرم، این دستور به جای بازنویسی فایل‌های استاب موجود، پلتفرم‌های جدید را به آن‌ها اضافه می‌کند. این ویژگی به شما امکان می‌دهد استاب‌های ابزار چندپلتفرمی را به‌صورت تدریجی بسازید.
.PP
\fBکاربرد:\fR mise generate tool\-stub [OPTIONS] <OUTPUT>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-b, \-\-bin\fR \fI<BIN>\fR
مسیر باینری درون آرشیو استخراج‌شده

اگر مشخص نشده باشد و آرشیو دانلود شود، محتمل‌ترین باینری به‌طور خودکار شناسایی خواهد شد
.TP
\fB\-\-bootstrap\fR
قراردادن استاب در یک اسکریپت راه‌انداز (bootstrap) که در صورت عدم وجود mise، آن را نصب می‌کند

در صورت فعال بودن، یک اسکریپت bash تولید می‌کند که:
1. بررسی می‌کند آیا mise در مسیر مورد انتظار نصب شده است یا خیر
2. در غیر این صورت، mise را با استفاده از نصاب تعبیه‌شده دانلود و نصب می‌کند
3. استاب ابزار را با استفاده از mise اجرا می‌کند
.TP
\fB\-\-bootstrap\-version\fR \fI<BOOTSTRAP_VERSION>\fR
مشخص کردن نسخه mise برای اسکریپت راه‌انداز

به‌طور پیش‌فرض، از آخرین نسخه موجود در اسکریپت نصب استفاده می‌کند.
از این گزینه برای تثبیت روی یک نسخه مشخص (مثلاً "2025.1.0") استفاده کنید.
.TP
\fB\-\-checksum\-algorithm\fR \fI<CHECKSUM_ALGORITHM>\fR
الگوریتم چکسام برای استفاده هنگام دانلود مصنوعات

مقادیر `blake3` یا `sha256` را می‌پذیرد و مقدار پیش‌فرض آن `blake3` است. نمی‌توان از آن همراه با `\-\-lock` یا `\-\-skip\-download` استفاده کرد زیرا آن حالت‌ها چکسام را محاسبه نمی‌کنند.
.RS
\fIپیش‌فرض: \fRblake3
.RE
.TP
\fB\-\-fetch\fR
دریافت چکسام‌ها و اندازه‌ها برای یک فایل استاب ابزار موجود

این گزینه یک فایل استاب موجود را خوانده و با دانلود فایل‌ها، هر فیلد ناموجود چکسام/اندازه را تکمیل می‌کند. نشانی‌های وب باید از قبل در استاب وجود داشته باشند.
.TP
\fB\-\-http\fR \fI<HTTP>\fR
نوع بَک‌اند HTTP برای استفاده
.RS
\fIپیش‌فرض: \fRhttp
.RE
.TP
\fB\-\-lock\fR
بررسی و جاسازی داده‌های lockfile (نسخه دقیق + نشانی‌ها/چکسام‌های پلتفرم) در یک فایل استاب موجود برای نصب‌های بازتولیدپذیر بدون فراخوانی‌های API در زمان اجرا
.TP
\fB\-\-platform\-bin\fR \fI<PLATFORM_BIN>\fR
مسیرهای باینری مختص پلتفرم در قالب platform:path

مثال‌ها: \-\-platform\-bin windows\-x64:tool.exe \-\-platform\-bin linux\-x64:bin/tool
.TP
\fB\-\-platform\-url\fR \fI<PLATFORM_URL>\fR
نشانی‌های وب مختص پلتفرم در قالب platform:url یا فقط url (تشخیص خودکار پلتفرم)

هنگامی که فایل خروجی از قبل موجود باشد، پلتفرم‌های جدید به جدول پلتفرم‌های موجود اضافه می‌شوند. نشانی‌های پلتفرم موجود در صورت مشخص شدن مجدد، به‌روزرسانی خواهند شد.

اگر تنها یک نشانی وب مشخص شود (بدون platform:)، پلتفرم به‌طور خودکار از نام فایل نشانی وب تشخیص داده می‌شود.

مثال‌ها: \-\-platform\-url linux\-x64:https://... \-\-platform\-url https://nodejs.org/dist/v22.17.1/node\-v22.17.1\-darwin\-arm64.tar.gz
.TP
\fB\-\-skip\-download\fR
صرف‌نظر کردن از دانلود برای تشخیص چکسام و مسیر باینری (سریع‌تر اما با اطلاعات کمتر)
.TP
\fB\-u, \-\-url\fR \fI<URL>\fR
نشانی وب برای دانلود ابزار

مثال: https://github.com/owner/repo/releases/download/v2.0.0/tool\-linux\-x64.tar.gz
.TP
\fB\-\-version\fR \fI<VERSION>\fR
نسخه ابزار
.RS
\fIپیش‌فرض: \fRlatest
.RE
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<OUTPUT>\fR
مسیر فایل خروجی برای استاب ابزار.SH "MISE IMPLODE"
ابزار خط فرمان mise و تمام داده‌های مرتبط با آن را حذف می‌کند

به‌طور پیش‌فرض از دایرکتوری پیکربندی صرف‌نظر می‌کند.
.PP
\fBنحوه استفاده:\fR mise implode [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
فهرست کردن دایرکتوری‌هایی که حذف خواهند شد، بدون حذف واقعی آن‌ها
.TP
\fB\-\-config\fR
حذف دایرکتوری پیکربندی نیز
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE EDIT"
ویرایش تعاملی mise.toml
.PP
\fBنحوه استفاده:\fR mise edit [OPTIONS] [<PATH>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-g, \-\-global\fR
ویرایش فایل پیکربندی سراسری (~/.config/mise/config.toml)
.TP
\fB\-n, \-\-dry\-run\fR
نمایش آنچه بدون نوشتن در فایل تولید می‌شود
.TP
\fB\-t, \-\-tool\-versions\fR \fI<TOOL_VERSIONS>\fR
مسیر فایل .tool\-versions برای وارد کردن ابزارها از آن
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PATH>\fR
مسیر فایل پیکربندی برای ایجاد
.SH "MISE INSTALL"
نصب یک نسخه از ابزار

نسخهٔ ابزار را در `~/.local/share/mise/installs/<TOOL>/<VERSION>` نصب می‌کند
نصب به‌تنهایی ابزارها را فعال نمی‌کند، بنابراین در PATH قرار نخواهند گرفت.
برای نصب و/یا فعال‌سازی در یک دستور، از `mise use` استفاده کنید که یک فایل `mise.toml`
در دایرکتوری فعلی ایجاد می‌کند تا ابزار هنگام حضور در این دایرکتوری فعال شود.
همچنین، می‌توانید `mise exec <TOOL>@<VERSION> \-\- <COMMAND>` را برای اجرای یک ابزار بدون ایجاد فایل‌های پیکربندی اجرا کنید.

ابزارها به‌صورت موازی نصب خواهند شد. برای غیرفعال کردن، `\-\-jobs=1` یا `MISE_JOBS=1` را تنظیم کنید
.PP
\fBنحوه استفاده:\fR mise install [OPTIONS] [<TOOL@VERSION>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
نصب مجدد اجباری حتی در صورت نصب بودن از قبل
در صورت مشخص نشدن هیچ ابزاری، تمام ابزارهای پیکربندی‌شده مجدداً نصب می‌شوند
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارهای موازی برای اجرا
مقادیر کمتر از ۱ معادل ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
.RS
\fIمتغیر محیطی: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-n, \-\-dry\-run\fR
نمایش آنچه که نصب خواهد شد بدون نصب واقعی آن
.TP
\fB\-v, \-\-verbose\fR
نمایش خروجی نصب

این آرگومان خروجی پس‌زمینه (backend) مانند خروجی‌های دانلود، پیکربندی و کامپایل را چاپ می‌کند.
.TP
\fB\-\-dry\-run\-code\fR
مشابه \-\-dry\-run است، اما در صورتی که ابزارهایی برای نصب وجود داشته باشد با کد ۱ خارج می‌شود

این گزینه برای اسکریپت‌ها جهت بررسی نیاز به نصب ابزارها مفید است.
.TP
\fB\-\-include\-task\-tools\fR
ابزارهای مورد نیاز وظایف (tasks) در محدودهٔ فعلی را نیز نصب می‌کند

این گزینه ابزارهای وظیفه را بدون اجرای دستورات یا وابستگی‌های وظایف آماده می‌کند.
با \-\-monorepo ترکیب کنید تا وظایف مربوط به همهٔ ریشه‌های پیکربندی‌شده لحاظ شوند.
.TP
\fB\-\-include\-lazy\fR
ابزارهای پیکربندی‌شده با `lazy = true` را نیز نصب می‌کند

به‌طور پیش‌فرض، دستور سادهٔ `mise install` ابزارهای lazy را برای نصب در زمان اجرای نخستین دستور باقی می‌گذارد.
.TP
\fB\-\-minimum\-release\-age\fR \fI<MINIMUM_RELEASE_AGE>\fR
تنها نسخه‌هایی را نصب می‌کند که قبل از این تاریخ منتشر شده یا قدیمی‌تر از این مدت‌زمان باشند

از تاریخ‌های مطلق مانند "2024\-06\-01" و مدت‌زمان‌های نسبی مانند "90d" یا "1y" پشتیبانی می‌کند.
.TP
\fB\-\-monorepo\fR
نصب ابزارها از هر ریشهٔ پیکربندی [monorepo].config_roots

از MISE_ENV فعال استفاده می‌کند و به monorepo_root = true به‌همراه [monorepo].config_roots صریح در پیکربندی ریشهٔ monorepo نیاز دارد.
.RS
\fIمتغیر محیطی: \fR\fBMISE_MONOREPO\fR
.RE
.TP
\fB\-\-raw\fR
اتصال مستقیم stdin/stdout/stderr دستور نصب backend به ترمینال؛ متضمن \-\-jobs=1 است
.TP
\fB\-\-shared\fR \fI<SHARED>\fR
نصب ابزار(ها) در یک دایرکتوری اشتراکی

به‌جای مکان نصب پیش‌فرض، در دایرکتوری مشخص‌شده نصب می‌کند.
بسته به مسیر ممکن است به دسترسی‌های بالاتری نیاز داشته باشد.
.TP
\fB\-\-system\fR
نصب ابزار(ها) در دایرکتوری اشتراکی در سطح کل سیستم

در /usr/local/share/mise/installs (یا MISE_SYSTEM_DATA_DIR/installs) نصب می‌کند.
ممکن است به دسترسی‌های سطح بالا (مانند sudo) نیاز داشته باشد.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) برای نصب؛ به عنوان مثال: node@20.SH "MISE INSTALL-INTO"
نصب نسخه یک ابزار در یک مسیر مشخص

جهت ساخت یک ابزار در یک دایرکتوری برای استفاده در خارج از mise به کار می‌رود
.PP
\fBکاربرد:\fR mise install\-into [OPTIONS] <TOOL@VERSION> <PATH>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار جهت نصب، به عنوان مثال: node@20
.TP
\fB<PATH>\fR
مسیری که ابزار باید در آن نصب شود
.SH "MISE LATEST"
دریافت آخرین نسخه موجود برای یک پلاگین

از پیشوندهایی مانند `node@20` برای دریافت آخرین نسخه node 20 پشتیبانی می‌کند.
.PP
\fBکاربرد:\fR mise latest [OPTIONS] <TOOL@VERSION> [<ASDF_VERSION>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-i, \-\-installed\fR
نمایش آخرین نسخه نصب‌شده به جای نسخه موجود
.TP
\fB\-\-minimum\-release\-age\fR \fI<MINIMUM_RELEASE_AGE>\fR
تنها در نظر گرفتن نسخه‌هایی که پیش از این تاریخ منتشر شده‌اند یا قدمتی بیشتر از این بازه زمانی دارند

از تاریخ‌های مطلق مانند "2024\-06\-01" و بازه‌های زمانی نسبی مانند "90d" یا "1y" پشتیبانی می‌کند.
بر گزینه‌های `minimum_release_age` هر ابزار و تنظیم سراسری `minimum_release_age` اولویت دارد.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزاری که آخرین نسخه آن دریافت می‌شود
.TP
\fB<ASDF_VERSION>\fR
پیشوند نسخه برای استفاده در هنگام پرس‌وجوی آخرین نسخه؛ مشابه با اولین آرگومان پس از "@" که برای سازگاری با asdf استفاده می‌شود
.SH "MISE LINK"
ایجاد پیوند نمادین (symlink) از نسخه یک ابزار به درون mise

برای افزودن مواردی که خارج از mise به صورت سفارشی کامپایل شده یا با ابزار دیگری ساخته شده‌اند استفاده می‌شود.
.PP
\fBکاربرد:\fR mise link [OPTIONS] <TOOL@VERSION> <PATH>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
بازنویسی نسخه موجود ابزار در صورت وجود
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
نام و نسخه ابزار جهت ایجاد پیوند نمادین
.TP
\fB<PATH>\fR
مسیر محلی به نسخه ابزار
به عنوان مثال: ~/.nvm/versions/node/v20.0.0
.SH "MISE LOCK"
به‌روزرسانی مجموع‌های وارسی (checksum) و نشانی‌های URL فایل قفل برای تمام پلتفرم‌های مشخص‌شده

مجموع‌های وارسی و نشانی‌های URL بارگیری را برای تمامی پلتفرم‌هایی که از قبل در lockfile مشخص شده‌اند به‌روزرسانی می‌کند.
اگر هیچ lockfile وجود نداشته باشد، آنچه را که بر اساس پیکربندی فعلی (شامل ابزارهای تعریف‌شده توسط وظایف) ایجاد می‌شود نمایش می‌دهد.
این به شما امکان می‌دهد تا داده‌های lockfile را برای پلتفرم‌هایی غیر از پلتفرمی که هم‌اکنون روی آن هستید بازآوری کنید.
روی lockfile در ریشه پیکربندی فعلی عمل می‌کند. از آرگومان‌های TOOL برای هدف قرار دادن ابزارهای مشخص استفاده کنید.
.PP
\fBکاربرد:\fR mise lock [OPTIONS] [<TOOL>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-g, \-\-global\fR
تنها فایل‌های قفل پیکربندی سراسری را هدف قرار می‌دهد (~/.config/mise/mise.lock و پیکربندی سیستم)
به‌طور پیش‌فرض، تنها ریشه پیکربندی پروژه فعال قفل می‌شود
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارهایی که به صورت موازی اجرا می‌شوند
مقادیر کمتر از ۱ به عنوان ۱ در نظر گرفته می‌شوند
.RS
\fIمتغیر محیطی: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-n, \-\-dry\-run\fR
نمایش مواردی که بدون اعمال تغییرات، به‌روزرسانی خواهند شد
.TP
\fB\-p, \-\-platform\fR \fI<PLATFORM>\fR
فهرست جداشده با کاما از پلتفرم‌های هدف
به عنوان مثال: linux\-x64,macos\-arm64,windows\-x64
در صورت مشخص نشدن، تمام پلتفرم‌های موجود در lockfile به‌روزرسانی خواهند شد
.TP
\fB\-\-bump\fR
حل مجدد انتخاب‌کننده‌های فازی نسخه در برابر آخرین نسخه‌های موجود

به‌طور پیش‌فرض، `mise lock` متاداده‌های نسخه‌های قفل‌شده فعلی را بازآوری می‌کند.
با این پرچم، انتخاب‌کننده‌هایی مانند "latest"، "lts" یا پیشوندهایی مانند "20" مجدداً در برابر آخرین نسخه‌های راه دور منطبق بازسنجی می‌شوند، بنابراین lockfile بدون نصب هیچ موردی به جلو حرکت می‌کند. فایل‌های پیکربندی هرگز تغییر نمی‌کنند: نسخه‌هایی که دقیقاً پین شده‌اند به خودشان حل شده و بدون تغییر باقی می‌مانند (از `mise upgrade \-\-bump` برای بازنویسی پین‌ها در mise.toml استفاده کنید).
.TP
\fB\-\-json\fR
نمایش تغییرات نسخه در قالب JSON

آرایه‌ای از اشیاء را چاپ می‌کند که تغییرات نسخه lockfile را توصیف می‌کنند:
name، backend، lockfile، old_versions، new_versions.
فهرست‌های نسخه ترتیب پیکربندی/lockfile را حفظ می‌کنند؛ آنها مرتب‌سازی نمی‌شوند.
تنها تغییرات در سطح نسخه گزارش می‌شوند: بازآوری مجموع‌های وارسی/نشانی‌های URL برای نسخه‌های بدون تغییر ورودی ایجاد نمی‌کند، بنابراین اجرای ساده `mise lock \-\-json` معمولاً در عین به‌روزرسانی lockfile مقدار `[]` را چاپ می‌کند.
خروجی انسان‌خوانا را لغو می‌کند. برای تشخیص به‌روزرسانی‌های موجود بدون نوشتن lockfile، با `\-\-dry\-run` ترکیب کنید.
.TP
\fB\-\-local\fR
به‌روزرسانی mise.local.lock به جای mise.lock
برای ابزارهای تعریف‌شده در پیکربندی‌های .local.toml استفاده می‌شود
.TP
\fB\-\-minimum\-release\-age\fR \fI<MINIMUM_RELEASE_AGE>\fR
فقط نسخه‌هایی را قفل می‌کند که قبل از این مدت یا تاریخ منتشر شده باشند

از تاریخ‌های مطلق مانند "2024\-06\-01" و بازه‌های زمانی نسبی مانند "90d" یا "1y" پشتیبانی می‌کند.
این تنها روی تطبیق‌های فازی نسخه مانند "20" یا "latest" تأثیر می‌گذارد.
نسخه‌های صراحتاً پین‌شده مانند "22.5.0" پالایش نمی‌شوند.
مدخل‌های منطبق موجود در lockfile حفظ می‌شوند و صرفاً با این پرچم تنزل نمی‌یابند.
.TP
\fB\-\-upgrade\fR
ارتقای lockfileهای قدیمی به آخرین قالب

lockfileهای بدون نسخه موجود از نسخه قالب ۰ استفاده می‌کنند و برای جلوگیری از انحراف ناخواسته lockfile دست‌نخورده باقی می‌مانند. این پرچم آنها را به آخرین قالب با اتصالات نسخه ویژه هر درخواست ارتقا می‌دهد.
ارتقای قالب همیشه تمام ابزارهای پیکربندی‌شده را پردازش می‌کند و نمی‌توان آن را با آرگومان‌های ابزار ترکیب کرد.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
ابزار(ها) جهت به‌روزرسانی در lockfile
به عنوان مثال: node python
در صورت مشخص نشدن، تمام ابزارهای پیکربندی‌شده و ویژه وظایف به‌روزرسانی خواهند شد.SH "MISE LS"
فهرست کردن نسخه‌های نصب‌شده و فعال ابزارها

این دستور ابزارهایی را فهرست می‌کند که mise «می‌شناسد».
این ابزارها ممکن است در حال حاضر نصب شده باشند، یا مواردی باشند
که در یک فایل پیکربندی قرار دارند (فعال هستند) اما ممکن است نصب شده باشند یا خیر.

دستوری کاربردی برای دریافت وضعیت فعلی ابزارهای شما است.
.PP
\fBنحوه استفاده:\fR mise ls [OPTIONS] [<INSTALLED_TOOL>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-c, \-\-current\fR
تنها نسخه‌های ابزاری را نمایش می‌دهد که در حال حاضر در یک mise.toml مشخص شده‌اند
.TP
\fB\-g, \-\-global\fR
تنها نسخه‌های ابزاری را نمایش می‌دهد که در حال حاضر در mise.toml سراسری مشخص شده‌اند
.TP
\fB\-i, \-\-installed\fR
تنها نسخه‌های ابزاری را که نصب شده‌اند نمایش می‌دهد (ابزارهای تعریف‌شده در mise.toml که نصب نشده‌اند را پنهان می‌کند)
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-l, \-\-local\fR
تنها نسخه‌های ابزاری را نمایش می‌دهد که در حال حاضر در mise.toml محلی مشخص شده‌اند
.TP
\fB\-m, \-\-missing\fR
نمایش نسخه‌های ناموجود ابزارها
.TP
\fB\-o, \-\-offline\fR
اطلاعاتی مانند نسخه‌های قدیمی را واکشی نمی‌کند
.TP
\fB\-p, \-\-plugin\fR \fI<PLUGIN>\fR
.TP
\fB\-\-all\-sources\fR
نمایش همهٔ منابع پیکربندی ردیابی‌شده برای ابزارها
.TP
\fB\-\-monorepo\fR
فهرست کردن ابزارها از هر ریشهٔ پیکربندی [monorepo].config_roots

از MISE_ENV فعال استفاده می‌کند و به monorepo_root = true به‌همراه [monorepo].config_roots صریح در پیکربندی ریشهٔ monorepo نیاز دارد.
.RS
\fIمحیط: \fR\fBMISE_MONOREPO\fR
.RE
.TP
\fB\-\-no\-header\fR
سرآیندها را نمایش نمی‌دهد
.TP
\fB\-\-outdated\fR
نمایش اینکه آیا یک نسخه قدیمی است یا خیر
.TP
\fB\-\-prefix\fR \fI<PREFIX>\fR
نسخه‌های منطبق با این پیشوند را نمایش می‌دهد
.TP
\fB\-\-prunable\fR
تنها ابزارهایی را فهرست می‌کند که با `mise prune` قابل پاک‌سازی هستند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<INSTALLED_TOOL>\fR
تنها نسخه‌های ابزار مربوط به [TOOL] را نمایش می‌دهد
.SH "MISE LS-REMOTE"
فهرست کردن نسخه‌های زمان اجرا (runtime) موجود برای نصب.

توجه داشته باشید که ممکن است نتایج کَش شده باشند؛ برای پاک کردن کَش و دریافت نتایج تازه، `mise cache clean` را اجرا کنید.
.PP
\fBنحوه استفاده:\fR mise ls\-remote [OPTIONS] [<TOOL@VERSION>] [<PREFIX>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-all\fR
نمایش همهٔ افزونه‌ها و نسخه‌های نصب‌شده
.TP
\fB\-\-minimum\-release\-age\fR \fI<MINIMUM_RELEASE_AGE>\fR
تنها نسخه‌هایی را نمایش می‌دهد که پیش از این سن یا تاریخ منتشر شده‌اند

از تاریخ‌های مطلق مانند "2024\-06\-01" و مدت‌زمان‌های نسبی مانند "90d" یا "1y" پشتیبانی می‌کند.
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON (شامل فراداده‌های نسخه مانند برچسب‌های زمانی created_at در صورت موجود بودن)
.TP
\fB\-\-no\-versions\-host\fR
بررسی میزبان mise\-versions را غیرفعال می‌کند
.TP
\fB\-\-prerelease\fR
گنجاندن نسخه‌های پیش‌انتشار در خروجی برای بک‌اندهایی که فراداده‌های پیش‌انتشار بالادست را گزارش می‌دهند یا تشخیص پیش‌انتشار مبتنی بر regex را فعال کرده‌اند. معادل با تنظیم `MISE_PRERELEASES=1` یا تنظیم `prereleases` در طول مدت اجرای این دستور.
.TP
\fB\-\-strict\-metadata\fR
در صورت شکست در واکشی فراداده‌های انتشار، با خطا مواجه می‌شود

نیازمند \-\-json و \-\-no\-versions\-host است.

این گزینه مانع از آن می‌شود که مصرف‌کنندگان فراداده، هنگام شکست درخواست بالادستِ تولیدکنندهٔ فراداده در یک بک‌اند، نتایج خالی جایگزین (fallback) را بپذیرند.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزاری که نسخه‌های آن دریافت می‌شود
.TP
\fB<PREFIX>\fR
پیشوند نسخه برای استفاده هنگام پرس‌وجوی آخرین نسخه؛
همانند بخش پس از «@» در آرگومان اول.SH "MISE MCP"
اجرای کارساز Model Context Protocol (MCP)

این دستور یک کارساز MCP را راه‌اندازی می‌کند که قابلیت‌های mise را
از طریق stdin/stdout و با استفاده از پروتکل JSON\-RPC در اختیار دستیارهای هوش مصنوعی قرار می‌دهد.

کارساز MCP دسترسی به موارد زیر را فراهم می‌کند:
\- ابزارهای نصب‌شده و در دسترس
\- تعاریف و اجرای تسک‌ها
\- متغیرهای محیطی
\- اطلاعات پیکربندی
\- اجرای تسک از طریق ابزار run_task

منابع در دسترس:
\- mise://tools \- فهرست کردن همه ابزارها (از ?include_inactive=true برای گنجاندن ابزارهای غیرفعال استفاده کنید)
\- mise://tasks \- فهرست کردن همه تسک‌ها به همراه پیکربندی‌هایشان
\- mise://env \- فهرست کردن همه متغیرهای محیطی
\- mise://config \- نمایش فایل‌های پیکربندی و ریشه پروژه

ابزارهای در دسترس:
\- list_commands \- تمام دستورات mise، به همراه تأثیر اعلام‌شده آن‌ها بر سیستم
\- install_tool \- نصب یک ابزار با نگارش اختیاری (هنوز پیاده‌سازی نشده است)
\- run_task \- اجرای یک تسک mise با آرگومان‌های اختیاری

نکته: این قابلیت در درجه اول برای یکپارچه‌سازی با دستیارهای هوش مصنوعی مانند Claude،
Cursor یا سایر ابزارهایی که از Model Context Protocol پشتیبانی می‌کنند طراحی شده است.
.PP
\fBکاربرد:\fR mise mcp [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE OCI"
[آزمایشی] ساخت ایمیج‌های کانتینر OCI از یک mise.toml

هر ابزار به یک لایه OCI مجزا تبدیل می‌شود، بنابراین ارتقای هر نگارشِ تکیِ ابزار
تنها یک حباب (blob) با آدرس‌دهی مبتنی بر محتوا را باطل می‌کند — برخلاف Dockerfile که
در آن تغییر یک دستور اولیه `RUN`، تمام لایه‌های بعدی را باطل می‌سازد.

این دستور آزمایشی است و به `mise settings experimental=true`
(یا `MISE_EXPERIMENTAL=1`) نیاز دارد. رفتار، پرچم‌ها و ساختار خروجی ممکن است
در انتشار‌های آینده تغییر کنند.
.PP
\fBکاربرد:\fR mise oci [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE OCI BUILD"
[آزمایشی] ساخت یک ایمیج OCI از mise.toml کنونی

نگارش هر ابزار به یک لایه OCI مجزا با آدرس‌دهی مبتنی بر محتوا تبدیل می‌شود. ارتقای نگارش
یک ابزار تنها لایه همان ابزار را باطل می‌کند — سایر ابزارها، ایمیج پایه
و پیکربندی بدون تغییر دوباره استفاده می‌شوند. دایرکتوری خروجی با
مشخصات OCI image\-layout مطابقت دارد و می‌تواند توسط `skopeo`، `crane` یا
`podman load` استفاده شود.

نیازمند `mise settings experimental=true` (یا `MISE_EXPERIMENTAL=1`).
.PP
\fBکاربرد:\fR mise oci build [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-copy\fR \fI<HOST_PATH:IMAGE_PATH>\fR
کپی کردن یک فایل، دایرکتوری یا پیوند نمادینِ میزبان به درون ایمیج (قابل تکرار، HOST:IMAGE)
.TP
\fB\-o, \-\-output\fR \fI<OUTPUT>\fR
دایرکتوری خروجی برای چیدمان ایمیج OCI
.RS
\fIپیش‌فرض: \fR./mise\-oci
.RE
.TP
\fB\-\-from\fR \fI<FROM>\fR
مرجع ایمیج پایه (بازنویسی [oci].from و تنظیم oci.default_from)
.TP
\fB\-\-include\-global\fR
گنجاندن ابزارها از پیکربندی سراسری / سیستمی (پیش‌فرض: فقط پروژه)

به‌طور پیش‌فرض `mise oci build` تنها ابزارهای تعریف‌شده در پیکربندی mise پروژه (و هرگونه پیکربندی والد در ریشه پروژه یا زیر آن، مانند پیکربندی ریشه monorepo) را بسته‌بندی می‌کند. ابزارهای توسعه شخصی در `~/.config/mise/config.toml` مستثنی می‌شوند تا در ایمیج پروژه تعبیه نشوند. برای بازگشت به رفتار پیشین یعنی «ادغام همه پیکربندی‌های بارگذاری‌شده»، پرچم `\-\-include\-global` را ارسال کنید.
.TP
\fB\-t, \-\-tag\fR \fI<TAG>\fR
برچسب برای ثبت در نمایه (index) ایمیج (یادداشت org.opencontainers.image.ref.name)
.TP
\fB\-\-mount\-point\fR \fI<MOUNT_POINT>\fR
محل قرارگیری ابزارهای نصب‌شده درون ایمیج (پیش‌فرض: /mise)
.TP
\fB\-\-no\-mise\fR
عدم تعبیه باینری در حال اجرای mise در /usr/local/bin/mise
.TP
\fB\-\-owner\fR \fI<UID[:GID]>\fR
مقدار UID[:GID] برای انتساب به هر مدخل tar در لایه‌های تولیدشده

تنظیمات [oci].user_id / [oci].group_id را بازنویسی می‌کند. مقدار پیش‌فرض 0:0 است. اگر GID حذف شود، به‌طور پیش‌فرض برابر با UID در نظر گرفته می‌شود. این گزینه تنها بر مالکیت فایل اثر می‌گذارد؛ مقدار [oci].user دستورالعمل USER در ایمیج را کنترل می‌کند.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE OCI PUSH"
[آزمایشی] ساخت یک ایمیج OCI و ارسال (push) آن به یک رجیستری

با کلاینت رجیستری توکار mise ارسال می‌شود — نیازی به skopeo/crane/docker نیست.
اگر `\-\-image\-dir` داده نشود، ابتدا یک ساخت تازه بر مبنای mise.toml کنونی
انجام می‌شود. تنها blobهایی که هنوز در رجیستری وجود ندارند بارگذاری می‌شوند،
بنابراین pushهای مکرر برای مجموعه‌ابزارهای عمدتاً بدون تغییر کم‌هزینه خواهند بود.

لایه‌های ابزاری که ابزار، نسخه، نقطه اتصال (mount point) و مالک فایل آن‌ها با
ایمیج قبلاً ارسال‌شده (یا `\-\-cache\-from`) یکسان باشد، بدون نیاز به ساخت مجدد دوباره
استفاده می‌شوند — این ابزارها حتی نیازی به نصب محلی ندارند. برای اجبار به
ساخت کامل محلی، گزینه `\-\-no\-cache` را مشخص کنید.

اطلاعات احراز هویت از همان مکان‌هایی که docker و podman استفاده می‌کنند خوانده می‌شود:
`$REGISTRY_AUTH_FILE`، `$XDG_RUNTIME_DIR/containers/auth.json`،
`~/.config/containers/auth.json` و `~/.docker/config.json`
(شامل دستیاران احراز هویت) — بنابراین تنها پیکربندی مورد نیاز،
اجرای `docker login` یا `podman login` است.

نیازمند `mise settings experimental=true` (یا `MISE_EXPERIMENTAL=1`) است.
.PP
\fBکاربرد:\fR mise oci push [OPTIONS] <REF>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-cache\-from\fR \fI<REF>\fR
استفاده مجدد از لایه‌های ابزار بدون تغییر از این ایمیج به‌جای ref مقصد

باید در همان مخزن مقصد قرار داشته باشد. زمانی مفید است که هر push یک تگ یکتا دریافت کند (مانند تگ‌های به ازای هر کامیت در CI): `\-\-cache\-from ghcr.io/me/dev:latest ghcr.io/me/dev:$SHA`.
.TP
\fB\-\-from\fR \fI<FROM>\fR
ایمیج پایه برای ساخت (با \-\-image\-dir نادیده گرفته می‌شود)
.TP
\fB\-\-image\-dir\fR \fI<IMAGE_DIR>\fR
ارسال ساختار ایمیج OCI از پیش ساخته‌شده (صرف‌نظر کردن از مرحله ساخت)
.TP
\fB\-\-include\-global\fR
شامل کردن ابزارهای پیکربندی سراسری / سیستمی نیز می‌شود (پیش‌فرض: فقط پروژه)

برای جزئیات به `mise oci build \-\-help` مراجعه کنید.
.TP
\fB\-\-mount\-point\fR \fI<MOUNT_POINT>\fR
بازنویسی نقطه اتصال درون ایمیج (با \-\-image\-dir نادیده گرفته می‌شود)
.TP
\fB\-\-no\-cache\fR
عدم استفاده مجدد از لایه‌های ابزار ایمیج ارسال‌شده قبلی
.TP
\fB\-\-no\-mise\fR
عدم تعبیه باینری mise (با \-\-image\-dir نادیده گرفته می‌شود)
.TP
\fB\-\-owner\fR \fI<UID[:GID]>\fR
اختصاص UID[:GID] به هر ورودی tar هنگام ساخت (با \-\-image\-dir تداخل دارد)

تنظیمات [oci].user_id و [oci].group_id را بازنویسی می‌کند. پیش‌فرض 0:0 است. اگر GID حذف شود، به‌طور پیش‌فرض به UID تنظیم می‌شود. این گزینه فقط بر مالکیت فایل اثر می‌گذارد؛ دستورالعمل USER ایمیج توسط [oci].user کنترل می‌شود.
.TP
\fB\-\-update\-index\fR
نگهداری تگ به‌صورت یک نمایه ایمیج چندمعماری (multi\-arch image index)

مانیفست این ساخت را بر اساس دایجست (digest) ارسال کرده و تگ را به یک نمایه ایمیج OCI با یک ورودی به ازای هر پلتفرم اشاره می‌دهد، در حالی که ورودی‌های ارسال‌شده توسط سایر معماری‌ها حفظ می‌شوند. برای سرهم‌بندی یک تگ چندمعماری، `mise oci push \-\-update\-index` را روی یک اجراکننده (runner) به ازای هر پلتفرم اجرا کنید.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<REF>\fR
ارجاع رجیستری مقصد (مانند `ghcr.io/me/devenv:latest`)
.SH "MISE OCI RUN"
[آزمایشی] ساخت یک ایمیج OCI از mise.toml کنونی و اجرای یک دستور در آن

معادل `mise oci build` و سپس اجرای `docker run` یا `podman run` است.
ایمیج ساخته‌شده در موتور کانتینر محلی بارگذاری می‌شود (podman ساختار OCI
layout را مستقیماً دریافت می‌کند؛ docker آن را از طریق `docker load` دریافت می‌کند)
و دستور مشخص‌شده درون آن با به ارث بردن stdin/stdout/stderr اجرا می‌شود.

نیازمند `mise settings experimental=true` (یا `MISE_EXPERIMENTAL=1`) و
یکی از موارد: `podman`، `docker` است.
.PP
\fBکاربرد:\fR mise oci run [OPTIONS] [<CMD>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-engine\fR \fI<ENGINE>\fR
موتور کانتینر مورد استفاده (`auto`، `podman` یا `docker`)
.RS
\fIپیش‌فرض: \fRauto
.RE
.TP
\fB\-\-from\fR \fI<FROM>\fR
ارجاع ایمیج پایه برای ساخت (با \-\-image\-dir نادیده گرفته می‌شود)
.TP
\fB\-\-image\-dir\fR \fI<IMAGE_DIR>\fR
استفاده از یک ساختار ایمیج OCI از پیش ساخته‌شده به‌جای ساخت جدید
.TP
\fB\-\-include\-global\fR
شامل کردن ابزارهای پیکربندی سراسری / سیستمی نیز می‌شود (پیش‌فرض: فقط پروژه)

برای جزئیات به `mise oci build \-\-help` مراجعه کنید.
.TP
\fB\-\-keep\fR
نگهداری ایمیج بارگذاری‌شده در فضای ذخیره‌سازی موتور پس از اجرا

به‌طور پیش‌فرض، با خروج دستور، هم کانتینر (`\-\-rm`) و هم ایمیج بارگذاری‌شده حذف می‌شوند، بنابراین اجرای مکرر `mise oci run` ایمیج‌ها را در حافظه ذخیره‌سازی podman / docker انباشته نمی‌کند. برای نگه‌داشتن ایمیج با تگ استفاده‌شده توسط mise (`mise\-oci:run\-*` برای docker؛ شناسه ایمیج دریافت‌شده برای podman) گزینه `\-\-keep` را مشخص کنید.
.TP
\fB\-\-mount\-point\fR \fI<MOUNT_POINT>\fR
بازنویسی نقطه اتصال درون ایمیج (با \-\-image\-dir نادیده گرفته می‌شود)
.TP
\fB\-\-no\-mise\fR
عدم تعبیه باینری mise (با \-\-image\-dir نادیده گرفته می‌شود)
.TP
\fB\-\-owner\fR \fI<UID[:GID]>\fR
اختصاص UID[:GID] به هر ورودی tar هنگام ساخت (با \-\-image\-dir تداخل دارد)

تنظیمات [oci].user_id و [oci].group_id را بازنویسی می‌کند. پیش‌فرض 0:0 است. اگر GID حذف شود، به‌طور پیش‌فرض به UID تنظیم می‌شود. این گزینه فقط بر مالکیت فایل اثر می‌گذارد؛ دستورالعمل USER ایمیج توسط [oci].user کنترل می‌شود.
.TP
\fB\-\-volume\fR \fI<HOST:CONTAINER>\fR
متصل کردن (Bind\-mount) یک مسیر میزبان (تکرارپذیر، `HOST:CONTAINER[:MODE]`)

نکته: برخلاف `docker run \-v`، هیچ پرچم کوتاه `\-v` در اینجا وجود ندارد زیرا mise پرچم `\-v` را برای \-\-verbose رزرو کرده است. از `\-\-volume` یا `\-\-mount` استفاده کنید.
.TP
\fB\-e, \-\-env\fR \fI<KEY=VAL>\fR
تنظیم متغیر محیطی در کانتینر (تکرارپذیر، `KEY=VAL`)
.TP
\fB\-i, \-\-interactive\fR
اجرای تعاملی (ارسال `\-i` به موتور کانتینر)
.TP
\fB\-t, \-\-tty\fR
تخصیص TTY (ارسال `\-t` به موتور کانتینر)
.TP
\fB\-w, \-\-workdir\fR \fI<WORKDIR>\fR
دایرکتوری کاری درون کانتینر
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<CMD>\fR
دستور و آرگومان‌ها برای اجرا درون کانتینر (پس از `\-\-`).SH "MISE OUTDATED"
نمایش نسخه‌های قدیمی ابزارها

برای ارتقای این نسخه‌ها، `mise upgrade` را ببینید.
.PP
\fBنحوه استفاده:\fR mise outdated [OPTIONS] [<TOOL@VERSION>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-b, \-\-bump\fR
مقایسه با جدیدترین نسخه‌های موجود، نه آنچه با پیکربندی فعلی مطابقت دارد

برای مثال، اگر در پیکربندی خود `node = "20"` را داشته باشید، به‌طور پیش‌فرض `mise outdated` فقط
سایر نسخه‌های 20.x را نشان می‌دهد، نه نسخه‌های 21.x یا 22.x را.

با استفاده از این پرچم، اگر نسخه‌های 21.x یا جدیدتری وجود داشته باشند، به‌جای 20.x نمایش داده خواهند شد.
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-l\fR
کوتاه‌نوشت منسوخ‌شده برای \-\-bump
.TP
\fB\-\-inactive\fR
نمایش ابزارهای قدیمی از جمله ابزارهای نصب‌شده اما غیرفعالی که در پیکربندی فعلی وجود ندارند

به‌طور پیش‌فرض، `mise outdated` فقط ابزارهایی را نشان می‌دهد که از پیکربندی فعلی می‌آیند.
.TP
\fB\-\-local\fR
تنها نمایش ابزارهای قدیمیِ تعریف‌شده در فایل‌های پیکربندی محلی

این گزینه فقط ابزارهایی را نشان می‌دهد که در mise.toml محلیِ پروژه تعریف شده‌اند و
از ابزارهای تعریف‌شده در پیکربندی سراسری (~/.config/mise/config.toml) صرف‌نظر می‌کند.
.TP
\fB\-\-monorepo\fR
نگه‌دارنده جایگزین برای بررسی‌های ابزارهای قدیمی در monorepo در آینده؛ دستور `mise outdated \-\-monorepo` هنوز پیاده‌سازی نشده است.
.TP
\fB\-\-no\-header\fR
عدم نمایش سربرگ جدول
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) برای نمایش نسخه‌های قدیمی آن‌ها
مثال: node@20 python@3.10
در صورت مشخص نشدن، تمام ابزارهای موجود در پیکربندی‌های سراسری و محلی نشان داده خواهند شد
.SH "MISE PATRONS"
نمایش افرادی که در سطح Patron از mise حمایت می‌کنند

فهرست کردن افراد حاضر در سطح Patron از <https://jdx.dev/patrons.json>.
این فهرست روزانه تازه‌سازی می‌شود؛ پایانه‌های پشتیبانی‌کننده، نام هر حامی را
به‌صورت پیوند قابل کلیک از طریق ابرپیوندهای OSC 8 نمایش می‌دهند.

برای قرار گرفتن در اینجا، در <https://jdx.dev/sponsors.html> حامی شوید.
.PP
\fBنحوه استفاده:\fR mise patrons [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-refresh\fR
دور زدن حافظهٔ پنهان محلی و واکشی مجدد
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
.SH "MISE PLUGINS"
مدیریت افزونه‌ها
.PP
\fBنحوه استفاده:\fR mise plugins [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
فهرست کردن تمام افزونه‌های دوردست (ریموت) موجود

مشابه با `mise plugins ls\-remote`
.TP
\fB\-c, \-\-core\fR
فقط افزونه‌های توکار
معمولاً این افزونه‌ها نشان داده نمی‌شوند
.TP
\fB\-u, \-\-urls\fR
نمایش نشانی git برای هر افزونه
مثال: https://github.com/mise\-plugins/vfox\-cmake.git
.TP
\fB\-\-refs\fR
نمایش git refها برای هر افزونه
مثال: main 1234abc
.TP
\fB\-\-user\fR
فهرست کردن افزونه‌های نصب‌شده

این رفتار پیش‌فرض است اما می‌تواند همراه با \-\-core استفاده شود
تا هم افزونه‌های هسته و هم افزونه‌های کاربر نشان داده شوند
.TP
\fB\-h, \-\-help\fR
چاپ راهنما.SH "MISE PLUGINS INSTALL"
نصب یک افزونه

توجه داشته باشید که mise می‌تواند هنگام نصب یک ابزار، افزونه‌ها را به‌طور خودکار نصب کند
به‌عنوان مثال: `mise install cmake@3.30` افزونه cmake را به‌طور خودکار نصب می‌کند

این رفتار را می‌توان در ~/.config/mise/config.toml تغییر داد
.PP
\fBنحوه استفاده:\fR mise plugins install [OPTIONS] [<NEW_PLUGIN>] [<GIT_URL>] [<REST>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
نصب تمام افزونه‌های مفقود
این گزینه تنها افزونه‌هایی را نصب می‌کند که نام کوتاه (shorthand) منطبق دارند؛
یعنی نیازی به نشانی کامل مخزن git ندارند
.TP
\fB\-f, \-\-force\fR
نصب مجدد حتی در صورت وجود افزونه
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارهای هم‌روند برای اجرا
مقادیر کمتر از ۱ معادل ۱ در نظر گرفته می‌شوند
.TP
\fB\-v, \-\-verbose\fR
نمایش خروجی فرایند نصب
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<NEW_PLUGIN>\fR
نام افزونه برای نصب
به‌عنوان مثال: cmake، poetry
می‌توان چندین افزونه را مشخص کرد: `mise plugins install cmake poetry`
.TP
\fB<GIT_URL>\fR
نشانی git افزونه
.SH "MISE PLUGINS LINK"
ایجاد پیوند نمادین (Symlink) برای یک افزونه به درون mise

این دستور برای توسعه یک افزونه به کار می‌رود.
.PP
\fBنحوه استفاده:\fR mise plugins link [OPTIONS] <NAME> [<DIR>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
بازنویسی افزونه موجود
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<NAME>\fR
نام افزونه
به‌عنوان مثال: cmake، poetry
.TP
\fB<DIR>\fR
مسیر محلی افزونه
به‌عنوان مثال: ./vfox\-cmake
.SH "MISE PLUGINS LS"
فهرست کردن افزونه‌های نصب‌شده

همچنین می‌تواند افزونه‌های دردسترس از راه دور را برای نصب نمایش دهد.
.PP
\fBنحوه استفاده:\fR mise plugins ls [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
فهرست کردن تمام افزونه‌های دردسترس از راه دور
مشابه دستور `mise plugins ls\-remote`
.TP
\fB\-c, \-\-core\fR
تنها افزونه‌های توکار (built\-in)
در حالت عادی این افزونه‌ها نمایش داده نمی‌شوند
.TP
\fB\-o, \-\-outdated\fR
نمایش افزونه‌های دارای به‌روزرسانی
مخزن دوردست را برای نسخه‌های جدیدتر بررسی کرده و تنها افزونه‌های قدیمی‌شده را نمایش می‌دهد
.TP
\fB\-u, \-\-urls\fR
نمایش نشانی git برای هر افزونه
به‌عنوان مثال: https://github.com/mise\-plugins/vfox\-cmake.git
.TP
\fB\-\-refs\fR
نمایش ارجاعات git (git refs) برای هر افزونه
به‌عنوان مثال: main 1234abc
.TP
\fB\-\-user\fR
فهرست کردن افزونه‌های نصب‌شده
.TP
\fB\-h, \-\-help\fR
چاپ راهنما.SH "MISE PLUGINS LS-REMOTE"

فهرست کردن تمام افزونه‌های دوردست دردسترس

فهرست کامل اینجاست: https://github.com/jdx/mise/blob/main/registry

مثال‌ها:

    $ mise plugins ls\-remote
.PP
\fBکاربرد:\fR mise plugins ls\-remote [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-u, \-\-urls\fR
نمایش نشانی git برای هر افزونه، برای نمونه: https://github.com/mise\-plugins/mise\-poetry.git
.TP
\fB\-\-only\-names\fR
تنها نمایش نام هر افزونه؛ به‌طور پیش‌فرض یک «*» در کنار افزونه‌های نصب‌شده نمایش داده می‌شود
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE PLUGINS UNINSTALL"
حذف یک افزونه
.PP
\fBکاربرد:\fR mise plugins uninstall [OPTIONS] [<PLUGIN>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
حذف تمام افزونه‌ها
.TP
\fB\-p, \-\-purge\fR
همچنین حذف موارد نصب‌شده، بارگیری‌ها و کَش افزونه
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PLUGIN>\fR
افزونه(هایی) برای حذف
.SH "MISE PLUGINS UPDATE"
به‌روزرسانی یک افزونه به آخرین نسخه

نکته: این عمل خودِ افزونه را به‌روزرسانی می‌کند، نه نسخه‌های زمان‌اجرا (runtime) را
.PP
\fBکاربرد:\fR mise plugins update [OPTIONS] [<PLUGIN>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارها برای اجرای موازی
مقادیر کمتر از ۱ برابر ۱ در نظر گرفته می‌شوند
پیش‌فرض: 4
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PLUGIN>\fR
افزونه(هایی) برای به‌روزرسانی
.SH "MISE DEPS"
[آزمایشی] مدیریت وابستگی‌های پروژه

اجرای تمام مراحل قابل‌اعمال نصب وابستگی برای پروژهٔ کنونی.
این بررسی می‌کند که آیا فایل‌های قفل وابستگی (lockfiles) از خروجی‌های نصب‌شده جدیدتر هستند یا خیر
(مانند package\-lock.json در برابر node_modules/) و در صورت نیاز دستورهای نصب را اجرا می‌کند.

ارائه‌دهندگانی با `auto = true` به‌طور خودکار پیش از `mise x` و `mise run` فراخوانی می‌شوند
مگر اینکه با گزینهٔ \-\-no\-deps نادیده گرفته شوند.
.PP
\fBکاربرد:\fR mise deps [OPTIONS] [<PROVIDER>] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-explain\fR
نمایش دلیل تازه (fresh) یا کهنه (stale) بودن یک ارائه‌دهنده (نیازمند یک آرگومان ارائه‌دهنده است)
.TP
\fB\-f, \-\-force\fR
اجرای اجباری تمام مراحل وابستگی‌ها حتی اگر خروجی‌ها تازه باشند
.TP
\fB\-n, \-\-dry\-run\fR
تنها بررسی اینکه آیا نصب وابستگی‌ها مورد نیاز است یا خیر، بدون اجرای دستورها
.TP
\fB\-\-list\fR
نمایش ارائه‌دهندگان وابستگی دردسترس
.TP
\fB\-\-monorepo\fR
نصب وابستگی‌ها از تمام ریشه‌های پیکربندی [monorepo].config_roots

نیازمند monorepo_root = true به‌همراه تعیین صریح [monorepo].config_roots در
پیکربندی ریشهٔ monorepo است. ارائه‌دهندگان با قالبی مانند //apps/api:uv نام‌گذاری می‌شوند.
.RS
\fIمتغیر محیطی: \fR\fBMISE_MONOREPO\fR
.RE
.TP
\fB\-\-only\fR \fI<ONLY>\fR
تنها اجرای قاعده(های) مشخص وابستگی‌ها
.TP
\fB\-\-skip\fR \fI<SKIP>\fR
نادیده‌گرفتن قاعده(های) مشخص وابستگی‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PROVIDER>\fR
ارائه‌دهنده‌ای که باید روی آن عملیات انجام شود (تنها این ارائه‌دهنده را اجرا می‌کند، یا همراه با \-\-explain استفاده می‌شود).SH "MISE DEPS ADD"
افزودن یک وابستگی

یک یا چند بسته را با استفاده از مدیر بسته مناسب به پروژه اضافه می‌کند.
مشخصات بسته از قالب `ecosystem:package` استفاده می‌کنند، مانند `npm:react` یا `npm:@types/react@19`.
.PP
\fBکاربرد:\fR mise deps add [OPTIONS] <PACKAGES> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-D, \-\-dev\fR
افزودن به عنوان یک وابستگی توسعه
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PACKAGES>\fR
بسته(هایی) برای افزودن (مانند npm:react یا npm:@types/react@19)
.SH "MISE DEPS INSTALL"
نصب تمام وابستگی‌های پروژه

بررسی می‌کند که آیا فایل‌های قفل وابستگی از خروجی‌های نصب‌شده تازه‌تر هستند یا خیر
و در صورت نیاز، دستورات نصب را اجرا می‌کند.
.PP
\fBکاربرد:\fR mise deps install [OPTIONS] [<PROVIDER>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-explain\fR
نمایش چرایی تازه یا کهنه بودن یک ارائه‌دهنده (نیاز به یک آرگومان ارائه‌دهنده دارد)
.TP
\fB\-f, \-\-force\fR
اجرای اجباری تمام مراحل deps حتی اگر خروجی‌ها تازه باشند
.TP
\fB\-n, \-\-dry\-run\fR
تنها بررسی اینکه آیا نصب deps لازم است یا خیر؛ دستورات اجرا نمی‌شوند
.TP
\fB\-\-list\fR
نمایش ارائه‌دهنده‌های موجود deps
.TP
\fB\-\-monorepo\fR
نصب وابستگی‌ها از هر ریشه پیکربندی [monorepo].config_roots

نیازمند monorepo_root = true به همراه [monorepo].config_roots صریح در
پیکربندی ریشه monorepo است. ارائه‌دهنده‌ها به شکلی مانند //apps/api:uv نام‌گذاری می‌شوند.
.RS
\fIمحیط: \fR\fBMISE_MONOREPO\fR
.RE
.TP
\fB\-\-only\fR \fI<ONLY>\fR
تنها اجرای قاعده(های) مشخص deps
.TP
\fB\-\-skip\fR \fI<SKIP>\fR
نادیده گرفتن قاعده(های) مشخص deps
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PROVIDER>\fR
ارائه‌دهنده‌ای که عملیات روی آن انجام می‌شود (تنها این ارائه‌دهنده را اجرا می‌کند، یا برای استفاده با \-\-explain)
.SH "MISE DEPS REMOVE"
حذف یک وابستگی

یک یا چند بسته را با استفاده از مدیر بسته مناسب از پروژه حذف می‌کند.
مشخصات بسته از قالب `ecosystem:package` استفاده می‌کنند، مانند `npm:lodash`.
.PP
\fBکاربرد:\fR mise deps remove [OPTIONS] <PACKAGES> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<PACKAGES>\fR
بسته(هایی) برای حذف (مانند npm:lodash).SH "MISE PRUNE"
حذف نگارش‌های استفاده‌نشده ابزارها

‏mise بررسی و ردگیری می‌کند که کدام فایل‌های پیکربندی در ~/.local/state/mise/tracked\-configs استفاده شده‌اند.
نگارش‌هایی که دیگر جدیدترین نگارش مشخص‌شده در هیچ‌یک از آن فایل‌های پیکربندی نیستند، حذف می‌شوند.
نگارش‌هایی که فقط با متغیرهای محیطی `MISE_<TOOL>_VERSION` نصب شده‌اند، و همچنین نگارش‌هایی که تنها در خط فرمان `mise exec <TOOL>@<VERSION>` به آن‌ها ارجاع داده شده است، حذف خواهند شد.

استاب‌های (stubs) ابزارهایی که اجرا شده‌اند در ~/.local/state/mise/tracked\-stubs ردگیری می‌شوند.
نگارش‌هایی که هنوز توسط یک استاب ردگیری‌شده به آن‌ها ارجاع داده می‌شود، حذف نخواهند شد.

می‌توانید ابزارهای قابل هرس را با `mise ls \-\-prunable` فهرست کنید.
.PP
\fBکاربرد:\fR mise prune [OPTIONS] [<INSTALLED_TOOL>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-n, \-\-dry\-run\fR
در عمل چیزی را حذف نمی‌کند
.TP
\fB\-\-configs\fR
تنها پیوندهای پیکربندی ردگیری‌شده و معتبری را که به پیکربندی‌های ناموجود اشاره دارند، هرس می‌کند
.TP
\fB\-\-dry\-run\-code\fR
مانند \-\-dry\-run است، اما اگر ابزاری برای هرس وجود داشته باشد با کد ۱ خارج می‌شود

این گزینه برای اسکریپت‌ها جهت بررسی اینکه آیا ابزاری نیاز به هرس دارد یا خیر، مفید است.
.TP
\fB\-\-monorepo\fR
جای‌نگه‌داری برای هرس monorepo در آینده؛ دستور `mise prune \-\-monorepo` هنوز پیاده‌سازی نشده است.
.TP
\fB\-\-tools\fR
تنها نگارش‌های استفاده‌نشده ابزارها را هرس می‌کند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<INSTALLED_TOOL>\fR
تنها این ابزارها را هرس می‌کند
.SH "MISE REGISTRY"
فهرست کردن ابزارهای در دسترس برای نصب

این دستور ابزارهای موجود در رجیستری را به صورت نام‌های مختصر فهرست می‌کند.

به عنوان مثال، `poetry` نام مختصری برای `asdf:mise\-plugins/mise\-poetry` است.
.PP
\fBکاربرد:\fR mise registry [OPTIONS] [<NAME>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-b, \-\-backend\fR \fI<BACKEND>\fR
تنها ابزارهای مربوط به این backend را نمایش می‌دهد
.TP
\fB\-\-complete\fR
چاپ تمام ابزارها به همراه توضیحات برای تکمیل خودکار پوسته (shell completions)
.TP
\fB\-\-hide\-aliased\fR
پنهان کردن ابزارهای دارای نام مستعار (aliased)
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-security\fR
ویژگی‌های امنیتی backendهای هر ابزار را در خروجی JSON می‌گنجاند.

نیازمند \-\-json است. اطلاعات امنیتی در تمام backendهای یک ابزار یکسان‌سازی شده و موارد تکراری حذف می‌شوند. این مورد می‌تواند برای فهرست‌های بزرگ زمان قابل‌توجهی صرف کند، زیرا اطلاعات امنیتی هر backend به‌صورت جداگانه دریافت می‌شود.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<NAME>\fR
تنها نام کامل ابزار مشخص‌شده را نشان می‌دهد
.SH "MISE RESHIM"
بر اساس مسیرهای bin از ابزارهای نصب‌شده فعلی، شیم‌های (shims) جدید ایجاد می‌کند.

این دستور در دایرکتوری shim پیکربندی‌شده برای کاربر، شیم‌های جدیدی برای CLIهایی که اضافه شده‌اند ایجاد می‌کند.
با `\-\-system`، در عوض ساختار شیم‌های سیستمی پیکربندی‌شده (system shim farm) را بازسازی می‌کند.
‏mise تلاش می‌کند این کار را برای دستورهایی مانند `npm i \-g` به‌طور خودکار انجام دهد، اما راه‌های دیگری برای نصب وجود دارد (مانند استفاده از yarn یا pnpm برای node) که mise از آن‌ها اطلاعی ندارد و بنابراین فراخوانی صریح این دستور لازم خواهد بود.

اگر فکر می‌کنید mise باید این دستور را برای یک دستور خاص به‌طور خودکار فراخوانی کند، لطفاً یک issue در مخزن mise ثبت کنید. همچنین می‌توانید یک تابع پوسته برای اجرای خودکار reshim تنظیم کنید (این عملیات بسیار سریع است بنابراین نیازی نیست نگران بار پردازشی آن باشید):

    npm() {
      command npm "$@"
      mise reshim
    }

توجه داشته باشید که این دستور برای _تمام_ ابزارهای نصب‌شده شیم ایجاد می‌کند، نه فقط مواردی که در حال حاضر در mise.toml فعال هستند.
.PP
\fBکاربرد:\fR mise reshim [OPTIONS] [<TOOL>] [<VERSION>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
تمام شیم‌های متعلق به mise را بازسازی می‌کند
.TP
\fB\-\-system\fR
بازسازی ساختار شیم‌های سیستمی (system shim farm)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE RUN"
اجرای تسک(ها)

این دستور یک تسک یا چندین تسک را به‌صورت موازی اجرا می‌کند.
تسک‌ها ممکن است به تسک‌های دیگر یا به فایل‌های منبع وابسته باشند.
اگر منبع (source) برای یک تسک پیکربندی شده باشد، تسک تنها در صورتی
اجرا می‌شود که فایل‌های منبع تغییر کرده باشند.

تسک‌ها را می‌توان در mise.toml یا به‌صورت اسکریپت‌های مستقل تعریف کرد.
در mise.toml، تسک‌ها به این شکل تعریف می‌شوند:

    [tasks.build]
    run = "npm run build"
    sources = ["src/**/*.ts"]
    outputs = ["dist/**/*.js"]

روش دیگر این است که تسک‌ها به‌صورت اسکریپت‌های مستقل تعریف شوند.
این اسکریپت‌ها باید در `mise\-tasks`، `.mise\-tasks`، `.mise/tasks`، `mise/tasks` یا
`.config/mise/tasks` قرار گیرند.
نام اسکریپت، همان نام تسک خواهد بود.

    $ cat .mise/tasks/build<<EOF
    #!/usr/bin/env bash
    npm run build
    EOF
    $ mise run build
.PP
\fBنحوه استفاده:\fR mise run [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-affected\fR
اجرای تسک‌های منطبق فقط برای پروژه‌های متأثر از تغییرات Git
.TP
\fB\-\-affected\-base\fR \fI<REV>\fR
بازنگری (revision) پایه در Git برای \-\-affected
پیش‌فرض: MISE_AFFECTED_BASE، فراداده CI یا HEAD~1
.TP
\fB\-\-affected\-explain\fR
توضیح این‌که چرا پروژه‌ها و تسک‌ها توسط \-\-affected انتخاب شده‌اند
.TP
\fB\-\-affected\-head\fR \fI<REV>\fR
بازنگری سر (head) در Git برای \-\-affected
پیش‌فرض: MISE_AFFECTED_HEAD، فراداده CI یا HEAD
.TP
\fB\-\-affected\-json\fR
نمایش پروژه‌ها و تسک‌های متأثر در قالب JSON بدون اجرای تسک‌ها
.TP
\fB\-\-all\fR
باز کردن انتخاب‌گر تعاملی با تمام تسک‌های کل مونوریپو (monorepo)
.TP
\fB\-c, \-\-continue\-on\-error\fR
ادامه اجرای تسک‌ها حتی در صورت شکست خوردن یکی از آن‌ها
.TP
\fB\-C, \-\-cd\fR \fI<CD>\fR
تغییر به این دایرکتوری پیش از اجرای دستور
.TP
\fB\-f, \-\-force\fR
اجبار تسک‌ها به اجرا حتی اگر خروجی‌ها به‌روز باشند
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد تسک‌ها برای اجرای هم‌زمان (موازی)
مقادیر کمتر از ۱ به‌صورت ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
پیکربندی از طریق تنظیم `jobs` یا متغیر محیطی `MISE_JOBS`
.RS
\fIمتغیر محیطی: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-n, \-\-dry\-run\fR
عدم اجرای واقعی تسک(ها)، صرفاً چاپ آن‌ها به ترتیب اجرا
.TP
\fB\-o, \-\-output\fR \fI<OUTPUT>\fR
تغییر نحوه نمایش خروجی اطلاعات هنگام اجرای تسک‌ها

\- `prefix` \- چاپ خط‌به‌خط stdout/stderr با پیشوند برچسب تسک
\- `interleave` \- چاپ مستقیم روی stdout/stderr به‌جای چاپ خط‌به‌خط
\- `replacing` \- مقدار stdout هر بار جایگزین می‌شود، stderr همان‌طور که هست چاپ می‌شود
\- `timed` \- خطوط stdout تنها در صورتی نمایش داده می‌شوند که بیش از ۱ ثانیه نمایش یابند
\- `keep\-order` \- چاپ خط‌به‌خط stdout/stderr با پیشوند برچسب تسک، با حفظ ترتیب خروجی
\- `quiet` \- عدم نمایش خروجی‌های اضافی
\- `silent` \- عدم نمایش هیچ خروجی از جمله stdout و stderr تسک به‌جز خطاها
.RS
\fIمتغیر محیطی: \fR\fBMISE_TASK_OUTPUT\fR
.RE
.TP
\fB\-q, \-\-quiet\fR
عدم نمایش خروجی‌های اضافی
.RS
\fIمتغیر محیطی: \fR\fBMISE_QUIET\fR
.RE
.TP
\fB\-r, \-\-raw\fR
خواندن/نوشتن مستقیم روی stdin/stdout/stderr به‌جای خط‌به‌خط
با این گزینه، سانسورها/پنهان‌سازی‌ها اعمال نمی‌شوند
پیکربندی از طریق تنظیم `raw` یا متغیر محیطی `MISE_RAW`
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
پوسته‌ای (shell) که برای اجرای تسک‌های toml استفاده می‌شود

پیش‌فرض در یونیکس `sh \-c \-o errexit \-o pipefail`، و در ویندوز `cmd /c` است
همچنین می‌تواند با تنظیم `MISE_UNIX_DEFAULT_INLINE_SHELL_ARGS` یا `MISE_WINDOWS_DEFAULT_INLINE_SHELL_ARGS` تعیین شود
یا با ویژگی `shell` روی یک تسک بازنویسی شود.
.TP
\fB\-S, \-\-silent\fR
عدم نمایش هیچ‌گونه خروجی به‌جز خطاها
.RS
\fIمتغیر محیطی: \fR\fBMISE_SILENT\fR
.RE
.TP
\fB\-t, \-\-tool\fR \fI<TOOL@VERSION>\fR
ابزار(هایی) که علاوه بر موارد موجود در فایل‌های mise.toml باید اجرا شوند، مانند: node@20 python@3.10
.TP
\fB\-\-allow\-env\fR \fI<VAR>\fR
اجازه عبور به متغیر محیطی خاص (به معنی اعمال \-\-deny\-env برای سایر متغیرها)
پشتیبانی از الگوهای عامه‌نما (wildcards)، مانند: \-\-allow\-env='MYAPP_*'
.TP
\fB\-\-allow\-net\fR \fI<HOST>\fR
اجازه دسترسی به شبکه برای میزبان خاص (به معنی اعمال \-\-deny\-net برای سایر موارد)
.TP
\fB\-\-allow\-read\fR \fI<PATH>\fR
اجازه خواندن از مسیر خاص (به معنی اعمال \-\-deny\-read برای سایر مسیرها)
.TP
\fB\-\-allow\-write\fR \fI<PATH>\fR
اجازه نوشتن در مسیر خاص (به معنی اعمال \-\-deny\-write برای سایر مسیرها)
.TP
\fB\-\-deny\-all\fR
مسدود کردن خواندن، نوشتن، شبکه و متغیرهای محیطی
.TP
\fB\-\-deny\-env\fR
مسدود کردن توارث متغیرهای محیطی (تنها PATH، HOME، USER، SHELL، TERM و LANG عبور می‌کنند)
.TP
\fB\-\-deny\-net\fR
مسدود کردن تمام دسترسی‌های شبکه
.TP
\fB\-\-deny\-read\fR
مسدود کردن خواندن از فایل‌سیستم (کتابخانه‌های سیستم و دایرکتوری‌های ابزار همچنان در دسترس خواهند بود)
.TP
\fB\-\-deny\-write\fR
مسدود کردن تمام نوشتن‌ها روی فایل‌سیستم
.TP
\fB\-\-fresh\-env\fR
نادیده گرفتن حافظه موقت (کش) محیط و محاسبه مجدد متغیرهای محیطی
.TP
\fB\-\-no\-cache\fR
عدم استفاده از کش برای تسک‌های راه دور
.RS
\fIمتغیر محیطی: \fR\fBMISE_TASK_REMOTE_NO_CACHE\fR
.RE
.TP
\fB\-\-no\-deps\fR
صرف‌نظر کردن از آماده‌سازی خودکار وابستگی‌ها
.TP
\fB\-\-no\-timings\fR
پنهان کردن زمان سپری‌شده پس از اتمام هر تسک

به‌طور پیش‌فرض با `MISE_TASK_TIMINGS=0` همیشه پنهان می‌شود
.TP
\fB\-\-skip\-deps\fR
اجرای تنها تسک‌های مشخص‌شده با صرف‌نظر از تمامی وابستگی‌ها
.RS
\fIمتغیر محیطی: \fR\fBMISE_TASK_SKIP_DEPENDS\fR
.RE
.TP
\fB\-\-skip\-tools\fR
صرف‌نظر کردن از نصب ابزارها پیش از اجرای تسک‌ها

همچنین می‌تواند به‌طور دائمی با تنظیم `task.run_auto_install`
یا متغیر محیطی `MISE_TASK_RUN_AUTO_INSTALL=false` تعیین شود
.TP
\fB\-\-task\-cache\fR \fI<TASK_CACHE>\fR
تنظیم نحوه دسترسی به کش خروجی تسک برای این اجرا

\- `read\-write` \- خواندن نتایج کش‌شده و نوشتن نتایج جدید
\- `read\-only` \- خواندن نتایج کش‌شده بدون نوشتن نتایج جدید
\- `write\-only` \- نوشتن نتایج جدید بدون خواندن نتایج کش‌شده
\- `off` \- غیرفعال کردن کش خروجی تسک
\- `local\-only` \- فقط خواندن و نوشتن در کش محلی؛ در حال حاضر معادل با `read\-write`
.RS
\fIپیش‌فرض: \fRread\-write
.RE
.RS
\fIمتغیر محیطی: \fR\fBMISE_TASK_CACHE\fR
.RE.TP
\fB\-\-task\-cache\-explain\fR
ورودی‌هایی را که کلید کَش خروجی هر تسک را تولید کرده‌اند، توضیح می‌دهد
.TP
\fB\-\-task\-cache\-explain\-json\fR
نمایش جزئیات ورودی کلید کَش در قالب JSON Lines بدون اجرای تسک‌ها
.TP
\fB\-\-task\-cache\-stats\fR
گزارش موارد اصابت به کَش خروجی تسک (cache hits)، بایت‌های بازیابی‌شده و زمان صرفه‌جویی‌شده
.TP
\fB\-\-timeout\fR \fI<TIMEOUT>\fR
مهلت زمانی برای تکمیل تسک
برای نمونه: 30s ،5m
.TP
\fB\-\-timings\fR
نمایش زمان سپری‌شده پس از اتمام هر تسک

به‌طور پیش‌فرض با `MISE_TASK_TIMINGS=1` همیشه نمایش داده می‌شود
.SH "MISE SEARCH"
جستجوی ابزارها در رجیستری

این دستور یک ابزار را در رجیستری جستجو می‌کند.

به‌طور پیش‌فرض، تمام ابزارهایی که با عبارت مورد نظر تطابق تقریبی (fuzzy) دارند نمایش داده می‌شوند. برای
تطابق‌های غیرتقریبی، از پرچم `\-\-match\-type` استفاده کنید.
.PP
\fBکاربرد:\fR mise search [OPTIONS] [<NAME>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-i, \-\-interactive\fR
نمایش جستجوی تعاملی
.TP
\fB\-m, \-\-match\-type\fR \fI<MATCH_TYPE>\fR
نوع تطابق: equal ،contains یا fuzzy
.RS
\fIپیش‌فرض: \fRfuzzy
.RE
.TP
\fB\-\-no\-header\fR
عدم نمایش سرآیندها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<NAME>\fR
ابزار مورد نظر برای جستجو
.SH "MISE SELF-UPDATE"
خود mise را به‌روزرسانی می‌کند.

برای یافتن آخرین نگارش منتشرشده و باینری از GitHub Releases API استفاده می‌کند.
به‌طور پیش‌فرض، این دستور افزونه‌های نصب‌شده را نیز به‌روزرسانی خواهد کرد.
برای درخواست‌های احرازهویت‌شده از زنجیره تفکیک توکن GitHub در mise استفاده می‌کند.

بسته‌سازان می‌توانند این دستور را غیرفعال کنند تا mise در عوض از طریق
مدیر بسته‌ها به‌روزرسانی شود. ببینید:
https://mise.jdx.dev/contributing.html#packaging\-and\-self\-update\-instructions
.PP
\fBکاربرد:\fR mise self\-update [OPTIONS] [<VERSION>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-force\fR
به‌روزرسانی حتی در صورت به‌روز بودن
.TP
\fB\-y, \-\-yes\fR
صرف‌نظر از اعلان تأیید
.TP
\fB\-\-no\-plugins\fR
غیرفعال‌سازی به‌روزرسانی خودکار افزونه‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<VERSION>\fR
به‌روزرسانی به یک نسخه مشخص.SH "MISE SET"
تنظیم متغیرهای محیط در mise.toml

به‌طور پیش‌فرض، این دستور فایل `mise.toml` را در دایرکتوری جاری تغییر می‌دهد.
اگر چندین فایل پیکربندی وجود داشته باشد (برای مثال، هر دو فایل `mise.toml` و `mise.local.toml`)،
فایلی با کمترین اولویت (`mise.toml`) استفاده خواهد شد.
ببینید: https://mise.jdx.dev/configuration.html#target\-file\-for\-write\-operations

از `\-E <env>` برای ایجاد یا تغییر فایل‌های پیکربندی مختص به محیط مانند `mise.<env>.toml` استفاده کنید.
.PP
\fBنحوه استفاده:\fR mise set [OPTIONS] [<ENV_VAR>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-E, \-\-env\fR \fI<ENV>\fR
ایجاد یا تغییر یک فایل پیکربندی مختص به محیط مانند .mise.<env>.toml
.TP
\fB\-g, \-\-global\fR
تنظیم متغیر محیط در فایل پیکربندی سراسری
.TP
\fB\-\-age\-encrypt\fR
[آزمایشی] رمزنگاری مقدار با age پیش از ذخیره‌سازی
.TP
\fB\-\-age\-key\-file\fR \fI<PATH>\fR
[آزمایشی] فایل شناسه age برای رمزنگاری

در صورت وجود، پیش‌فرض ~/.config/mise/age.txt است
.TP
\fB\-\-age\-recipient\fR \fI<RECIPIENT>\fR
[آزمایشی] گیرنده age (کلید عمومی x25519) برای رمزنگاری

می‌تواند چندین بار استفاده شود. به \-\-age\-encrypt نیاز دارد.
.TP
\fB\-\-age\-ssh\-recipient\fR \fI<PATH_OR_PUBKEY>\fR
[آزمایشی] گیرنده SSH (کلید عمومی یا مسیر) برای رمزنگاری age

می‌تواند چندین بار استفاده شود. به \-\-age\-encrypt نیاز دارد.
.TP
\fB\-\-complete\fR
ارائه کامل‌سازی‌ها
.TP
\fB\-\-file, \-\-path\fR \fI<FILE>\fR
فایل TOML برای به‌روزرسانی

می‌تواند مسیر یک فایل یا دایرکتوری باشد. اگر دایرکتوری مشخص شود، mise.toml در آن دایرکتوری ایجاد یا استفاده خواهد شد.
پیش‌فرض متغیر محیط [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) یا `mise.toml` است.
از [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) برای انتخاب مسیر متفاوتی برای پیکربندی سراسری استفاده کنید.
.TP
\fB\-\-no\-redact\fR
نمایش مقادیر خام به‌جای سانسور کردن اسرار
.TP
\fB\-\-prompt\fR
درخواست تعاملی برای دریافت مقادیر متغیرهای محیط
.TP
\fB\-\-remove, \-\-rm, \-\-unset\fR \fI<ENV_KEY>\fR
حذف متغیر محیط از فایل پیکربندی

می‌تواند چندین بار استفاده شود.
.TP
\fB\-\-stdin\fR
خواندن مقدار از stdin (برای ورودی‌های چندخطی)

هنگام استفاده از \-\-stdin، یک کلید منفرد بدون مقدار ارائه دهید. مقدار تا رسیدن به EOF از stdin خوانده خواهد شد.
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<ENV_VAR>\fR
متغیر(های) محیط برای تنظیم
برای مثال: NODE_ENV=production
.SH "MISE SETTINGS"
مدیریت تنظیمات
.PP
\fBنحوه استفاده:\fR mise settings [OPTIONS] [<SETTING>] [<VALUE>] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
فهرست کردن تمام تنظیمات
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-l, \-\-local\fR
استفاده از فایل پیکربندی محلی به‌جای فایل سراسری
.TP
\fB\-T, \-\-toml\fR
خروجی در قالب TOML
.TP
\fB\-\-complete\fR
چاپ تمامی تنظیمات به همراه توضیحات برای کامل‌سازی‌های پوسته
.TP
\fB\-\-json\-extended\fR
خروجی در قالب JSON به همراه منابع
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SETTING>\fR
نام تنظیم
.TP
\fB<VALUE>\fR
مقدار تنظیم برای اعمال.SH "MISE SETTINGS ADD"
یک تنظیم را به فایل پیکربندی اضافه می‌کند

در صورت استفاده برای یک تنظیم آرایه‌ای، این دستور مقدار را به آرایه الحاق می‌کند.
این دستور محتویات ~/.config/mise/config.toml را تغییر می‌دهد.
.PP
\fBنحوه استفاده:\fR mise settings add [OPTIONS] <SETTING> [<VALUE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-local\fR
استفاده از فایل پیکربندی محلی به جای فایل سراسری
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SETTING>\fR
تنظیمی که باید مقداردهی شود
.TP
\fB<VALUE>\fR
مقداری که باید تنظیم شود (در صورت ارائه به صورت KEY=VALUE اختیاری است)
.SH "MISE SETTINGS GET"
نمایش یک تنظیم فعلی

این دستور محتوای یک مدخل واحد در ~/.config/mise/config.toml را نشان می‌دهد

توجه داشته باشید که نام‌های مستعار نیز در این فایل ذخیره می‌شوند
اما به‌طور جداگانه با `mise tool\-alias get` مدیریت می‌شوند
.PP
\fBنحوه استفاده:\fR mise settings get [OPTIONS] <SETTING>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-local\fR
استفاده از فایل پیکربندی محلی به جای فایل سراسری
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SETTING>\fR
تنظیمی که باید نمایش داده شود
.SH "MISE SETTINGS LS"
نمایش تنظیمات فعلی

این دستور محتویات ~/.config/mise/config.toml را نشان می‌دهد

توجه داشته باشید که نام‌های مستعار نیز در این فایل ذخیره می‌شوند
اما به‌طور جداگانه با `mise tool\-alias` مدیریت می‌شوند
.PP
\fBنحوه استفاده:\fR mise settings ls [OPTIONS] [<SETTING>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
فهرست کردن تمام تنظیمات
.TP
\fB\-J, \-\-json\fR
ارائه خروجی در قالب JSON
.TP
\fB\-l, \-\-local\fR
استفاده از فایل پیکربندی محلی به جای فایل سراسری
.TP
\fB\-T, \-\-toml\fR
ارائه خروجی در قالب TOML
.TP
\fB\-\-complete\fR
چاپ تمام تنظیمات به همراه توضیحات برای تکمیل خودکار پوسته (shell completions)
.TP
\fB\-\-json\-extended\fR
ارائه خروجی در قالب JSON به همراه منبع‌ها
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SETTING>\fR
نام تنظیم.SH "MISE SETTINGS SET"
افزودن یا به‌روزرسانی یک تنظیم

این دستور به‌طور پیش‌فرض محتویات ~/.config/mise/config.toml را تغییر می‌دهد.
با `\-\-local`، به جای آن فایل پیکربندی محلی را تغییر می‌دهد.
مشاهده کنید: https://mise.jdx.dev/configuration.html#target\-file\-for\-write\-operations
.PP
\fBنحوه استفاده:\fR mise settings set [OPTIONS] <SETTING> [<VALUE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-local\fR
استفاده از فایل پیکربندی محلی به جای فایل سراسری
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<SETTING>\fR
تنظیمی که باید مقداردهی شود
.TP
\fB<VALUE>\fR
مقداری که باید تنظیم شود (در صورتی که به‌صورت KEY=VALUE ارائه شود اختیاری است)
.SH "MISE SETTINGS UNSET"
پاک کردن یک تنظیم

این دستور محتویات ~/.config/mise/config.toml را تغییر می‌دهد
.PP
\fBنحوه استفاده:\fR mise settings unset [OPTIONS] <KEY>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-l, \-\-local\fR
استفاده از فایل پیکربندی محلی به جای فایل سراسری
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<KEY>\fR
تنظیمی که باید حذف شود
.SH "MISE SHELL"
تنظیم نسخه یک ابزار برای نشست فعلی.

تنها در نشستی کار می‌کند که mise از قبل در آن فعال شده باشد.

این کار با تنظیم متغیرهای محیطی برای نشست فعلی شل کار می‌کند؛
مانند `MISE_NODE_VERSION=20` که در تابع شلِ ایجادشده توسط `mise activate` ارزیابی (eval) می‌شود.
.PP
\fBنحوه استفاده:\fR mise shell [OPTIONS] <TOOL@VERSION> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارهای هم‌زمان برای اجرا به‌صورت موازی
مقادیر کمتر از ۱ به عنوان ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
.RS
\fIمتغیر محیطی: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-u, \-\-unset\fR
حذف نسخه‌ای که قبلاً تنظیم شده است
.TP
\fB\-\-raw\fR
اتصال مستقیم stdin/stdout/stderr دستور نصب backend به ترمینال؛ مستلزم \-\-jobs=1 است
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) برای استفاده
.SH "MISE SHELL-ALIAS"
مدیریت نام‌های مستعار (alias) شل.
.PP
\fBنحوه استفاده:\fR mise shell\-alias [OPTIONS] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-no\-header\fR
عدم نمایش سربرگ جدول
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE SHELL-ALIAS GET"
نمایش دستور مربوط به یک نام مستعار پوسته
.PP
\fBکاربرد:\fR mise shell\-alias get [OPTIONS] <shell_alias>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<shell_alias>\fR
نام مستعاری که باید نمایش داده شود
.SH "MISE SHELL-ALIAS LS"
فهرست کردن نام‌های مستعار پوسته

نام‌های مستعار پوسته‌ای را که در دایرکتوری جاری تنظیم شده‌اند نمایش می‌دهد.
این موارد در `mise.toml` زیر بخش `[shell_alias]` تعریف می‌شوند.
.PP
\fBکاربرد:\fR mise shell\-alias ls [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-no\-header\fR
عدم نمایش سرستون جدول
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
.SH "MISE SHELL-ALIAS SET"
افزودن/به‌روزرسانی یک نام مستعار پوسته

این دستور محتویات ~/.config/mise/config.toml را تغییر می‌دهد.
.PP
\fBکاربرد:\fR mise shell\-alias set [OPTIONS] <shell_alias> [<COMMAND>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<shell_alias>\fR
نام مستعار
.TP
\fB<COMMAND>\fR
دستوری که باید اجرا شود (در صورتی که به شکل ALIAS=COMMAND ارائه شود اختیاری است)
.SH "MISE SHELL-ALIAS UNSET"
حذف یک نام مستعار پوسته

این دستور محتویات ~/.config/mise/config.toml را تغییر می‌دهد.
.PP
\fBکاربرد:\fR mise shell\-alias unset [OPTIONS] <shell_alias>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<shell_alias>\fR
نام مستعاری که باید حذف شود
.SH "MISE SPONSORS"
نمایش شرکت‌های حامی مالی mise و ابزارهای متن‌باز jdx.dev
.PP
\fBکاربرد:\fR mise sponsors [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
.SH "MISE SYNC"
همگام‌سازی ابزارها از سایر مدیرهای نسخه با mise
.PP
\fBکاربرد:\fR mise sync [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
چاپ راهنما.SH "MISE SYNC NODE"
ایجاد پیوند نمادین (symlink) از تمام نسخه‌های ابزار موجود در یک ابزار خارجی به داخل mise

برای نمونه، از این دستور برای وارد کردن تمام نسخه‌های نصب‌شده node از طریق Homebrew به mise استفاده کنید

این دستور، موارد نصب‌شده مدیریت‌شده، نام‌های مستعار زمان اجرا (runtime aliases) یا پیوندهای سایر ارائه‌دهندگان را بازنویسی نخواهد کرد.
.PP
\fBنحوه استفاده:\fR mise sync node [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-brew\fR
دریافت نسخه‌های ابزار از Homebrew
.TP
\fB\-\-nodenv\fR
دریافت نسخه‌های ابزار از nodenv
.TP
\fB\-\-nvm\fR
دریافت نسخه‌های ابزار از nvm
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE SYNC PYTHON"
ایجاد پیوند نمادین (symlink) از تمام نسخه‌های ابزار موجود در یک ابزار خارجی به داخل mise

برای نمونه، از این دستور برای وارد کردن تمام نسخه‌های نصب‌شده pyenv به mise استفاده کنید

این دستور، موارد نصب‌شده مدیریت‌شده، نام‌های مستعار زمان اجرا (runtime aliases) یا پیوندهای سایر ارائه‌دهندگان را بازنویسی نخواهد کرد.
.PP
\fBنحوه استفاده:\fR mise sync python [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-pyenv\fR
دریافت نسخه‌های ابزار از pyenv
.TP
\fB\-\-uv\fR
همگام‌سازی نسخه‌های ابزار با uv (همگام‌سازی دوطرفه)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE SYNC RUBY"
ایجاد پیوند نمادین (symlink) از تمام نسخه‌های ابزار ruby از یک ابزار خارجی به داخل mise
.PP
\fBنحوه استفاده:\fR mise sync ruby [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-brew\fR
دریافت نسخه‌های ابزار از Homebrew
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE TASKS"
مدیریت وظایف
.PP
\fBنحوه استفاده:\fR mise tasks [OPTIONS] [<TASK>] [COMMAND]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-g, \-\-global\fR
فقط نمایش وظایف سراسری (global)
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-l, \-\-local\fR
فقط نمایش وظایف غیرسراسری (محلی)
.TP
\fB\-x, \-\-extended\fR
نمایش تمام ستون‌ها
.TP
\fB\-\-all\fR
بارگذاری تمام وظایف از کل monorepo، از جمله دایرکتوری‌های هم‌سطح (sibling).
به‌طور پیش‌فرض، تنها وظایف مربوط به سلسله‌مراتب دایرکتوری جاری بارگذاری می‌شوند.
.TP
\fB\-\-complete\fR
نمایش وظایف جهت تکمیل خودکار دستورات (completion)
.TP
\fB\-\-hidden\fR
نمایش وظایف پنهان
.TP
\fB\-\-name\-only\fR
تنها نمایش نام وظایف، یک مورد در هر خط. مناسب برای ارسال از طریق لوله (pipe) به fzf و ابزارهای مشابه.
.TP
\fB\-\-no\-header\fR
عدم چاپ سربرگ جدول
.TP
\fB\-\-sort\fR \fI<COLUMN>\fR
مرتب‌سازی بر اساس ستون. پیش‌فرض name است.
.TP
\fB\-\-sort\-order\fR \fI<SORT_ORDER>\fR
ترتیب مرتب‌سازی. پیش‌فرض asc است.
.TP
\fB\-\-usage\fR
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASK>\fR
نام وظیفه برای دریافت اطلاعات آن.SH "MISE TASKS ADD"
ایجاد یک وظیفه جدید

یک وظیفه را به فایل محلی mise.toml اضافه می‌کند.
ببینید: https://mise.jdx.dev/configuration.html#target\-file\-for\-write\-operations
.PP
\fBنحوه استفاده:\fR mise tasks add [OPTIONS] <TASK> [<RUN>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-alias\fR \fI<ALIAS>\fR
نام‌های دیگر برای وظیفه
.TP
\fB\-d, \-\-depends\fR \fI<DEPENDS>\fR
افزودن وابستگی‌ها به این وظیفه
.TP
\fB\-D, \-\-dir\fR \fI<DIR>\fR
اجرای وظیفه در یک دایرکتوری مشخص
.TP
\fB\-f, \-\-file\fR
ایجاد یک وظیفه بر پایه فایل به‌جای وظیفه toml
.TP
\fB\-H, \-\-hide\fR
مخفی کردن وظیفه از `mise tasks` و تکمیل خودکار (completions)
.TP
\fB\-q, \-\-quiet\fR
عدم چاپ دستور پیش از اجرا
.TP
\fB\-r, \-\-raw\fR
اتصال مستقیم stdin/stdout/stderr
.TP
\fB\-s, \-\-sources\fR \fI<SOURCES>\fR
الگوهای سراسری (glob) فایل‌هایی که این وظیفه به عنوان ورودی استفاده می‌کند
.TP
\fB\-w, \-\-wait\-for\fR \fI<WAIT_FOR>\fR
انتظار برای تکمیل این وظایف در صورتی که قرار است اجرا شوند
.TP
\fB\-\-depends\-post\fR \fI<DEPENDS_POST>\fR
وابستگی‌هایی که پس از اجرای این وظیفه اجرا می‌شوند
.TP
\fB\-\-description\fR \fI<DESCRIPTION>\fR
توضیحات وظیفه
.TP
\fB\-\-outputs\fR \fI<OUTPUTS>\fR
الگوهای سراسری (glob) فایل‌هایی که این وظیفه می‌سازد، برای صرف‌نظر کردن در صورت تغییر نیافتن آن‌ها
.TP
\fB\-\-run\-windows\fR \fI<RUN_WINDOWS>\fR
دستور برای اجرا در ویندوز
.TP
\fB\-\-shell\fR \fI<SHELL>\fR
اجرای وظیفه در یک پوسته مشخص
.TP
\fB\-\-silent\fR
عدم چاپ دستور یا خروجی آن
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASK>\fR
نام وظیفه برای افزودن
.SH "MISE TASKS DEPS"
نمایش ساختار درختی از گراف وابستگی‌ها

این گراف از روی وابستگی‌های اعلام‌شده ساخته می‌شود: `depends`، `depends_post`
و `wait_for`. ارجاعات وظیفه درون آرایه `run` یا `run_windows`
(`{ task = "..." }` یا `{ tasks = [...] }`) مراحل اجرایی هستند نه یال‌های
گراف، بنابراین در اینجا نمایش داده نمی‌شوند. آن وظایف تودرتو همچنان اجرا
می‌شوند، از جمله `depends`های خودشان.
.PP
\fBنحوه استفاده:\fR mise tasks deps [OPTIONS] [<TASKS>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-compact\fR
جمع‌کردن وابستگی‌های تکراری پس از اولین رخداد آن‌ها
.TP
\fB\-\-dot\fR
نمایش وابستگی‌ها در قالب DOT
.TP
\fB\-\-hidden\fR
نمایش وظایف مخفی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASKS>\fR
وظایفی که وابستگی‌های آن‌ها نمایش داده می‌شود
می‌توان چندین وظیفه را با جدا کردن توسط فاصله مشخص کرد
مثال: mise tasks deps lint test check.SH "MISE TASKS EDIT"
ویرایش یک تسک با $EDITOR

اگر تسک از قبل وجود نداشته باشد، به صورت یک اسکریپت مستقل ایجاد خواهد شد.
.PP
\fBنحوه استفاده:\fR mise tasks edit [OPTIONS] <TASK>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-p, \-\-path\fR
نمایش مسیر تسک به جای ویرایش آن
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASK>\fR
تسک مورد نظر برای ویرایش
.SH "MISE TASKS GRAPH"
[آزمایشی] بررسی گراف پروژه‌های فضای کاری (workspace)
.PP
\fBنحوه استفاده:\fR mise tasks graph [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی گرفتن از گراف پروژه در قالب JSON
.TP
\fB\-\-explain\fR
توضیح انتساب ارائه‌دهنده (provider) برای پروژه‌ها و تسک‌های استنتاج‌شده
.TP
\fB\-\-no\-header\fR
عدم چاپ سرستون‌های جدول
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
.SH "MISE TASKS INFO"
دریافت اطلاعات درباره یک تسک
.PP
\fBنحوه استفاده:\fR mise tasks info [OPTIONS] <TASK>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASK>\fR
نام تسک برای دریافت اطلاعات درباره آن
.SH "MISE TASKS LS"
فهرست کردن تسک‌های در دسترس برای اجرا
این تسک‌ها ممکن است از فایل پیکربندی یا از دایرکتوری .mise/tasks پروژه گنجانده شده باشند
دستور mise تمام تسک‌ها را از تمامی دایرکتوری‌های والد در این فهرست ادغام می‌کند.

بنابراین اگر تسک‌های سراسری در `~/.config/mise/tasks/*` و تسک‌های اختصاصی پروژه در
~/myproject/.mise/tasks/* داشته باشید، هر دوی آن‌ها در دسترس خواهند بود؛ اما تسک‌های
اختصاصی پروژه در صورت هم‌نام بودن بر تسک‌های سراسری اولویت داشته و جایگزین آن‌ها می‌شوند.
.PP
\fBنحوه استفاده:\fR mise tasks ls [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-g, \-\-global\fR
فقط نمایش تسک‌های سراسری
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-l, \-\-local\fR
فقط نمایش تسک‌های غیرسراسری
.TP
\fB\-x, \-\-extended\fR
نمایش تمام ستون‌ها
.TP
\fB\-\-all\fR
بارگذاری تمام تسک‌ها از کل monorepo، از جمله دایرکتوری‌های هم‌سطح (sibling).
به‌طور پیش‌فرض، تنها تسک‌های سلسله‌مراتب دایرکتوری فعلی بارگذاری می‌شوند.
.TP
\fB\-\-complete\fR
نمایش تسک‌ها برای تکمیل خودکار (completion)
.TP
\fB\-\-hidden\fR
نمایش تسک‌های پنهان
.TP
\fB\-\-name\-only\fR
فقط نمایش نام تسک‌ها، در هر سطر یک مورد. مناسب برای هدایت (pipe) خروجی به fzf و ابزارهای مشابه.
.TP
\fB\-\-no\-header\fR
عدم چاپ سرستون جدول
.TP
\fB\-\-sort\fR \fI<COLUMN>\fR
مرتب‌سازی بر اساس ستون. پیش‌فرض name است.
.TP
\fB\-\-sort\-order\fR \fI<SORT_ORDER>\fR
ترتیب مرتب‌سازی. پیش‌فرض asc است.
.TP
\fB\-\-usage\fR
.TP
\fB\-h, \-\-help\fR
نمایش راهنما.SH "MISE TASKS RUN"
اجرای وظیفه(ها)

این دستور یک وظیفه، یا چندین وظیفه را به‌صورت موازی اجرا می‌کند.
وظایف ممکن است به وظایف دیگر یا به فایل‌های منبع وابسته باشند.
اگر منبع (source) برای یک وظیفه پیکربندی شده باشد، تنها زمانی اجرا خواهد شد
که فایل‌های منبع تغییر کرده باشند.

وظایف می‌توانند در mise.toml یا به‌صورت اسکریپت‌های مستقل تعریف شوند.
در mise.toml، وظایف به این شکل تعریف می‌شوند:

    [tasks.build]
    run = "npm run build"
    sources = ["src/**/*.ts"]
    outputs = ["dist/**/*.js"]

همچنین وظایف می‌توانند به‌صورت اسکریپت‌های مستقل تعریف شوند.
این اسکریپت‌ها باید در `mise\-tasks`، `.mise\-tasks`، `.mise/tasks`، `mise/tasks` یا
`.config/mise/tasks` قرار داشته باشند.
نام اسکریپت، همان نام وظیفه خواهد بود.

    $ cat .mise/tasks/build<<EOF
    #!/usr/bin/env bash
    npm run build
    EOF
    $ mise run build
.PP
\fBنحوه استفاده:\fR mise tasks run [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-affected\fR
اجرای وظایف منطبق، تنها برای پروژه‌های متأثر از تغییرات Git
.TP
\fB\-\-affected\-base\fR \fI<REV>\fR
نسخه پایه در Git برای \-\-affected
پیش‌فرض: MISE_AFFECTED_BASE، فراداده CI یا HEAD~1 است
.TP
\fB\-\-affected\-explain\fR
توضیح دلیل انتخاب پروژه‌ها و وظایف توسط \-\-affected
.TP
\fB\-\-affected\-head\fR \fI<REV>\fR
نسخه head در Git برای \-\-affected
پیش‌فرض: MISE_AFFECTED_HEAD، فراداده CI یا HEAD است
.TP
\fB\-\-affected\-json\fR
نمایش پروژه‌ها و وظایف متأثر در قالب JSON بدون اجرای وظایف
.TP
\fB\-\-all\fR
باز کردن انتخاب‌گر تعاملی همراه با تمام وظایف از کل monorepo
.TP
\fB\-c, \-\-continue\-on\-error\fR
ادامه اجرای وظایف حتی در صورت شکست خوردن یکی از آن‌ها
.TP
\fB\-C, \-\-cd\fR \fI<CD>\fR
تغییر به این دایرکتوری پیش از اجرای دستور
.TP
\fB\-f, \-\-force\fR
اجبار وظایف به اجرا حتی اگر خروجی‌ها به‌روز باشند
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد وظایف برای اجرا به‌صورت موازی
مقادیر کمتر از ۱ برابر ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
قابل پیکربندی با تنظیمات `jobs` یا متغیر محیطی `MISE_JOBS`
.RS
\fIمحیط: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-n, \-\-dry\-run\fR
عدم اجرای واقعی وظیفه(ها)، فقط چاپ آن‌ها به ترتیب اجرا
.TP
\fB\-o, \-\-output\fR \fI<OUTPUT>\fR
تغییر نحوه نمایش خروجی اطلاعات وظایف هنگام اجرای آن‌ها

\- `prefix` \- چاپ خط به خط stdout/stderr، همراه با برچسب وظیفه به‌عنوان پیشوند
\- `interleave` \- چاپ مستقیم در stdout/stderr به‌جای خط به خط
\- `replacing` \- در هر بار stdout جایگزین می‌شود و stderr همان‌طور که هست چاپ می‌شود
\- `timed` \- تنها خطوط stdout نمایش داده می‌شوند اگر بیش از ۱ ثانیه نمایش داده شوند
\- `keep\-order` \- چاپ خط به خط stdout/stderr همراه با برچسب وظیفه به‌عنوان پیشوند، ولی با حفظ ترتیب خروجی
\- `quiet` \- عدم نمایش خروجی اضافی
\- `silent` \- عدم نمایش هرگونه خروجی شامل stdout و stderr از وظیفه، به‌جز خطاها
.RS
\fIمحیط: \fR\fBMISE_TASK_OUTPUT\fR
.RE
.TP
\fB\-q, \-\-quiet\fR
عدم نمایش خروجی اضافی
.RS
\fIمحیط: \fR\fBMISE_QUIET\fR
.RE
.TP
\fB\-r, \-\-raw\fR
خواندن/نوشتن مستقیم در stdin/stdout/stderr به‌جای خط به خط
با این گزینه، حذف اطلاعات حساس (redactions) اعمال نمی‌شود
قابل پیکربندی با تنظیمات `raw` یا متغیر محیطی `MISE_RAW`
.TP
\fB\-s, \-\-shell\fR \fI<SHELL>\fR
پوسته مورد استفاده برای اجرای وظایف toml

پیش‌فرض در unix برابر `sh \-c \-o errexit \-o pipefail` و در Windows برابر `cmd /c` است
همچنین می‌تواند با تنظیم `MISE_UNIX_DEFAULT_INLINE_SHELL_ARGS` یا `MISE_WINDOWS_DEFAULT_INLINE_SHELL_ARGS` تعیین شود
یا با ویژگی `shell` روی یک وظیفه بازنویسی شود.
.TP
\fB\-S, \-\-silent\fR
عدم نمایش هرگونه خروجی به‌جز خطاها
.RS
\fIمحیط: \fR\fBMISE_SILENT\fR
.RE
.TP
\fB\-t, \-\-tool\fR \fI<TOOL@VERSION>\fR
ابزار(ها)یی که باید علاوه بر آنچه در فایل‌های mise.toml است اجرا شوند؛ مانند: node@20 python@3.10
.TP
\fB\-\-allow\-env\fR \fI<VAR>\fR
اجازه عبور به متغیر محیطی مشخص‌شده (به‌طور ضمنی باعث اعمال \-\-deny\-env برای بقیه می‌شود)
از نویسه‌های عام (wildcard) پشتیبانی می‌کند، مانند: \-\-allow\-env=\(aqMYAPP_*\(aq
.TP
\fB\-\-allow\-net\fR \fI<HOST>\fR
اجازه دسترسی شبکه به میزبان مشخص‌شده (به‌طور ضمنی باعث اعمال \-\-deny\-net برای بقیه می‌شود)
.TP
\fB\-\-allow\-read\fR \fI<PATH>\fR
اجازه خواندن از مسیر مشخص‌شده (به‌طور ضمنی باعث اعمال \-\-deny\-read برای بقیه می‌شود)
.TP
\fB\-\-allow\-write\fR \fI<PATH>\fR
اجازه نوشتن در مسیر مشخص‌شده (به‌طور ضمنی باعث اعمال \-\-deny\-write برای بقیه می‌شود)
.TP
\fB\-\-deny\-all\fR
مسدودسازی خواندن‌ها، نوشتن‌ها، شبکه و متغیرهای محیطی
.TP
\fB\-\-deny\-env\fR
مسدودسازی به ارث بردن متغیرهای محیطی (تنها PATH، HOME، USER، SHELL، TERM و LANG عبور می‌کنند)
.TP
\fB\-\-deny\-net\fR
مسدودسازی تمامی دسترسی‌های شبکه
.TP
\fB\-\-deny\-read\fR
مسدودسازی خواندن از سامانه فایل (کتابخانه‌های سیستمی و دایرکتوری‌های ابزار همچنان در دسترس خواهند بود)
.TP
\fB\-\-deny\-write\fR
مسدودسازی تمامی نوشتن‌ها در سامانه فایل
.TP
\fB\-\-fresh\-env\fR
دور زدن حافظه موقت (cache) محیط و محاسبه مجدد محیط
.TP
\fB\-\-no\-cache\fR
عدم استفاده از حافظه موقت (cache) در وظایف راه‌دور
.RS
\fIمحیط: \fR\fBMISE_TASK_REMOTE_NO_CACHE\fR
.RE
.TP
\fB\-\-no\-deps\fR
صرف‌نظر کردن از آماده‌سازی خودکار وابستگی‌ها
.TP
\fB\-\-no\-timings\fR
پنهان کردن زمان سپری‌شده پس از تکمیل هر وظیفه

پیش‌فرض با `MISE_TASK_TIMINGS=0` همواره پنهان است
.TP
\fB\-\-skip\-deps\fR
تنها اجرای وظایف مشخص‌شده با صرف‌نظر از تمامی وابستگی‌ها
.RS
\fIمحیط: \fR\fBMISE_TASK_SKIP_DEPENDS\fR
.RE
.TP
\fB\-\-skip\-tools\fR
صرف‌نظر از نصب ابزارها پیش از اجرای وظایف

همچنین می‌تواند به‌طور ماندگار با تنظیم `task.run_auto_install`
یا متغیر محیطی `MISE_TASK_RUN_AUTO_INSTALL=false` تعیین شود
.TP
\fB\-\-task\-cache\fR \fI<TASK_CACHE>\fR
تنظیم دسترسی به حافظه موقت (cache) خروجی وظیفه برای این اجرا

\- `read\-write` \- خواندن نتایج کش‌شده و نوشتن نتایج جدید
\- `read\-only` \- خواندن نتایج کش‌شده بدون نوشتن نتایج جدید
\- `write\-only` \- نوشتن نتایج جدید بدون خواندن نتایج کش‌شده
\- `off` \- غیرفعال‌سازی کش کردن خروجی وظیفه
\- `local\-only` \- فقط خواندن و نوشتن در حافظه موقت محلی؛ در حال حاضر معادل `read\-write` است
.RS
\fIپیش‌فرض: \fRread\-write
.RE
.RS
\fIمحیط: \fR\fBMISE_TASK_CACHE\fR
.RE.TP
\fB\-\-task\-cache\-explain\fR
توضیح ورودی‌هایی که کلید کَش (cache key) خروجی هر وظیفه را تولید کرده‌اند
.TP
\fB\-\-task\-cache\-explain\-json\fR
خروجی دادن جزئیات ورودی کلید کَش به‌صورت JSON Lines بدون اجرای وظایف
.TP
\fB\-\-task\-cache\-stats\fR
گزارش موارد اصابت کَش (cache hits) خروجی وظیفه، بایت‌های بازیابی‌شده و زمان صرفه‌جویی‌شده
.TP
\fB\-\-timeout\fR \fI<TIMEOUT>\fR
مهلت زمانی برای تکمیل وظیفه
به‌عنوان مثال: 30s, 5m
.TP
\fB\-\-timings\fR
نمایش زمان سپری‌شده پس از تکمیل هر وظیفه

به‌طور پیش‌فرض همیشه با `MISE_TASK_TIMINGS=1` نمایش داده می‌شود
.SH "MISE TASKS VALIDATE"
اعتبارسنجی وظایف برای بررسی خطاها و مشکلات رایج
.PP
\fBنحوه استفاده:\fR mise tasks validate [OPTIONS] [<TASKS>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-errors\-only\fR
فقط نمایش خطاها (صرف‌نظر از هشدارها)
.TP
\fB\-\-json\fR
خروجی نتایج اعتبارسنجی در قالب JSON
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TASKS>\fR
وظایف برای اعتبارسنجی
در صورت عدم تعیین، تمام وظایف اعتبارسنجی می‌شوند
.SH "MISE TEST-TOOL"
آزمایش این‌که یک ابزار نصب و اجرا می‌شود
.PP
\fBنحوه استفاده:\fR mise test\-tool [OPTIONS] [<TOOLS>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
آزمایش تمام ابزارهای مشخص‌شده در registry/
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد آزمون‌های ابزار برای اجرا به‌صورت موازی
مقادیر کمتر از ۱ به عنوان ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
.RS
\fIمتغیر محیطی: \fR\fBMISE_TEST_TOOL_JOBS\fR
.RE
.TP
\fB\-\-all\-config\fR
آزمایش تمام ابزارهای مشخص‌شده در فایل‌های پیکربندی
.TP
\fB\-\-include\-non\-defined\fR
همچنین آزمایش ابزارهایی که در registry/ تعریف نشده‌اند، با حدس زدن نحوه آزمایش آن‌ها
.TP
\fB\-\-raw\fR
اتصال مستقیم stdin/stdout/stderr دستور نصب backend به ترمینال؛ مستلزم \-\-jobs=1 است
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOLS>\fR
ابزار(ها) برای آزمایش
.SH "MISE TOKEN"
نمایش توکن‌های ارائه‌دهنده git که mise استفاده خواهد کرد
.PP
\fBنحوه استفاده:\fR mise token [OPTIONS] <COMMAND>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
چاپ راهنما.SH "MISE TOKEN FORGEJO"
نمایش توکن Forgejo که mise برای یک میزبان مشخص استفاده خواهد کرد

نشان می‌دهد که mise از کدام منبع توکن استفاده خواهد کرد؛ مفید برای عیب‌یابی
مشکلات احراز هویت. توکن به‌طور پیش‌فرض ماسک شده است.
.PP
\fBنحوه استفاده:\fR mise token forgejo [OPTIONS] [<HOST>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-unmask\fR
نمایش کامل توکن بدون ماسک
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<HOST>\fR
نام میزبان Forgejo
.RS
\fIپیش‌فرض: \fRcodeberg.org
.RE
.SH "MISE TOKEN GITHUB"
نمایش توکن GitHub که mise برای یک میزبان مشخص استفاده خواهد کرد

نشان می‌دهد که mise از کدام منبع توکن استفاده خواهد کرد؛ مفید برای عیب‌یابی
مشکلات احراز هویت. توکن به‌طور پیش‌فرض ماسک شده است.
.PP
\fBنحوه استفاده:\fR mise token github [OPTIONS] [<HOST>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-oauth\fR
یافتن توکن فقط از طریق منبع بومی GitHub OAuth (حافظه نهان، refresh یا جریان device\-code)، با دور زدن سایر منابع توکن
.TP
\fB\-\-raw\fR
تنها چاپ مقدار توکن
.TP
\fB\-\-refresh\fR
تولید یک توکن OAuth تازه از طریق سازوکار اعطای refresh\-token یا یک جریان device\-code جدید، حتی اگر توکن موجود در حافظه نهان منقضی نشده باشد. پس از تغییر در نصب‌ها یا مجوزهای GitHub App استفاده شود: توکن‌های ذخیره‌شده در حافظه نهان تا زمان انقضا دسترسی اولیه خود را حفظ می‌کنند
.TP
\fB\-\-unmask\fR
نمایش کامل توکن بدون ماسک
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<HOST>\fR
نام میزبان GitHub
.RS
\fIپیش‌فرض: \fRgithub.com
.RE
.SH "MISE TOKEN GITLAB"
نمایش توکن GitLab که mise برای یک میزبان مشخص استفاده خواهد کرد

نشان می‌دهد که mise از کدام منبع توکن استفاده خواهد کرد؛ مفید برای عیب‌یابی
مشکلات احراز هویت. توکن به‌طور پیش‌فرض ماسک شده است.
.PP
\fBنحوه استفاده:\fR mise token gitlab [OPTIONS] [<HOST>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-\-unmask\fR
نمایش کامل توکن بدون ماسک
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<HOST>\fR
نام میزبان GitLab
.RS
\fIپیش‌فرض: \fRgitlab.com
.RE.SH "MISE TOOL"
دریافت اطلاعات درباره یک ابزار
.PP
\fBنحوه استفاده:\fR mise tool [OPTIONS] <TOOL>
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
خروجی در قالب JSON
.TP
\fB\-\-active\fR
فقط نمایش نسخه‌های فعال
.TP
\fB\-\-backend\fR
فقط نمایش فیلد backend
.TP
\fB\-\-config\-source\fR
فقط نمایش منبع پیکربندی
.TP
\fB\-\-description\fR
فقط نمایش فیلد توضیحات
.TP
\fB\-\-installed\fR
فقط نمایش نسخه‌های نصب‌شده
.TP
\fB\-\-requested\fR
فقط نمایش نسخه‌های درخواستی
.TP
\fB\-\-tool\-options\fR
فقط نمایش گزینه‌های ابزار
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL>\fR
نام ابزار برای دریافت اطلاعات درباره آن
.SH "MISE TOOL-STUB"
اجرای یک tool stub

فایل‌های tool stub، فایل‌های اجرایی حاوی پیکربندی TOML هستند که مشخص می‌کنند چه ابزاری و چگونه اجرا شود. آن‌ها روشی آسان برای ایجاد فایل‌های اجراییِ قابل‌حمل و مستقل فراهم می‌سازند که نصب و اجرای ابزار را به‌طور خودکار مدیریت می‌کنند.

یک tool stub شامل موارد زیر است:

\- یک خط shebang: #!/usr/bin/env \-S mise tool\-stub \- پیکربندی TOML مشخص‌کننده ابزار، نسخه و گزینه‌ها \- توضیحات اختیاری برای شرح هدف ابزار

نمونه فایل stub:

```toml
#!/usr/bin/env \-S mise tool\-stub
# Node.js v20 development environment

tool = "node"
version = "20.0.0"
bin = "node"
```

در صورت عدم وجود نسخه مشخص‌شده از ابزار، استاب به‌طور خودکار آن را نصب کرده و همراه با هر آرگومان ارسالی به استاب اجرا می‌کند.

برای اطلاعات بیشتر، ببینید: https://mise.jdx.dev/dev\-tools/tool\-stubs.html
.PP
\fBنحوه استفاده:\fR mise tool\-stub <FILE> [<ARGS>] ...
.PP
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<FILE>\fR
مسیر فایل TOML استابِ ابزار جهت اجرا

فایل استاب باید حاوی پیکربندی TOML باشد که ابزار و نسخه را برای اجرا مشخص کند. در کمترین حالت، باید فیلد \(aqversion\(aq را مشخص کند. سایر فیلدهای رایج شامل \(aqtool\(aq، \(aqbin\(aq و گزینه‌های ویژه backend هستند.
.TP
\fB<ARGS>\fR
آرگومان‌هایی که باید به ابزار ارسال شوند

تمام آرگومان‌های پس از مسیر فایل استاب به ابزار زیربنایی هدایت خواهند شد. در صورت نیاز، از \(aq\-\-\(aq برای جداسازی آرگومان‌های mise از آرگومان‌های ابزار استفاده کنید.
.SH "MISE TRUST"
علامت‌گذاری یک فایل پیکربندی به عنوان مورد اعتماد

این بدان معناست که به mise اجازه داده می‌شود هنگام نیاز به خواندن پیکربندی‌ای که ممکن است کدی را اجرا کرده یا بر محیط اثر بگذارد، فایل را تجزیه کند. بدون اعتماد، mise ممکن است اعلان تایید نمایش دهد، پیکربندی را در برخی مسیرهای شناسایی نادیده بگیرد، یا در صورتی که امکان نمایش اعلان نباشد با خطای untrusted\-config متوقف شود.

در حالت عادی (normal mode)، دستوراتی که رفتارهای تعریف‌شده توسط پروژه را اجرا می‌کنند (`mise run`، فراخوانی مستقیم وظایف مانند `mise <TASK>`، `mise install`، `mise exec` و `mise watch`) به‌طور خودکار به پیکربندی فعال خود اعتماد می‌کنند. حالت Paranoid نیازمند اعتماد صریح و وابسته به محتوا (content\-bound) برای هر پیکربندی غیرعمومی (non\-global) است.

در حالت عادی، فایل‌های پیکربندی امن نیازی به اعتماد ندارند: فایل‌هایی که فقط حاوی `min_version`، مدخل‌های `[tools]` با رشته‌های نگارش ساده (یا آرایه‌ای از آن‌ها) و `[tasks]` بدون الگوها یا گزینه‌های ابزار هستند.

اعتماد در سراسر git worktreeها به اشتراک گذاشته می‌شود: یک فایل پیکربندی درون یک worktree متصل، در صورتی مورد اعتماد است که مسیر معادل آن در checkout اصلی مخزن مورد اعتماد قرار گرفته باشد. حالت Paranoid این اشتراک‌گذاری را غیرفعال می‌کند؛ زیرا worktreeها می‌توانند شاخه‌هایی با محتویات پیکربندی متفاوت را checkout کنند.
.PP
\fBنحوه استفاده:\fR mise trust [OPTIONS] [<CONFIG_FILE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
اعتماد به تمام فایل‌های پیکربندی در دایرکتوری فعلی، والدهای آن و زیردایرکتوری‌هایش

زیردایرکتوری‌ها با رعایت .gitignore پیمایش می‌شوند و از دایرکتوری‌های مخفی و دایرکتوری‌های معمول بیلد/وابستگی (node_modules، vendor، target، dist، build) صرف‌نظر می‌شود.
.TP
\fB\-\-ignore\fR
به این پیکربندی اعتماد نکن و در آینده آن را نادیده بگیر
.TP
\fB\-\-show\fR
نمایش وضعیت اعتماد فایل‌های پیکربندی از دایرکتوری فعلی و والدهای آن.
هیچ فایلی را مورد اعتماد یا نامعتمد نمی‌کند.
.TP
\fB\-\-untrust\fR
حذف اعتماد صریح برای این پیکربندی
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<CONFIG_FILE>\fR
فایل پیکربندی که وضعیت اعتماد آن باید تغییر کند.SH "MISE UNINSTALL"
نسخه‌های نصب‌شده ابزار را حذف می‌کند

این دستور تنها نسخه نصب‌شده را حذف می‌کند و تغییری در mise.toml ایجاد نمی‌کند.
.PP
\fBنحوه استفاده:\fR mise uninstall [OPTIONS] [<INSTALLED_TOOL@VERSION>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-a, \-\-all\fR
حذف تمام نسخه‌های نصب‌شده
.TP
\fB\-n, \-\-dry\-run\fR
در عمل چیزی را حذف نمی‌کند (اجرای آزمایشی)
.TP
\fB\-\-dry\-run\-code\fR
مانند \-\-dry\-run عمل می‌کند، اما در صورت وجود ابزارهایی برای حذف، با کد ۱ خارج می‌شود

این گزینه برای اسکریپت‌ها جهت بررسی نیاز به حذف ابزارها مفید است.
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<INSTALLED_TOOL@VERSION>\fR
ابزار(ها) برای حذف
.SH "MISE UNSET"
حذف متغیر(های) محیطی از فایل پیکربندی.

به‌طور پیش‌فرض، این دستور `mise.toml` را در دایرکتوری جاری تغییر می‌دهد.
.PP
\fBنحوه استفاده:\fR mise unset [OPTIONS] [<ENV_KEY>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-f, \-\-file, \-\-path\fR \fI<FILE>\fR
مشخص کردن یک فایل برای استفاده به‌جای `mise.toml`

می‌تواند مسیر یک فایل یا دایرکتوری باشد. اگر دایرکتوری مشخص شود، mise.toml در آن دایرکتوری ایجاد یا استفاده خواهد شد.

پیش‌فرض متغیر محیطی [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) یا `mise.toml` است. از [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) برای انتخاب یک مسیر پیکربندی سراسری متفاوت استفاده کنید.
.TP
\fB\-g, \-\-global\fR
استفاده از فایل پیکربندی سراسری (global)
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<ENV_KEY>\fR
متغیر(های) محیطی برای حذف
مانند: NODE_ENV
.SH "MISE UNTRUST"
لغو اعتماد صریح برای یک فایل پیکربندی
.PP
\fBنحوه استفاده:\fR mise untrust [OPTIONS] [<CONFIG_FILE>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<CONFIG_FILE>\fR
فایل پیکربندی مورد نظر برای لغو اعتماد
.SH "MISE UNUSE"
نسخه‌های ابزار نصب‌شده را از mise.toml حذف می‌کند

به‌طور پیش‌فرض، از فایل `mise.toml` که ابزار در آن تعریف شده است استفاده خواهد شد.
اگر چندین فایل پیکربندی وجود داشته باشد (برای مثال، هم `mise.toml` و هم `mise.local.toml`)،
فایلی با کمترین اولویت (`mise.toml`) استفاده خواهد شد.
ببینید: <https://mise.jdx.dev/configuration.html#target\-file\-for\-write\-operations>

به ترتیب زیر:
  \- اگر `\-\-global` تنظیم شده باشد، از فایل پیکربندی سراسری استفاده خواهد شد.
  \- اگر `\-\-path` تنظیم شده باشد، از فایل پیکربندی در مسیر داده‌شده استفاده خواهد شد.
  \- اگر `\-\-env` تنظیم شده باشد، از `mise.<env>.toml` استفاده خواهد شد.
  \- اگر [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) تنظیم شده باشد، در عوض از آن استفاده خواهد شد.
  \- اگر `MISE_OVERRIDE_CONFIG_FILENAMES` تنظیم شده باشد، از نخستین مورد آن فهرست استفاده خواهد شد.
  \- در غیر این صورت صرفاً "mise.toml"، یا در صورت قرار داشتن cwd در دایرکتوری خانگی (home)، از پیکربندی سراسری استفاده می‌شود.

از [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) برای انتخاب یک مسیر پیکربندی سراسری متفاوت استفاده کنید.

همچنین در صورتی که هیچ پیکربندی دیگری از آن نسخه استفاده نکند، نسخه نصب‌شده را پاکسازی (prune) خواهد کرد.
.PP
\fBنحوه استفاده:\fR mise unuse [OPTIONS] <INSTALLED_TOOL@VERSION> ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-e, \-\-env\fR \fI<ENV>\fR
ایجاد یا ویرایش یک فایل پیکربندی وابسته به محیط مانند .mise.<env>.toml
.TP
\fB\-g, \-\-global\fR
استفاده از فایل پیکربندی سراسری (`~/.config/mise/config.toml`) به‌جای فایل محلی
.TP
\fB\-p, \-\-path, \-\-file\fR \fI<PATH>\fR
تعیین مسیر یک فایل یا دایرکتوری پیکربندی

در صورت تعیین دایرکتوری، طبق قوانین بالا به‌دنبال یک فایل پیکربندی در آن دایرکتوری می‌گردد.
.TP
\fB\-\-no\-prune\fR
نسخه نصب‌شده را پاکسازی (prune) نکند
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<INSTALLED_TOOL@VERSION>\fR
ابزار(ها) برای حذف.SH "MISE UPGRADE"
ابزارهای قدیمی را ارتقا می‌دهد

به‌طور پیش‌فرض، این دستور بازهٔ تعیین‌شده در mise.toml را حفظ می‌کند. بنابراین اگر node@20 تنظیم شده باشد، آن را
به آخرین نسخهٔ 20.x.x موجود ارتقا می‌دهد. برای استفاده از آخرین نسخه و ارتقای (bump) نسخه در mise.toml، پرچم
`\-\-bump` را ببینید.

در صورت فعال بودن، این دستور mise.lock را به‌روزرسانی می‌کند؛ ببینید: https://mise.jdx.dev/configuration/settings.html#lockfile
.PP
\fBکاربرد:\fR mise upgrade [OPTIONS] [<INSTALLED_TOOL@VERSION>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-b, \-\-bump\fR
ارتقا به آخرین نسخهٔ موجود و ارتقای نسخه در mise.toml

برای مثال، اگر `node = "20.0.0"` را در mise.toml خود داشته باشید اما 22.1.0 آخرین نسخهٔ موجود باشد،
این گزینه 22.1.0 را نصب کرده و `node = "22.1.0"` را در پیکربندی شما قرار می‌دهد.

این گزینه همان دقت نسخه‌ای را که پیش‌تر وجود داشت حفظ می‌کند؛ بنابراین اگر در عوض `node = "20"` را داشتید،
پیکربندی شما را به `node = "22"` تغییر می‌دهد.
.TP
\fB\-i, \-\-interactive\fR
نمایش منوی چندانتخابی برای برگزیدن ابزارهایی که باید ارتقا یابند
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد وظایفی که به‌طور موازی اجرا می‌شوند
مقدارهای کمتر از ۱ به‌صورت ۱ در نظر گرفته می‌شوند
[پیش‌فرض: 4]
.RS
\fIمتغیر محیطی: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-l\fR
شکل کوتاه‌شده و منسوخ‌شده برای \-\-bump
.TP
\fB\-n, \-\-dry\-run\fR
تنها کارهایی را که انجام خواهد شد نمایش می‌دهد، اما در عمل کاری انجام نمی‌دهد
.TP
\fB\-x, \-\-exclude\fR \fI<INSTALLED_TOOL>\fR
ابزار(هایی) که باید از ارتقا مستثنی شوند
مثال: go python
.TP
\fB\-\-dry\-run\-code\fR
مشابه \-\-dry\-run عمل می‌کند اما در صورت وجود ابزارهای قدیمی با کد ۱ خارج می‌شود

این گزینه برای اسکریپت‌ها جهت بررسی اینکه آیا ابزارها نیاز به ارتقا دارند یا خیر مفید است.
.TP
\fB\-\-inactive\fR
ارتقای تمام ابزارها، از جمله ابزارهای نصب‌شده اما غیرفعالی که در پیکربندی فعلی وجود ندارند
.TP
\fB\-\-local\fR
تنها ارتقای ابزارهایی که در فایل‌های پیکربندی محلی تعریف شده‌اند

این گزینه تنها ابزارهایی را ارتقا می‌دهد که در mise.toml محلیِ پروژه تعریف شده‌اند و
از ابزارهای تعریف‌شده در پیکربندی سراسری (~/.config/mise/config.toml) صرف‌نظر می‌کند.
.TP
\fB\-\-minimum\-release\-age\fR \fI<MINIMUM_RELEASE_AGE>\fR
تنها ارتقا به نسخه‌هایی که پیش از این تاریخ منتشر شده‌اند یا از این مدت‌زمان قدیمی‌تر هستند

از تاریخ‌های مطلق مانند "2024\-06\-01" و مدت‌زمان‌های نسبی مانند "90d" یا "1y" پشتیبانی می‌کند.
این گزینه می‌تواند برای اهداف بازتولیدپذیری یا امنیتی مفید باشد.

این ویژگی تنها بر تطابق‌های نسخه‌ای تقریبی مانند "20" یا "latest" اثر می‌گذارد.
نسخه‌هایی که صراحتاً پین شده‌اند (مانند "22.5.0") فیلتر نمی‌شوند.
.TP
\fB\-\-monorepo\fR
جای‌نگهدار برای ارتقاهای آینده در ساختارهای چندمخزنی (monorepo)؛ دستور `mise upgrade \-\-monorepo` هنوز پیاده‌سازی نشده است.
.TP
\fB\-\-no\-prune\fR
نسخه‌های قبلی که از آن‌ها به نسخه‌های جدیدتر ارتقا یافته است را حذف نکن

نسخهٔ قدیمی در جای خود باقی می‌ماند و برای حذف زمان‌بندی نمی‌شود. هنگامی از این گزینه استفاده کنید که
چیزی خارج از mise به دایرکتوری نصب اشاره داشته باشد.

برای تبدیل این حالت به پیش‌فرض، مقدار `upgrade.auto_prune = false` را تنظیم کنید.
.TP
\fB\-\-prune\fR
نسخه‌های قبلی که از آن‌ها ارتقا داده شده است را فوراً حذف کن

از این گزینه برای نادیده گرفتن `upgrade.prune_after`، یا خنثی‌کردن موقت `upgrade.auto_prune = false`
برای یک بار اجرا استفاده کنید.
.TP
\fB\-\-raw\fR
اتصال مستقیم ورودی/خروجی/خطای استاندارد (stdin/stdout/stderr) فرمان نصب پس‌زمینه به ترمینال؛ مستلزم \-\-jobs=1 است
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<INSTALLED_TOOL@VERSION>\fR
ابزار(ها) برای ارتقا
مثال: node@20 python@3.10
در صورت عدم تعیین، تمام ابزارهای فعلی ارتقا خواهند یافت.SH "MISE USE"
یک ابزار را نصب کرده و نسخه آن را به mise.toml اضافه می‌کند.

در صورتی که نسخه ابزار از قبل نصب نشده باشد، آن را نصب خواهد کرد.
به‌طور پیش‌فرض، از یک فایل `mise.toml` در دایرکتوری جاری استفاده خواهد شد.
اگر چند فایل پیکربندی وجود داشته باشد (برای مثال، هم `mise.toml` و هم `mise.local.toml`)،
فایلی با کمترین اولویت (`mise.toml`) استفاده خواهد شد.
ببینید: https://mise.jdx.dev/configuration.html#target\-file\-for\-write\-operations

به ترتیب زیر:
  \- اگر `\-\-global` تنظیم شده باشد، از فایل پیکربندی سراسری استفاده می‌کند.
  \- اگر `\-\-path` تنظیم شده باشد، از فایل پیکربندی در مسیر داده‌شده استفاده می‌کند.
  \- اگر `\-\-env` تنظیم شده باشد، از `mise.<env>.toml` استفاده می‌کند.
  \- اگر [`MISE_DEFAULT_CONFIG_FILENAME`](https://mise.jdx.dev/configuration.html#mise_default_config_filename) تنظیم شده باشد، در عوض از آن استفاده می‌کند.
  \- اگر `MISE_OVERRIDE_CONFIG_FILENAMES` تنظیم شده باشد، از اولین مورد آن فهرست استفاده خواهد کرد.
  \- در غیر این صورت، صرفاً "mise.toml" یا اگر cwd دایرکتوری خانگی باشد، پیکربندی سراسری.

برای انتخاب یک مسیر پیکربندی سراسری متفاوت از [`MISE_GLOBAL_CONFIG_FILE`](https://mise.jdx.dev/configuration.html#mise_global_config_file) استفاده کنید.

برای استفاده از فایل پیکربندی سراسری، از پرچم `\-\-global` استفاده کنید.
.PP
\fBنحوه استفاده:\fR mise use [OPTIONS] [TOOL@VERSION]…
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-e, \-\-env\fR \fI<ENV>\fR
ایجاد یا اصلاح یک فایل پیکربندی مخصوص محیط مانند .mise.<env>.toml
.TP
\fB\-f, \-\-force\fR
اجبار به نصب مجدد حتی در صورت نصب بودن از قبل
.TP
\fB\-g, \-\-global\fR
استفاده از فایل پیکربندی سراسری (`~/.config/mise/config.toml`) به جای فایل محلی
.TP
\fB\-j, \-\-jobs\fR \fI<JOBS>\fR
تعداد کارهایی که به صورت موازی اجرا می‌شوند
مقادیر کمتر از 1 به عنوان 1 در نظر گرفته می‌شوند
[پیش‌فرض: 4]
.RS
\fIمحیط: \fR\fBMISE_JOBS\fR
.RE
.TP
\fB\-n, \-\-dry\-run\fR
اجرای آزمایشی، نمایش مواردی که بدون اعمال تغییرات نصب یا اصلاح خواهند شد
.TP
\fB\-p, \-\-path\fR \fI<PATH>\fR
مشخص کردن مسیر یک فایل پیکربندی یا دایرکتوری

اگر یک دایرکتوری مشخص شود، با پیروی از قوانین بالا به دنبال یک فایل پیکربندی در آن دایرکتوری خواهد گشت.
.TP
\fB\-\-dry\-run\-code\fR
مانند \-\-dry\-run اما در صورت وجود تغییراتی برای اعمال، با کد خروج 1 خارج می‌شود

این گزینه برای اسکریپت‌ها جهت بررسی نیاز به افزودن یا حذف ابزارها مفید است.
.TP
\fB\-\-fuzzy\fR
ذخیره نسخه تقریبی (fuzzy) در فایل پیکربندی

برای مثال: `mise use \-\-fuzzy node@20` مقدار 20 را به عنوان نسخه ذخیره خواهد کرد
این رفتار پیش‌فرض است مگر اینکه `MISE_PIN=1` تنظیم شده باشد
.TP
\fB\-\-minimum\-release\-age\fR \fI<MINIMUM_RELEASE_AGE>\fR
تنها نصب نسخه‌هایی که پیش از این تاریخ منتشر شده‌اند یا از این مدت زمان قدیمی‌تر هستند

از تاریخ‌های مطلق مانند "2024\-06\-01" و مدت زمان‌های نسبی مانند "90d" یا "1y" پشتیبانی می‌کند.
.TP
\fB\-\-pin\fR
ذخیره نسخه دقیق و مشخص‌شده در فایل پیکربندی

اگر درخواست دقیقاً با یکی از نسخه‌های منتشرشده مطابقت داشته باشد، آن نسخه بر
تطابق‌های تقریبی نصب‌شده ترجیح داده می‌شود. از `prefix:` برای درخواست صریح تطابق پیشوندی بازگشتی استفاده کنید.
برای مثال: `mise use \-\-pin node@20` نسخه حل‌شده `20.x.y` را ذخیره خواهد کرد
برای اینکه این مورد رفتار پیش‌فرض باشد، `MISE_PIN=1` را تنظیم کنید

استفاده از mise.lock را به عنوان جایگزینی بهتر برای پین کردن در mise.toml مد نظر قرار دهید:
https://mise.jdx.dev/configuration/settings.html#lockfile
.TP
\fB\-\-raw\fR
اتصال مستقیم stdin/stdout/stderr دستور نصب backend به ترمینال؛ مستلزم `\-\-jobs=1` است
.TP
\fB\-\-remove\fR \fI<TOOL>\fR
حذف ابزار(ها) از فایل پیکربندی
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
.TP
\fB\-\-postinstall\fR \fI<COMMAND>\fR
دستوری که پس از نصب این ابزار اجرا می‌شود
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار برای افزودن به فایل پیکربندی

برای مثال: node@20, cargo:ripgrep@latest npm:prettier@3
اگر نسخه‌ای مشخص نشود، مقدار پیش‌فرض @latest خواهد بود

گزینه‌های ابزار را می‌توان با این ساختار دستوری تنظیم کرد:

    mise use ubi:BurntSushi/ripgrep[exe=rg].SH "MISE VERSION"
نمایش نسخه mise

نسخه، سیستم‌عامل، معماری و تاریخ ساخت (build) را نمایش می‌دهد.

اگر نسخه قدیمی باشد، یک هشدار نمایش داده می‌شود.
.PP
\fBکاربرد:\fR mise version [OPTIONS]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-J, \-\-json\fR
چاپ اطلاعات نسخه در قالب JSON
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
.SH "MISE WATCH"
اجرای تسک(ها) و پایش تغییرات جهت اجرای مجدد آن‌ها

این دستور از ابزار `watchexec` برای پایش تغییرات فایل‌ها و اجرای مجدد تسک(های) مشخص‌شده استفاده می‌کند.
برای کارکرد این دستور، این ابزار باید نصب باشد، اما می‌توانید آن را با `mise use \-g watchexec@latest` نصب کنید.

برای مدیریت پیشرفته‌تر فرآیندها (مدیریت دیمن، راه‌اندازی مجدد خودکار، بررسی‌های آماده‌به‌کاری،
زمان‌بندی cron)، پروژه خواهر mise را ببینید: https://pitchfork.jdx.dev
.PP
\fBکاربرد:\fR mise watch [OPTIONS] [<TASK>] [<ARGS>] ...
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-t, \-\-task\-flag\fR \fI<TASK_FLAG>\fR
تسک‌ها برای اجرا
.TP
\fB\-g, \-\-glob\fR \fI<GLOB>\fR
فایل‌ها برای پایش
به‌طور پیش‌فرض منابع حاصل از تسک(ها) در نظر گرفته می‌شود
.TP
\fB\-\-skip\-deps\fR
اجرای تنها تسک‌های مشخص‌شده با صرف‌نظر از تمام وابستگی‌ها
.TP
\fB\-w, \-\-watch\fR \fI<PATH>\fR
پایش یک فایل یا دایرکتوری خاص

به‌طور پیش‌فرض، Watchexec دایرکتوری جاری را پایش می‌کند.

هنگام پایش یک تک‌فایل، اغلب بهتر است به جای آن دایرکتوری حاوی آن را پایش کرده و بر اساس نام فایل فیلتر بگذارید. برخی ویرایشگرها ممکن است هنگام ذخیره‌سازی، فایل را با یک فایل جدید جایگزین کنند و برخی پلتفرم‌ها ممکن است این موضوع یا تغییرات بعدی را تشخیص ندهند.

هنگام شروع، Watchexec یک «مبدأ پروژه» (project origin) را از مسیرهای تحت پایش استخراج می‌کند. برای اطلاعات بیشتر، راهنمای \(aq\-\-project\-origin\(aq را ببینید.

این گزینه را می‌توان چندین بار برای پایش چندین فایل یا دایرکتوری مشخص کرد.

مقدار ویژه \(aq/dev/null\(aq، اگر به عنوان تنها مسیر پایش ارائه شود، باعث می‌شود Watchexec هیچ مسیری را پایش نکند. سایر منابع رویداد (مانند سیگنال‌ها یا رویدادهای کلید) همچنان قابل استفاده خواهند بود.
.TP
\fB\-W, \-\-watch\-non\-recursive\fR \fI<PATH>\fR
پایش یک دایرکتوری خاص، به‌صورت غیربازگشتی

برخلاف \(aq\-w\(aq، پوشه‌های پایش‌شده با این گزینه به‌صورت بازگشتی پیمایش نمی‌شوند.

این گزینه را می‌توان چندین بار برای پایش چندین دایرکتوری به‌صورت غیربازگشتی مشخص کرد.
.TP
\fB\-F, \-\-watch\-file\fR \fI<PATH>\fR
پایش فایل‌ها و دایرکتوری‌ها بر اساس یک فایل

هر خط از فایل به‌گونه‌ای تفسیر می‌شود که گویی به \(aq\-w\(aq داده شده است.

برای کاربردهای پیچیده‌تر (مانند پایش غیربازگشتی)، از قابلیت argfile استفاده کنید: فایلی حاوی گزینه‌های خط فرمان بسازید و آن را با `@path/to/argfile` به watchexec پاس دهید.

مقدار ویژه \(aq\-\(aq ورودی را از STDIN می‌خواند؛ این مقدار با \(aq\-\-stdin\-quit\(aq ناسازگار است.
.TP
\fB\-c, \-\-clear\fR \fI<MODE>\fR
پاک کردن صفحه پیش از اجرای دستور

اگر این گزینه صفحه را به‌طور کامل پاک نکرد، \(aq\-\-clear=reset\(aq را امتحان کنید.
.TP
\fB\-o, \-\-on\-busy\-update\fR \fI<MODE>\fR
اقدام لازم هنگام دریافت رویدادها در حین اجرای دستور

حالت پیش‌فرض \(aqdo\-nothing\(aq است که رویدادها را در حین اجرای دستور نادیده می‌گیرد تا تغییراتی که به واسطه اجرای دستور رخ می‌دهند (مانند خروجی‌های کامپایل) نادیده گرفته شوند. همچنین می‌توانید از \(aqqueue\(aq استفاده کنید که در صورت وقوع رویداد در حین اجرا، پس از اتمام اجرای فعلی، دستور را دوباره اجرا می‌کند، یا \(aqrestart\(aq که دستور در حال اجرا را خاتمه داده و دستور جدیدی را آغاز می‌کند. در نهایت، حالت \(aqsignal\(aq وجود دارد که تنها یک سیگنال ارسال می‌کند؛ این حالت برای برنامه‌هایی که می‌توانند پیکربندی خود را بدون شروع مجدد کامل بارگذاری کنند، مفید است.

سیگنال را می‌توان با گزینه \(aq\-\-signal\(aq مشخص کرد.
.RS
\fIپیش‌فرض: \fRdo\-nothing
.RE
.TP
\fB\-r, \-\-restart\fR
شروع مجدد فرآیند در صورتی که همچنان در حال اجرا باشد

این گزینه یک میان‌بر برای \(aq\-\-on\-busy\-update=restart\(aq است.
.TP
\fB\-s, \-\-signal\fR \fI<SIGNAL>\fR
ارسال یک سیگنال به فرآیند زمانی که همچنان در حال اجرا است

سیگنالی را برای ارسال به فرآیند در زمانی که هنوز در حال اجراست مشخص کنید. این گزینه مستلزم \(aq\-\-on\-busy\-update=signal\(aq است؛ در غیر این صورت، سیگنال مورد استفاده در زمانی که آن حالت \(aqrestart\(aq باشد توسط \(aq\-\-stop\-signal\(aq کنترل می‌شود.

برای نحو به مستندات تفصیلی \(aq\-\-stop\-signal\(aq مراجعه کنید.

سیگنال‌ها در حال حاضر در Windows پشتیبانی نمی‌شوند و همیشه به \(aqkill\(aq جایگزین خواهند شد. برای اطلاعات بیشتر در مورد "سیگنال‌های" ویندوز به \(aq\-\-stop\-signal\(aq مراجعه کنید.
.TP
\fB\-\-stop\-signal\fR \fI<SIGNAL>\fR
سیگنال ارسالی برای متوقف کردن دستور

این مورد توسط حالت‌های \(aqrestart\(aq و \(aqsignal\(aq از \(aq\-\-on\-busy\-update\(aq استفاده می‌شود (مگر اینکه \(aq\-\-signal\(aq مشخص شده باشد). رفتار restart ارسال سیگنال، منتظر ماندن برای خروج دستور، و اگر پس از گذشت مدتی (به \(aq\-\-timeout\-stop\(aq مراجعه کنید) خارج نشد، خاتمه دادن اجباری آن است.

پیش‌فرض در یونیکس "SIGTERM" است.

ورودی به عنوان نام کامل سیگنال (مانند "SIGTERM")، نام کوتاه سیگنال (مانند "TERM") یا شماره سیگنال (مانند "15") تجزیه می‌شود. تمامی ورودی‌ها نسبت به کوچکی و بزرگی حروف حساس نیستند.

در Windows این گزینه از نظر فنی پشتیبانی می‌شود اما فقط از رویداد "KILL" پشتیبانی می‌کند، زیرا Watchexec هنوز نمی‌تواند رویدادهای دیگر را تحویل دهد. ویندوز به خودی خود سیگنال ندارد؛ در عوض دارای سازوکار خاتمه (که در اینجا "KILL" یا "STOP" نامیده می‌شود) و رویدادهای "CTRL+C"، "CTRL+BREAK" و "CTRL+CLOSE" است. جهت سازگاری، سیگنال‌های یونیکس "SIGKILL"، "SIGINT"، "SIGTERM" و "SIGHUP" به ترتیب به این موارد نگاشت می‌شوند.
.TP
\fB\-\-stop\-timeout\fR \fI<TIMEOUT>\fR
مدت‌زمان انتظار برای خروج مسالمت‌آمیز دستور

این مورد توسط حالت \(aqrestart\(aq از \(aq\-\-on\-busy\-update\(aq استفاده می‌شود. پس از ارسال سیگنال توقف مسالمت‌آمیز، Watchexec منتظر خروج دستور می‌ماند. اگر پس از این زمان خارج نشود، با اجبار خاتمه می‌یابد.

مقداری بدون واحد بر حسب ثانیه، یا یک بازه زمانی مانند "5min 20s" می‌گیرد. ارائه مقدار بدون واحد منسوخ شده و اخطار خواهد داد؛ در آینده این عمل منجر به خطا خواهد شد.

پیش‌فرض ۱۰ ثانیه است. برای کشتن اجباری و فوری دستور، آن را روی 0 تنظیم کنید.

این گزینه تأثیر عملی در Windows ندارد زیرا دستور همیشه با اجبار خاتمه می‌یابد؛ برای دلیل آن به \(aq\-\-stop\-signal\(aq مراجعه کنید.
.RS
\fIپیش‌فرض: \fR10s
.RE
.TP
\fB\-\-map\-signal\fR \fI<SIGNAL:SIGNAL>\fR
ترجمه سیگنال‌ها از سیستم‌عامل به سیگنال‌های ارسالی به دستور

یک جفت نام سیگنال را که با دونقطه جدا شده‌اند، دریافت می‌کند، مانند "TERM:INT" برای نگاشت SIGTERM به SIGINT. سیگنال اول سیگنالی است که توسط watchexec دریافت می‌شود و سیگنال دوم سیگنالی است که به دستور ارسال می‌شود. سیگنال دوم را می‌توان برای نادیده گرفتن سیگنال اول حذف کرد، مانند "TERM:" برای انجام ندادن هیچ کاری در هنگام دریافت SIGTERM.

اگر SIGINT یا SIGTERM نگاشت شوند، دیگر باعث خروج از Watchexec نمی‌شوند. جدا از دشوار ساختن خروج از خود Watchexec، این ویژگی برای انتقال یک Ctrl\-C به دستور بدون متوقف کردن هم‌زمان Watchexec و برنامه زیرین آن مفید است، برای مثال با "INT:INT".

این گزینه را می‌توان چندین بار برای نگاشت چندین سیگنال مشخص کرد.

نحو سیگنال برای نام‌های کوتاه (مانند "TERM" و "USR2") و نام‌های کامل (مانند "SIGKILL" و "SIGHUP") به کوچکی و بزرگی حروف حساس نیست. شماره‌های سیگنال نیز پشتیبانی می‌شوند (مانند "15" و "31"). در Windows، حالت‌های "STOP"، "CTRL+C" و "CTRL+BREAK" نیز برای دریافت پشتیبانی می‌شوند، اما Watchexec هنوز نمی‌تواند سیگنال‌هایی غیر از STOP را تحویل دهد.
.TP
\fB\-d, \-\-debounce\fR \fI<TIMEOUT>\fR
زمان انتظار برای رویدادهای جدید پیش از اقدام

هنگامی که رویدادی دریافت می‌شود، Watchexec حداکثر تا این مدت زمان پیش از رسیدگی به آن (مانند اجرای دستور) منتظر می‌ماند. این کار ضروری است زیرا آنچه ممکن است به عنوان یک تغییر واحد در نظر بگیرید ممکن است در عمل رویدادهای زیادی منتشر کند، و بدون این رفتار، Watchexec بیش از حد اجرا خواهد شد. علاوه بر این، غیرمعمول نیست که نوشتن در فایل‌ها اتمیک نباشد و هر عمل نوشتن ممکن است رویدادی ارسال کند، بنابراین این روش مناسبی برای جلوگیری از اجرای دستور در حین نوشتن ناقص فایل است.

کاربرد دیگر این است که مقدار بالایی تنظیم کنید (مانند "30min" یا طولانی‌تر)، تا در مصرف انرژی یا پهنای باند برای تسک‌های سنگین، مانند یک اسکریپت پشتیبان‌گیری موردی، صرفه‌جویی شود. در این موارد کاربرد، توجه داشته باشید که تمام رویدادهای انباشته‌شده در حافظه جمع می‌شوند.

مقداری بدون واحد بر حسب میلی‌ثانیه یا یک مقدار بازه زمانی مانند "5sec 20ms" می‌گیرد. ارائه مقدار بدون واحد منسوخ شده و هشدار می‌دهد؛ در آینده این عمل خطا محسوب خواهد شد.

پیش‌فرض ۵۰ میلی‌ثانیه است. تنظیم روی 0 به شدت نهی می‌شود.
.RS
\fIپیش‌فرض: \fR50ms
.RE
.TP
\fB\-\-stdin\-quit\fR
خروج هنگام بسته شدن stdin

این گزینه توصیف‌گر فایل stdin را برای EOF پایش می‌کند و هنگام بسته شدن آن، با متانت از Watchexec خارج می‌شود. این قابلیت توسط برخی از مدیران فرآیند برای جلوگیری از باقی ماندن فرآیندهای زامبی استفاده می‌شود.
.TP
\fB\-\-no\-vcs\-ignore\fR
بارگذاری نکردن فایل‌های gitignore

همچنین سایر فایل‌های نادیده‌گیری VCS، مانند Mercurial، Subversion، Bazaar، DARCS و Fossil. توجه داشته باشید که Watchexec تشخیص می‌دهد کدام یک از این موارد در حال استفاده است (در صورت وجود) و تنها فایل‌های مرتبط را بارگذاری می‌کند. هر دو نوع فایل‌های سراسری (مانند \(aq~/.gitignore\(aq) و محلی (مانند \(aq.gitignore\(aq) در نظر گرفته می‌شوند.

این گزینه زمانی مفید است که می‌خواهید فایل‌هایی را پایش کنید که توسط Git نادیده گرفته شده‌اند.
.TP
\fB\-\-no\-project\-ignore\fR
بارگذاری نکردن موارد نادیده‌گیری محلی پروژه

این گزینه بارگذاری فایل‌های ignore محلی پروژه، مانند \(aq.gitignore\(aq یا \(aq.ignore\(aq در پروژه تحت پایش را غیرفعال می‌کند. این ویژگی با \(aq\-\-no\-vcs\-ignore\(aq که بارگذاری فایل‌های نادیده‌گیری Git و سایر سامانه کنترل نسخه (VCS) را غیرفعال می‌سازد، و با \(aq\-\-no\-global\-ignore\(aq که بارگذاری فایل‌های نادیده‌گیری سراسری یا کاربری مانند \(aq~/.gitignore\(aq یا \(aq~/.config/watchexec/ignore\(aq را غیرفعال می‌کند، متفاوت است.

فایل‌های ignore پروژه پشتیبانی‌شده:

  \- Git: .gitignore در ریشه پروژه و دایرکتوری‌های فرزند، .git/info/exclude، و فایلی که `core.excludesFile` در .git/config به آن اشاره می‌کند.
  \- Mercurial: .hgignore در ریشه پروژه و دایرکتوری‌های فرزند.
  \- Bazaar: .bzrignore در ریشه پروژه.
  \- Darcs: _darcs/prefs/boring
  \- Fossil: .fossil\-settings/ignore\-glob
  \- Ripgrep/Watchexec/generic: .ignore در ریشه پروژه و دایرکتوری‌های فرزند.

فایل‌های نادیده‌گیری VCS (شامل Git، Mercurial، Bazaar، Darcs و Fossil) تنها در صورتی استفاده می‌شوند که مشخص شود VCS مربوطه برای پروژه/مبدأ استفاده شده است. برای مثال، یک .bzrignore در یک مخزن Git کنار گذاشته خواهد شد..TP
\fB\-\-no\-global\-ignore\fR
عدم بارگذاری نادیده‌گرفته‌های سراسری

این گزینه بارگذاری فایل‌های نادیده‌گیری (ignore) سراسری یا کاربری مانند '~/.gitignore'،
\&'~/.config/watchexec/ignore' یا '%APPDATA%\\Bazaar\\2.0\\ignore' را غیرفعال می‌کند. مقایسه کنید با
\&'\-\-no\-vcs\-ignore' و '\-\-no\-project\-ignore'.

فایل‌های نادیده‌گیری سراسری پشتیبانی‌شده:

  \- Git (در صورت تنظیم core.excludesFile): فایل در آن مسیر
  \- Git (در غیر این صورت): نخستین مورد یافت‌شده از $XDG_CONFIG_HOME/git/ignore، %APPDATA%/.gitignore، %USERPROFILE%/.gitignore، $HOME/.config/git/ignore، $HOME/.gitignore.
  \- Bazaar: نخستین مورد یافت‌شده از %APPDATA%/Bazaar/2.0/ignore، $HOME/.bazaar/ignore.
  \- Watchexec: نخستین مورد یافت‌شده از $XDG_CONFIG_HOME/watchexec/ignore، %APPDATA%/watchexec/ignore، %USERPROFILE%/.watchexec/ignore، $HOME/.watchexec/ignore.

همانند فایل‌های پروژه، فایل‌های سراسری Git و Bazaar تنها برای VCS متناظر که در پروژه استفاده شده به کار خواهند رفت.
.TP
\fB\-\-no\-default\-ignore\fR
عدم استفاده از نادیده‌گرفته‌های پیش‌فرض داخلی

ابزار Watchexec مجموعه‌ای از الگوهای نادیده‌گیری پیش‌فرض دارد، مانند فایل‌های swap ویرایشگر، `*.pyc`، `*.pyo`، `.DS_Store`، `.bzr`، `_darcs`، `.fossil\-settings`، `.git`، `.hg`، `.pijul`، `.svn` و فایل‌های گزارش (log) ابزار Watchexec.
.TP
\fB\-\-no\-discover\-ignore\fR
عدم پویش و شناسایی فایل‌های نادیده‌گیری

این گزینه کوته‌نوشتی برای '\-\-no\-global\-ignore'، '\-\-no\-vcs\-ignore' و '\-\-no\-project\-ignore' است، اما حتی کارآمدتر است زیرا از همان ابتدا تمام سازوکارهای کشف نادیده‌گیری را نادیده می‌گیرد.

توجه داشته باشید که نادیده‌گرفته‌های پیش‌فرض همچنان بارگذاری می‌شوند؛ به '\-\-no\-default\-ignore' مراجعه کنید.
.TP
\fB\-\-ignore\-nothing\fR
هیچ چیز نادیده گرفته نشود

این گزینه کوته‌نوشتی برای '\-\-no\-discover\-ignore' و '\-\-no\-default\-ignore' است.

توجه داشته باشید که نادیده‌گرفته‌هایی که صراحتاً از طریق سایر گزینه‌های خط فرمان بارگذاری شده‌اند، مانند '\-\-ignore' یا '\-\-ignore\-file'، همچنان استفاده خواهند شد.
.TP
\fB\-p, \-\-postpone\fR
انتظار تا نخستین تغییر پیش از اجرای دستور

به طور پیش‌فرض، Watchexec دستور را یک بار بلافاصله اجرا می‌کند. با این گزینه، به جای آن، پیش از اجرای عادی دستور تا زمان تشخیص یک رویداد منتظر می‌ماند.
.TP
\fB\-\-delay\-run\fR \fI<DURATION>\fR
درنگ پیش از اجرای دستور

این گزینه باعث می‌شود Watchexec پس از تشخیص یک رویداد، پیش از اجرای دستور به مدت‌زمان مشخص‌شده به خواب (sleep) برود. این کار شبیه به استفاده از "sleep 5 && command" در یک شل است، اما سازگارتر و کمی کارآمدتر می‌باشد.

مقداری بدون یکا بر حسب ثانیه، یا مقداری در قالب بازه زمانی مانند "2min 5s" را می‌پذیرد. ارائه مقدار بدون یکا منسوخ شده است و هشدار در پی خواهد داشت؛ در آینده این عمل منجر به خطا خواهد شد.
.TP
\fB\-\-poll\fR \fI<INTERVAL>\fR
سرکشی دوره‌ای (poll) برای تغییرات سیستم‌فایل

به طور پیش‌فرض و در صورت در دسترس بودن، Watchexec از قابلیت‌های بومی سیستم‌عامل برای پایش سیستم‌فایل استفاده می‌کند. این گزینه آن قابلیت را غیرفعال کرده و به جای آن از سازوکار سرکشی (polling) استفاده می‌کند که کارایی کمتری دارد، اما می‌تواند مشکلات ناشی از برخی سیستم‌های فایل (مانند اشتراک‌های شبکه) یا موارد خاص را برطرف کند.

به صورت اختیاری مقداری بدون یکا بر حسب میلی‌ثانیه یا مقداری در قالب بازه زمانی مانند "2s 500ms" را به عنوان بازه زمانی سرکشی دریافت می‌کند. در صورت عدم تعیین، مقدار پیش‌فرض ۳۰ ثانیه است. ارائه مقدار بدون یکا منسوخ شده و هشدار در پی دارد؛ در آینده این کار منجر به خطا خواهد شد.

با نام مستعار '\-\-force\-poll'.
.TP
\fB\-\-shell\fR \fI<SHELL>\fR
استفاده از یک شل متفاوت

به طور پیش‌فرض، Watchexec در صورت تعریف بودن از '$SHELL' یا مقدار پیش‌فرض 'sh' در سیستم‌های شبه‌یونیکس استفاده می‌کند؛ و در ویندوز بسته به اینکه Watchexec چه شلی را به عنوان شل در حال اجرا تشخیص دهد، از 'pwsh'، 'powershell' یا 'cmd' (CMD.EXE) استفاده خواهد کرد.

با این گزینه می‌توانید آن را لغو کرده و از شل متفاوتی استفاده کنید؛ برای مثال شلی با قابلیت‌های بیشتر یا شلی که نام‌های مستعار (aliasها) و توابع سفارشی شما را دارد.

اگر مقدار دارای فاصله باشد، به عنوان یک خط فرمان تجزیه شده و کلمه اول به عنوان برنامه شل و باقی کلمات به عنوان آرگومان‌های ارسالی به شل استفاده می‌شوند.

دستور با پرچم '\-c' اجرا می‌شود (به جز 'cmd' در ویندوز که در آن از '/C' استفاده می‌شود).

مقدار ویژه 'none' می‌تواند برای غیرفعال کردن کامل استفاده از شل به کار رود. در این حالت، دستور ارائه‌شده به Watchexec تجزیه شده که در آن کلمه اول فایل اجرایی و مابقی آرگومان‌ها خواهند بود، و مستقیماً اجرا می‌شود. توجه داشته باشید که این تجزیه ابتدایی است و ممکن است در همه موارد آن‌طور که انتظار می‌رود عمل نکند.

استفاده از 'none' کمی کارآمدتر است و امکان تفسیر دقیق‌تر ورودی را فراهم می‌سازد، اما همچنین به این معنی است که نمی‌توانید از قابلیت‌های شل مانند انطباق الگو (globbing)، تغییر مسیر (redirection)، کنترل جریان (control flow)، منطق یا لوله‌ها (pipes) بهره ببرید.

مثال‌ها:

استفاده بدون شل:

  $ watchexec \-n \-\- zsh \-x \-o shwordsplit scr

استفاده با powershell core:

  $ watchexec \-\-shell=pwsh \-\- Test\-Connection localhost

استفاده با CMD.exe:

  $ watchexec \-\-shell=cmd \-\- dir

استفاده با یک شل یونیکس متفاوت:

  $ watchexec \-\-shell=bash \-\- 'echo $BASH_VERSION'

استفاده با یک شل یونیکس به همراه گزینه‌ها:

  $ watchexec \-\-shell='zsh \-x \-o shwordsplit' \-\- scr
.TP
\fB\-n\fR
کوته‌نوشتی برای '\-\-shell=none'
.TP
\fB\-\-emit\-events\-to\fR \fI<MODE>\fR
پیکربندی ارسال رویدادها

ابزار Watchexec هنگام اجرای یک دستور می‌تواند اطلاعات رویداد را ارسال کند که توسط فرایند فرزند برای هدف قرار دادن فایل‌های تغییریافتهٔ خاص قابل استفاده است.

نکته‌ای که باید به آن توجه داشت این است که نباید رفتاری تصادفی را رفتاری ذاتی و قطعی فرض کرد.
به‌ویژه ممکن است به نظر برسد متغیر `RENAMED` هم مسیر اصلی و هم مسیر جدید تغییر‌نام‌یافته را در خود دارد. در نسخه‌های پیشین، حتی در برخی پلتفرم‌ها این‌طور به نظر می‌رسید که مسیر اصلی همیشه پیش از مسیر جدید می‌آید. با این وجود، هیچ‌یک از این‌ها حقیقت نداشت. تشخیص قابل اطمینان و سازگار با پلتفرم‌های مختلف در مورد اینکه کدام مسیر تغییریافته قدیمی و کدام جدید است غیرممکن است؛ تغییر نام‌های «ناقص» ممکن است رخ دهند (فقط اصلی، فقط جدید)، تغییر نام‌های «ناشناخته» ممکن است ظاهر شوند (تغییر از نوع تغییر نام بوده، اما اینکه قدیمی بوده یا جدید مشخص نیست)، رویدادهای تغییر نام ممکن است در دو مرز حذف لرزش (debouncing) تفکیک شوند، و مواردی از این دست.

این گزینه مشخص می‌کند که این اطلاعات به کجا ارسال شود. مقدار پیش‌فرض آن 'none' است که هیچ اطلاعات رویدادی ارسال نمی‌کند. سایر گزینه‌ها عبارتند از 'environment' (منسوخ‌شده)، 'stdio'،
\&'file'، 'json\-stdio' و 'json\-file'.

حالت‌های 'stdio' و 'file' متنی هستند: حالت 'stdio' مسیرهای مطلق را در stdin دستور می‌نویسد (یک مسیر در هر خط)، که به هر یک پیشوند `create:`، `remove:`، `rename:`، `modify:` یا `other:` اضافه شده است، و سپس دستگیره (handle) را می‌بندد؛ حالت 'file' همین موارد را درون یک فایل موقت می‌نویسد و مسیر آن از طریق متغیر محیطی $WATCHEXEC_EVENTS_FILE ارائه می‌شود.

همچنین دو حالت JSON وجود دارد که مبتنی بر اشیاء JSON بوده و می‌توانند مجموعه کاملی از رویدادهایی را که Watchexec مدیریت می‌کند نمایش دهند. در اینجا نمونه‌ای از ایجاد یک پوشه در لینوکس آورده شده است:

```json
  {
    "tags": [
      {
        "kind": "path",
        "absolute": "/home/user/your/new\-folder",
        "filetype": "dir"
      },
      {
        "kind": "fs",
        "simple": "create",
        "full": "Create(Folder)"
      },
      {
        "kind": "source",
        "source": "filesystem",
      }
    ],
    "metadata": {
      "notify\-backend": "inotify"
    }
  }
```

فیلدها به شرح زیر هستند:

  \- `tags`، داده‌های ساختاریافته رویداد.
  \- `tags[].kind`، که می‌تواند یکی از موارد زیر باشد:
    * 'path'، به همراه:
      + `absolute`، یک مسیر مطلق.
      + `filetype`، نوع فایل در صورت مشخص بودن ('dir'، 'file'، 'symlink'، 'other').
    * 'fs':
      + `simple`، نوع رویداد «ساده» ('access'، 'create'، 'modify'، 'remove' یا 'other').
      + `full`، نوع رویداد «کامل» که توصیف جامع آن در اینجا بسیار پیچیده است، اما ساختاری شبیه به 'General(Precise(Specific))' دارد.
    * 'source'، به همراه:
      + `source`، منبع رویداد ('filesystem'، 'keyboard'، 'mouse'، 'os'، 'time'، 'internal').
    * 'keyboard'، به همراه:
      + `keycode`. در حال حاضر تنها مقدار 'eof' پشتیبانی می‌شود.
    * 'process'، برای رویدادهای ایجادشده توسط فرایندها:
      + `pid`، شناسه فرایند (PID).
    * 'signal'، برای سیگنال‌های ارسال‌شده به Watchexec:
      + `signal`، نام استاندارد سیگنال ('hangup'، 'interrupt'، 'quit'، 'terminate'، 'user1'، 'user2').
    * 'completion'، برای زمان پایان یک دستور:
      + `disposition`، وضعیت خاتمه ('success'، 'error'، 'signal'، 'stop'، 'exception'، 'continued').
      + `code`، کد خروج، سیگنال، توقف یا استثنا.
  \- `metadata`، اطلاعات تکمیلی در مورد رویداد.

حالت 'json\-stdio' رویدادهای JSON را در ورودی استاندارد (stdin) دستور می‌نویسد (یک رویداد در هر خط) و سپس stdin را می‌بندد. حالت 'json\-file' یک فایل موقت ایجاد می‌کند، رویدادها را در آن می‌نویسد و مسیر فایل را با متغیر محیطی $WATCHEXEC_EVENTS_FILE ارائه می‌دهد.

در نهایت، حالت 'environment' تا نگارش 2.0 پیش‌فرض بود. این حالت متغیرهای محیطی را برای رویدادهای سیستم‌فایل، با مسیرهای فایل‌های متأثر مقداردهی می‌کند:

متغیر $WATCHEXEC_COMMON_PATH با طولانی‌ترین مسیر مشترک تمام متغیرهای زیر مقداردهی می‌شود، و بنابراین برای به دست آوردن مسیر کامل/واقعی باید به ابتدای هر مسیر الحاق شود. سپس:

  \- $WATCHEXEC_CREATED_PATH هنگام ایجاد فایل‌ها/پوشه‌ها تنظیم می‌شود
  \- $WATCHEXEC_REMOVED_PATH هنگام حذف فایل‌ها/پوشه‌ها تنظیم می‌شود
  \- $WATCHEXEC_RENAMED_PATH هنگام تغییر نام فایل‌ها/پوشه‌ها تنظیم می‌شود
  \- $WATCHEXEC_WRITTEN_PATH هنگام ویرایش فایل‌ها/پوشه‌ها تنظیم می‌شود
  \- $WATCHEXEC_META_CHANGED_PATH هنگام تغییر متاداده فایل‌ها/پوشه‌ها تنظیم می‌شود
  \- $WATCHEXEC_OTHERWISE_CHANGED_PATH برای هر نوع رویداد مسیردار دیگر تنظیم می‌شود

مسیرهای چندگانه با نویسه جداکننده مسیر سیستم جدا می‌شوند؛ ';' در ویندوز و ':' در یونیکس.
در هر متغیر، مسیرها یکتا شده (حذف موارد تکراری) و به ترتیب باینری مرتب می‌شوند (یعنی بدون توجه به یونیکد یا محلی‌سازی/locale).

این یک حالت موروثی (legacy) است، منسوخ شده و در آینده حذف خواهد شد. محیط (environment) فضایی بسیار محدود است و در آنچه می‌تواند به طور مفید نمایش دهد نیز محدودیت دارد. تعداد بالای فایل‌ها یا باعث بریده شدن متغیرهای محیطی می‌شود یا ممکن است منجر به خطا یا توقف غیرمنتظره (crash) کامل فرایند گردد. همچنین متغیر $WATCHEXEC_COMMON_PATH گیج‌کننده و غیربدیهی است، همان‌طور که پرسش‌های سردرگم بی‌شماری که طی سال‌ها به صندوق ورودی من ارسال شده این را نشان می‌دهد.
.RS
\fIپیش‌فرض: \fRnone
.RE.TP
\fB\-\-only\-emit\-events\fR
تنها رویدادها را به stdout ارسال می‌کند، هیچ دستوری را اجرا نمی‌کند.

این یک گزینهٔ کارآمد برای استفاده از Watchexec به‌عنوان یک پایشگر فایل، بدون اجرای هیچ دستوری است. این گزینه تقریباً معادل استفاده از دستور `cat` است، با این تفاوت که برای هر رویداد یک فرایند جدید ایجاد نمی‌کند.

این گزینه نیازمند تنظیم بودن `\-\-emit\-events\-to` است و حالت‌های دردسترس را به `stdio` و `json\-stdio` محدود می‌کند، و رفتار آن‌ها را به نوشتن در stdout به‌جای stdin دستور تغییر می‌دهد.
.TP
\fB\-E, \-\-env\fR \fI<KEY=VALUE>\fR
افزودن متغیرهای محیطی به دستور

این یک گزینهٔ کارآمد برای تنظیم متغیرهای محیطی برای دستور، بدون تنظیم آن‌ها برای خود فرایند Watchexec است.

از نحو key=value استفاده کنید. متغیرهای متعدد را می‌توان با تکرار این گزینه تنظیم کرد.
.TP
\fB\-\-wrap\-process\fR \fI<MODE>\fR
پیکربندی نحوهٔ دربرگیری (wrap) فرایند

به‌طور پیش‌فرض، Watchexec دستور را در macOS درون یک نشست (session)، در سایر پلتفرم‌های Unix درون یک گروه فرایندی (process group) و در Windows در یک Job Object اجرا می‌کند.

برخی از برنامه‌های Unix ترجیح می‌دهند در یک نشست اجرا شوند، در حالی که برخی دیگر در یک گروه فرایندی کار نمی‌کنند.

از 'group' برای استفاده از یک گروه فرایندی، 'session' برای استفاده از یک نشست فرایندی، و 'none' برای اجرای مستقیم دستور استفاده کنید. در Windows، هر یک از 'group' یا 'session' از یک Job Object استفاده خواهد کرد.
.TP
\fB\-N, \-\-notify\fR
هشدار هنگام آغاز و پایان دستورها

با این گزینه، Watchexec هنگام آغاز و پایان یک دستور، روی پلتفرم‌های پشتیبانی‌شده یک اعلان دسکتاپ ارسال می‌کند. در پلتفرم‌های پشتیبانی‌نشده، ممکن است بدون هیچ پیامی کاری انجام ندهد یا یک هشدار ثبت کند.
.TP
\fB\-\-color\fR \fI<MODE>\fR
زمان استفاده از رنگ‌های پایانه

تنظیم متغیر محیطی `NO_COLOR` به هر مقداری معادل `\-\-color=never` است.
.RS
\fIپیش‌فرض: \fRauto
.RE
.TP
\fB\-\-timings\fR
چاپ مدت زمان اجرای دستور

این مقدار ممکن است کاملاً دقیق نباشد، زیرا شامل مقداری سربار از جانب خود Watchexec است. برای نتایج دقیق‌تر از ابزار `time`، زمان‌سنج‌های با دقت بالا یا ابزارهای محک‌زنی (benchmarking) استفاده کنید.
.TP
\fB\-q, \-\-quiet\fR
عدم چاپ پیام‌های آغاز و توقف

به‌طور پیش‌فرض Watchexec هنگام آغاز و توقف دستور پیامی را چاپ می‌کند. این گزینه این رفتار را غیرفعال می‌کند، بنابراین تنها خروجی، هشدارها و خطاهای خود دستور چاپ خواهند شد.
.TP
\fB\-\-bell\fR
به صدا درآوردن زنگ پایانه پس از تکمیل دستور
.TP
\fB\-\-project\-origin\fR \fI<DIRECTORY>\fR
تنظیم مبدأ پروژه (project origin)

برنامهٔ Watchexec تلاش خواهد کرد «مبدأ» (یا «ریشهٔ») پروژه را با جستجوی نشانه‌های گوناگون مانند فایل‌ها یا الگوهای دایرکتوری پیدا کند. تمام تلاشش را می‌کند اما گاهی اشتباه تشخیص می‌دهد، و شما می‌توانید با این گزینه آن را لغو و بازنویسی کنید.

مبدأ پروژه برای تعیین مسیر برخی فایل‌های نادیده‌گیری (ignore files)، اینکه کدام VCS در حال استفاده است، مفهوم '/' ابتدایی در الگوهای فیلتر کردن، و احتمالاً موارد بیشتر در آینده استفاده می‌شود.

هنگام تنظیم شدن، Watchexec دیگر وقتی صرف جستجو نخواهد کرد، که می‌تواند به‌طور چشمگیری سریع‌تر باشد.
.TP
\fB\-\-workdir\fR \fI<DIRECTORY>\fR
تنظیم دایرکتوری کاری

به‌طور پیش‌فرض، دایرکتوری کاری دستور همان دایرکتوری کاری Watchexec است. می‌توانید با این گزینه آن را تغییر دهید. توجه داشته باشید که استفاده از مسیرها با این گزینه ممکن است کمتر شهودی باشد.
.TP
\fB\-e, \-\-exts\fR \fI<EXTENSIONS>\fR
پسوندهای نام فایل برای فیلتر کردن

این یک فیلتر سریع برای ارسال رویدادها تنها برای فایل‌هایی با پسوندهای داده‌شده است. پسوندها می‌توانند با یا بدون نقطهٔ ابتدایی مشخص شوند (مثلاً 'js' یا '.js'). پسوندهای چندگانه را می‌توان با تکرار گزینه یا با جدا کردن آن‌ها با کاما مشخص کرد.
.TP
\fB\-f, \-\-filter\fR \fI<PATTERN>\fR
الگوهای نام فایل برای فیلتر کردن

یک الگوی فیلتر شبیه به glob ارائه دهید، و تنها رویدادهای فایل‌هایی که با الگو مطابقت دارند ارسال خواهند شد. الگوهای چندگانه را می‌توان با تکرار گزینه تعیین کرد. رویدادهایی که مربوط به فایل‌ها نیستند (مانند سیگنال‌ها، رویدادهای صفحه‌کلید) بدون تغییر عبور داده خواهند شد.
.TP
\fB\-\-filter\-file\fR \fI<PATH>\fR
فایل‌ها برای بارگذاری فیلترها از آن‌ها

مسیری به یک فایل حاوی فیلترها، در هر خط یکی، ارائه دهید. خطوط خالی و خطوطی که با '#' آغاز می‌شوند نادیده گرفته می‌شوند. از همان قالب الگوی گزینهٔ '\-\-filter' استفاده می‌کند.

این مورد همچنین می‌تواند از طریق متغیر محیطی $WATCHEXEC_FILTER_FILES استفاده شود.
.RS
\fIمحیط: \fR\fBWATCHEXEC_FILTER_FILES\fR
.RE
.TP
\fB\-J, \-\-filter\-prog\fR \fI<EXPRESSION>\fR
[آزمایشی] برنامه‌های فیلتر.

/!\\ این گزینه آزمایشی است و ممکن است بدون اطلاع قبلی تغییر کند یا حذف شود.

برنامه‌های فیلتر سفارشی خود را با نحو jaq (مشابه jq) ارائه دهید. رویدادها به همان قالبی که در '\-\-emit\-events\-to' شرح داده شده به برنامه‌ها داده می‌شوند و برنامه باید یک مقدار بولی (boolean) برگرداند. برنامه‌های نامعتبر باعث شکست در شروع watchexec می‌شوند؛ از '\-v' برای دیدن خطاهای زمان اجرای برنامه استفاده کنید.

علاوه بر stdlib در jaq، برنامهٔ watchexec چند تعریف فیلتر سفارشی اضافه می‌کند:

  \- مقدار 'path | file_meta' متادیتای فایل را برمی‌گرداند یا در صورت عدم وجود فایل null می‌دهد.

  \- مقدار 'path | file_size' اندازهٔ فایل در مسیر را برمی‌گرداند، یا در صورت عدم وجود فایل null می‌دهد.

  \- مقدار 'path | file_read(bytes)' یک رشته شامل n بایت اول فایل در مسیر را برمی‌گرداند.
    اگر فایل کوچک‌تر از n بایت باشد، کل فایل برگردانده می‌شود. هیچ فیلتری برای
    خواندن کل فایل به‌صورت یکجا وجود ندارد تا محدود کردن حجم داده‌های خوانده‌شده و پردازش‌شده تشویق شود.

  \- مقادیر 'string | hash' و 'path | file_hash' هشِ رشته یا فایل در مسیر را برمی‌گردانند.
    هیچ تضمینی در مورد الگوریتم استفاده‌شده وجود ندارد: با آن به‌عنوان یک مقدار مات (opaque) برخورد کنید.

  \- مقادیر 'any | kv_store(key)'، 'kv_fetch(key)' و 'kv_clear' یک مخزن کلید-مقدار ساده فراهم می‌کنند.
    داده‌ها تنها در حافظه نگه‌داری می‌شوند و هیچ پایداری‌ای وجود ندارد. سازگاری تضمین نمی‌شود.

  \- مقادیر 'any | printout'، 'any | printerr' و 'any | log(level)' هر مقدار داده‌شده را در
    stdout، stderr یا لاگ چاپ یا ثبت می‌کنند (سطوح = error, warn, info, debug, trace)، و
    مقدار را عبور می‌دهند (بنابراین '[1] | log("debug") | .[]' مقدار '1' را تولید کرده و '[1]' را لاگ می‌کند).

تمام فیلترسازی‌های انجام‌شده با چنین برنامه‌هایی، به‌ویژه مواردی که از kv یا دسترسی به فایل‌سیستم استفاده می‌کنند، بسیار کندتر از روش‌های دیگر فیلترسازی است. اگر فیلترسازی بیش از حد کند باشد، رویدادها انباشته شده و باعث توقف watchexec می‌شوند. هنگام طراحی فیلترهای خود دقت کنید.

اگر آرگومان این گزینه با یک '@' شروع شود، بقیهٔ آرگومان به‌عنوان مسیر فایلی شامل یک برنامهٔ jaq در نظر گرفته می‌شود.

برنامه‌های jaq به ترتیب و پس از همهٔ فیلترهای دیگر اجرا می‌شوند و اتصال‌کوتاه (short\-circuit) هستند: اگر یک فیلتر (چه jaq و چه غیر آن) رویدادی را رد کند، اجرا همان‌جا متوقف می‌شود و هیچ فیلتر دیگری اجرا نخواهد شد. علاوه بر این، آن‌ها پس از خروجی دادن اولین مقدار متوقف می‌شوند، بنابراین هنگام پیمایش تمایل خواهید داشت از 'any' یا 'all' استفاده کنید، در غیر این صورت فقط اولین مورد پردازش خواهد شد که می‌تواند بسیار گیج‌کننده باشد!

برنامه‌های ارائه‌شده توسط کاربران را بیابید یا برنامه‌های مفید خود را در <https://github.com/watchexec/watchexec/discussions/592> ارسال کنید.

## مثال‌ها:

فیلتر نادیده‌گیری با عبارت منظم (Regexp) روی مسیرها:

  'all(.tags[] | select(.kind == "path"); .absolute | test("[.]test[.]js$")) | not'

عبور دادن هر رویدادی که یک فایل ایجاد می‌کند:

  'any(.tags[] | select(.kind == "fs"); .simple == "create")'

عبور دادن رویدادهایی که فایل‌های اجرایی را لمس می‌کنند:

  'any(.tags[] | select(.kind == "path" && .filetype == "file"); .absolute | metadata | .executable)'

نادیده گرفتن فایل‌هایی که با شه‌بنگ (shebang) آغاز می‌شوند:

  'any(.tags[] | select(.kind == "path" && .filetype == "file"); .absolute | read(2) == "#!") | not'
.TP
\fB\-i, \-\-ignore\fR \fI<PATTERN>\fR
الگوهای نام فایل برای نادیده گرفتن

یک الگوی فیلتر شبیه به glob ارائه دهید، و رویدادهای فایل‌هایی که با الگو مطابقت دارند نادیده گرفته خواهند شد. الگوهای چندگانه را می‌توان با تکرار گزینه مشخص کرد. رویدادهایی که مربوط به فایل‌ها نیستند (مانند سیگنال‌ها، رویدادهای صفحه‌کلید) دست‌نخورده عبور داده خواهند شد.
.TP
\fB\-\-ignore\-file\fR \fI<PATH>\fR
فایل‌ها برای بارگذاری موارد نادیده‌گیری از آن‌ها

مسیری به یک فایل حاوی موارد نادیده‌گیری، در هر خط یکی، ارائه دهید. خطوط خالی و خطوطی که با '#' آغاز می‌شوند نادیده گرفته می‌شوند. از همان قالب الگوی گزینهٔ '\-\-ignore' استفاده می‌کند.

این مورد همچنین می‌تواند از طریق متغیر محیطی $WATCHEXEC_IGNORE_FILES استفاده شود.
.RS
\fIمحیط: \fR\fBWATCHEXEC_IGNORE_FILES\fR
.RE
.TP
\fB\-\-fs\-events\fR \fI<EVENTS>\fR
رویدادهای فایل‌سیستم برای فیلتر کردن

این یک فیلتر سریع برای ارسال رویدادها فقط برای انواع مشخص‌شده‌ای از تغییرات فایل‌سیستم است. از میان 'access'، 'create'، 'remove'، 'rename'، 'modify' و 'metadata' انتخاب کنید. انواع چندگانه را می‌توان با تکرار گزینه یا با جدا کردن آن‌ها با کاما مشخص کرد. به‌طور پیش‌فرض، این شامل همهٔ انواع به‌جز 'access' است.

در صورت امکان، این ممکن است فیلتر کردن را در سطح هسته اعمال کند، که می‌تواند کارآمدتر باشد اما ممکن است هنگام خواندن لاگ‌ها گیج‌کننده‌تر باشد.
.RS
\fIپیش‌فرض: \fRcreate,remove,rename,modify,metadata
.RE
.TP
\fB\-\-no\-meta\fR
عدم ارسال رویدادهای فایل‌سیستم برای تغییرات متادیتا

این یک نام اختصاری برای '\-\-fs\-events create,remove,rename,modify' است. استفاده از آن در کنار گزینهٔ '\-\-fs\-events' بی‌معنی بوده و مجاز نیست.
.TP
\fB\-\-print\-events\fR
چاپ رویدادهایی که کنش‌ها را تحریک می‌کنند

این گزینه رویدادهایی را که هنگام مدیریت، کنش را برانگیخته‌اند (پس از اعمال debounce)، در قالبی خوانا برای انسان چاپ می‌کند. این برای اشکال‌زدایی فیلترها مفید است.

هنگامی که به اطلاعات تشخیصی بیشتری نیاز دارید، به‌جای آن از '\-vvv' استفاده کنید.
.TP
\fB\-\-manual\fR
نمایش صفحهٔ راهنما (manual)

اگر خروجی یک پایانه باشد و برنامهٔ 'man' در دسترس باشد، این گزینه صفحهٔ راهنمای Watchexec را نشان می‌دهد. در غیر این صورت، صفحهٔ راهنما در قالب ROFF در stdout چاپ می‌شود (مناسب برای نوشتن در یک فایل watchexec.1).
.TP
\fB\-h, \-\-help\fR
چاپ راهنما
\fBآرگومان‌ها:\fR.PP
.TP
\fB<TASK>\fR
تسک‌های مورد نظر برای اجرا
می‌توان چندین تسک را با جدا کردن توسط `:::` مشخص کرد
به‌عنوان مثال: `mise run task1 arg1 arg2 ::: task2 arg1 arg2`
پیش‌فرض: `default`
.TP
\fB<ARGS>\fR
تسک و آرگومان‌ها برای اجرا
.SH "MISE WHERE"
نمایش مسیر نصب یک ابزار

برای کارکرد این دستور، ابزار باید نصب شده باشد.
.PP
\fBروش استفاده:\fR mise where [OPTIONS] <TOOL@VERSION> [<ASDF_VERSION>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<TOOL@VERSION>\fR
ابزار(ها) برای جستجو
به‌عنوان مثال: ruby@3
اگر "@<PREFIX>" مشخص شده باشد، آخرین نسخهٔ نصب‌شده که با این پیشوند
مطابقت دارد نمایش داده خواهد شد
در غیر این صورت، نسخهٔ فعال و نصب‌شدهٔ فعلی را نمایش می‌دهد
.TP
\fB<ASDF_VERSION>\fR
پیشوند نسخه برای استفاده در هنگام پرس‌وجوی آخرین نسخه
مشابه با اولین آرگومان پس از "@"
جهت سازگاری با asdf استفاده می‌شود
.SH "MISE WHICH"
مسیری را نشان می‌دهد که فایل اجرایی (bin) ابزار به آن اشاره دارد.

از این دستور برای تشخیص این‌که در حال حاضر کدام نسخه از ابزار فعال است استفاده کنید.
.PP
\fBروش استفاده:\fR mise which [OPTIONS] [<BIN_NAME>]
.PP
\fBگزینه‌ها:\fR
.PP
.TP
\fB\-t, \-\-tool\fR \fI<TOOL@VERSION>\fR
استفاده از یک tool@version مشخص
به‌عنوان مثال: `mise which npm \-\-tool=node@20`
.TP
\fB\-\-complete\fR
.TP
\fB\-\-plugin\fR
نمایش نام پلاگین به‌جای مسیر
.TP
\fB\-\-version\fR
نمایش نسخه به‌جای مسیر
.TP
\fB\-h, \-\-help\fR
نمایش راهنما
\fBآرگومان‌ها:\fR
.PP
.TP
\fB<BIN_NAME>\fR
فایل اجرایی (bin) برای جستجو
.SH "نویسندگان (AUTHORS)"
Jeff Dickey <@jdx>