راهنما
هوش مصنوعی
Omarchy برای عاملهای کدنویسی زیر راهاندازهایی را بدون انتخاب یک پیشفرض برای شما دربر میگیرد. یک دستور را اجرا کنید تا CLI آن در نخستین استفاده نصب شود، سپس وقتی از شما خواسته شد احراز هویت کنید. Hermes استثناست: برای آن در نخستین استفاده چیزی نصب نمیشود، و انتخاب آن Hermes Desktop را نصب میکند، همانطور که برنامههای دسکتاپ در ادامه توضیح میدهد.
| دستور | عامل |
|---|---|
claude |
Claude Code |
codex |
OpenAI Codex |
opencode |
OpenCode |
agy |
Google Antigravity CLI |
amp |
Amp |
commandcode |
Command Code |
copilot |
GitHub Copilot CLI |
crush |
Crush |
cursor-agent |
Cursor CLI |
devin |
Devin CLI از Cognition |
dsh |
DeepSeek Harness |
freebuff |
Freebuff، عامل کدنویسی رایگان و تبلیغاتی Codebuff |
grok |
Grok Build از xAI |
hermes |
Hermes، عامل Nous Research |
kilo |
Kilo، یک عامل کدنویسی مبتنی بر OpenCode |
kimi |
Kimi Code |
kiro-cli |
Kiro CLI |
mcode |
MiniMax Code، عامل کدنویسی MiniMax |
muse |
Muse Code، عامل کدنویسی Meta |
omp |
Oh My Pi |
ori |
Ori، مهار OpenRouter |
pi |
Mario Zechner’s Pi |
qwen |
Qwen Code، عامل کدنویسی Alibaba |
ori مورد عجیب این جمع است: مهارهای دیگر را در برابر کل کاتالوگ مدلهای OpenRouter اجرا میکند، پس ori claude، ori codex یا ori opencode آن عاملها را روی هر مدلی که به آنها نشان دهید آغاز میکنند، و ori code عامل خود Ori است.
نصب و بهروزرسانی عاملها
بهجز Hermes، این عاملها از نصب تنبل mise استفاده میکنند: نخستین اجرا CLI را نصب میکند، و اجراهای بعدی از همان استفاده میکنند. mise همچنین حداکثر هر چهار ساعت یک بار، درست پیش از شروع یا در پسزمینه در اعلان shell، بررسی میکند که آیا نسخه جدیدی برای یک عامل نصبشده منتشر شده است یا نه. اگر آن بهروزرسانی ناموفق باشد یا آفلاین باشید، نسخه نصبشده اجرا میشود. omarchy update عاملهای نصبشده را با بقیه Omarchy بهروز میکند، و mup فقط ابزارهای مدیریتشده با mise را بهروز میکند.
بهروزرسان خود یک عامل، مانند claude update، codex update یا یک دکمه بهروزرسانی در یک برنامه، نصب مدیریتشده با mise را بهروز نمیکند. codex update ناموفق میماند، و claude update میتواند موفقیت را گزارش کند در حالی که یک نسخه جداگانه نصب میکند که mise آن را ردیابی نمیکند. اگر ترجیح میدهید از نصبکننده و بهروزرسان بومی یک عامل استفاده کنید، آن را به disable_tools اضافه کنید؛ به ابزارهای CLI از پیش نصبشده مراجعه کنید.
برای نصب همه ابزارهای تنبل پیکربندیشده پیش از آنکه به آنها نیاز پیدا کنید، mise install --include-lazy را اجرا کنید. این شامل دیگر ابزارهای CLI پیشفرض Omarchy و همچنین عاملها میشود. برای نصب یک ابزار واحد یا استفاده از نصب خودتان، به ابزارهای CLI از پیش نصبشده مراجعه کنید.
grok از طریق بسته first-party grok در mise نصب میشود، به همان شیوه claude و codex. grok را اجرا کنید، یا آن را زیر راهاندازی > پیشفرضها > عامل انتخاب کنید. از نصبکننده curl | bash در x.ai صرفنظر کنید. آن مسیر یک نسخه دوم را در ~/.grok/bin قرار میدهد، آن را در ابتدای PATH میگذارد، و wrapper Omarchy را بازنویسی میکند.
dsh رابط کاربری مرورگر خود را روی 127.0.0.1:3080 باز میکند، با پوشه اجرا بهعنوان فضای کاری پیشفرض آن. رابط کاربری مرورگر آن هیچ پرامپت آغازی نمیپذیرد، پس omarchy agent prompt آن را با پرامپت روی کلیپبورد شما برای چسباندن باز میکند. Omarchy آن را با پیشتنظیم مجوز بدون تأیید DeepSeek آغاز میکند. DeepSeek Harness وقتی از API رسمی مدل آن استفاده میکنید، گزارشهای نشست را به DeepSeek بارگذاری میکند؛ آن را زیر تنظیمات > عمومی > Upload Session Log در رابط کاربری مرورگر آن خاموش کنید. بازخوردی که برای آن میفرستید نیز همراه با نشست بارگذاری میشود، مگر اینکه آن را با DSH_TELEMETRY_MODE=DISABLED آغاز کنید.
عامل پیشفرض
عامل پیشفرض خود را با omarchy default agent <name> یا زیر راهاندازی > پیشفرضها > عامل در منوی Omarchy (Super + Space) انتخاب کنید. اگر عامل هنوز نصب نشده باشد، انتخاب آن ابتدا آن را نصب میکند. یک Omarchy تازه با یک اعلان یکباره از شما دعوت میکند این انتخاب را انجام دهید.
انتخاب Claude همچنین تلاش میکند افزونه مرورگر آن را برای Chromium، Chrome، Brave، Brave Origin و Edge راهاندازی کند. راهاندازی افزونه برای همه کاربران اعمال میشود و ممکن است گذرواژه سیستم شما را بخواهد؛ لغو کردن یا ناموفق بودن نصب افزونه همچنان Claude را انتخاب و اجرا میکند. مرورگر خود را از نو راهاندازی کنید، اگر از شما خواسته شد افزونه را فعال کنید، و برای تکمیل اتصال آن به Claude وارد شوید. برای بررسی اتصال، /chrome را در Claude اجرا کنید. Firefox و Zen این افزونه را پشتیبانی نمیکنند. اگر Claude پیش از افزوده شدن این راهاندازی از قبل پیشفرض شما بود، برای نصب افزونه آن را دوباره انتخاب کنید.
پس از آنکه انتخاب کردید، Super + Shift + Ctrl + A عامل پیشفرض را در یک پنجره ترمینال اختصاصی اجرا میکند (یا اگر هنوز انتخاب نکردهاید، انتخابگر را بالا میآورد). همچنین میتوانید آن را مستقیماً وارد یک کار کنید با omarchy agent prompt "Review this project". Freebuff و DeepSeek Harness هیچ پرامپت آغازی نمیپذیرند، پس در عوض با پرامپت روی کلیپبورد شما برای چسباندن باز میشوند. عاملهایی که اینگونه اجرا میشوند بدون مراقبت در حالتهای مربوطه خودشان که برای پرسیدن متوقف نمیشوند اجرا میشوند، پس آماده باشید که واقعاً دست به کار شوند! MiniMax Code برای نشستهای تعاملی خود چنین حالتی ندارد، پس طبق معمول مجوز میخواهد. و از آنجا که عاملها از به خاطر سپردن اعتماد برای پوشه خانگی شما خودداری میکنند، اجراها از $HOME در عوض در ~/Work آغاز میشوند.
میانبرهای ترمینال هم وجود دارند: a عامل پیشفرض را درون همین ترمینال فعلی اجرا میکند، در حالی که c، cx و cy، OpenCode، Claude Code و Codex را مستقیماً آغاز میکنند (باز هم در حالتهای تأیید خودکار آنها). تغییرهای تم نیز با عاملها همگام میشوند: Claude Code، Pi، OpenCode و Hermes (پس از آنکه Omarchy آن را نصب کرد) همگی وقتی تم Omarchy را عوض میکنید همراهی میکنند.
پنل عاملها
نوار بالایی یک نماد عاملها دارد. پیش از آنکه یک عامل را راهاندازی کرده باشید، پنل آن شما را در ورود به Claude، Codex یا Grok راهنمایی میکند، و نخستین مورد عامل پیشفرض شما میشود. پس از آن، پنل هر اشتراکی را در یک صفحه قرار میدهد: هر عامل و حساب با طرح آن، یک سنجه برای هر یک از محدودیتهای نشست 5 ساعته و هفتگی آن همراه با زمان تا بازنشانی آن (برای درصد دقیق نگه دارید)، یا مانده پیشپرداخت باقیمانده، زیر خطی که در میان آنچه در همه آنها استفاده کردهاید میچرخد، مانند توکنهای این هفته و پرکاربردترین مدل شما. زیر چیزی بساز پرامپتهای آغازینی برای یک تم، افزونه یا برنامه جدید پیشنهاد میکند که کار را به عامل پیشفرض شما میسپارند. برنامهها به شیوهای ساخته میشوند که برنامههای خود Omarchy یعنی Hype، Monologue و Omacut ساخته میشوند، در C++ و Qt Quick، با پیروی از مهار عامل omarchy-app، و کامپایلر و قطعات Qt مورد نیاز آنها بهصورت نصبشده میآیند. Claude Code، Codex، Grok، Kimi، Cursor و سهمیه Grok Bot آن، GitHub Copilot، Muse، Antigravity، Kimchi و Devin از همان ابتدا با محدودیتهایشان پوشش داده میشوند، و Hermes، Mistral Vibe و Qwen Code پس از آنکه از آنها استفاده کردید نشستها و توکنهایشان را نشان میدهند. طرحها و کلیدهای ارائهدهندگانی که از طریق pi، omp یا opencode استفاده میکنید نیز نمایان میشوند: OpenCode Zen و Go، Z.ai GLM Coding Plan، Ollama Cloud، MiniMax Token Plan و Synthetic با محدودیتهایشان؛ Fireworks، OpenRouter و DeepSeek با ماندههای پیشپرداختشان؛ و مدلهایی که روی سختافزار خودتان اجرا میکنید زیر مدلهای محلی. هر عامل یک بار شمرده میشود، زیر هر کسی که صورتحساب آن را صادر میکند، هر چند مهار که آن را از طریقشان برانید.
برای پنل روی نماد نوار چپکلیک کنید، برای اجرای عامل پیشفرضتان راستکلیک کنید. رکوردهای مصرف پشت آن هر 15 دقیقه با omarchy agent usage-update بازسازی میشوند، و پنل حتی میتواند مصرف را از ماشینهای دیگر شما از طریق یک پوشه همگامشده ادغام کند. برای تنظیمات کامل، README زیر $OMARCHY_PATH/shell/plugins/agents/ را ببینید.
چند اشتراک
اگر برای بیش از یک طرح Claude، Codex یا Grok پول میدهید - مثلاً یک Max شخصی و یک کاری - Omarchy میتواند همه آنها را وارد نگه دارد و میان آنها جابهجا شود. یک اشتراک را با + در پنل عاملها اضافه کنید، که شما را همانجا در مراحلش راهنمایی میکند، یا با omarchy agent account add claude Work (یا codex، یا grok). اگر CLI نباشد آن را نصب میکند. نخستین حساب برای یک ارائهدهنده از طریق مرورگر معمولی شما وارد میشود، درست همانجایی که CLI همیشه نگاه میکند. هر مورد پس از آن از طریق یک پنجره خصوصی وارد میشود، تا حسابی که مرورگر شما از قبل وارد آن شده است به اشتباه برداشته نشود؛ آنجا بهعنوان حسابی که اضافه میکنید وارد شوید، و ابتدا هر پنجره خصوصی را که از قبل باز داشتهاید ببندید. هرگز برای این کار از CLI خارج نشوید: خارج شدن ورود ذخیرهشده را باطل میکند، و آن حساب باید دوباره اضافه شود.
برای کپی کردن ورودهای اشتراکتان به یک ماشین Omarchy دیگر روی SSH، omarchy agent account copy user@laptop را اجرا کنید. فرستنده وقتی مقصد یک گیرنده نصبشده ندارد، یک گیرنده موقت تأمین میکند، پس ماشینهای Omarchy قدیمیتر میتوانند بدون بهروزرسانی حسابها را دریافت کنند. گیرندههای نصبشده اولویت دارند. این همه اشتراکهای Claude، Codex و Grok را کپی میکند؛ برای انتخاب آنها نام ارائهدهندگان را اضافه کنید، مانند omarchy agent account copy laptop claude. نام حسابها و شناسههای دستور با مبدأ مطابقت دارند، از جمله حسابهایی که از قبل در مقصد حاضرند. حسابهای نامرتبط مقصد اگر نامهایشان تعارض داشته باشد یک پسوند عددی میگیرند، و تنظیمات، مهارتها، افزونهها و تاریخچه گفتگو برای هر ماشین محلی باقی میمانند.
اعتبارنامههای موجود مقصد نگه داشته میشوند. یک حساب مبدأ که از قبل آنجا وارد شده است نامش بدون جایگزینی اعتبارنامههایش همگام میشود؛ حسابهای دیگر در کنار آن اضافه میشوند. برای جایگزینی اعتبارنامههای ذخیرهشده برای حسابهای منطبق، پس از بستن نشستهای آن حساب در مقصد، از omarchy agent account copy --replace laptop claude استفاده کنید. یک مقصد تازه همچنین حساب فعال و ترجیحات تعویض مبدأ را میگیرد؛ یک مقصد جاافتاده مال خودش را نگه میدارد.
اعتبارنامهها از طریق SSH سفر میکنند و در فایلهای خصوصی در مقصد ذخیره میشوند، پس فقط به ماشینهایی کپی کنید که به آنها اعتماد دارید. این یک کپی یکباره است، نه همگامسازی مداوم. توکنهای تازهسازی Codex میتوانند توسط یک ماشین دیگر چرخانده شوند، و یک ورود کپیشده را نیازمند تمدید میگذارند؛ ورودهای جداگانه همچنان مطمئنترین انتخاب برای استفاده همزمان روی چند ماشین باقی میمانند. به راهنمای احراز هویت حساب Codex مراجعه کنید.
یک حساب به ازای هر ارائهدهنده فعال است، و هر نشست جدید بهعنوان آن آغاز میشود: cx، cy، یک claude، codex یا grok ساده، هر چیزی که از طریق omarchy agent اجرا شود، و اسکریپتها یا ویرایشگرهایی که CLI را روی PATH پیدا میکنند. با omarchy agent account use work تعویض کنید (و با omarchy agent account use main برگردید)، یا در پنل با فشردن شماره یک حساب و سپس Enter (یا کلیک کردن دکمه Use آن). نشستهایی که از قبل در حال اجرا هستند روی حسابی که با آن آغاز شدند باقی میمانند. تاریخچه گفتگو، تنظیمات، مهارتها و افزونهها میان حسابها به اشتراک گذاشته میشوند، پس claude --continue در همان پوشه از همانجایی ادامه میدهد که در حساب جدید رها کرده بودید.
با بیش از یک حساب، پنل محدودیتهای هر حساب را کنار هم نشان میدهد، با حساب فعال علامتگذاریشده. بهطور پیشفرض Omarchy وقتی حساب فعال از 95% یک محدودیت میگذرد به شما اطلاع میدهد، و کلیک کردن روی اعلان به حسابی با بیشترین فضای خالی تعویض میکند. روی خط یک حساب در پنل نگه دارید و روی Autoswitch که کنار Use ظاهر میشود کلیک کنید (یا m را فشار دهید)، یا omarchy agent account mode auto را اجرا کنید، تا در عوض خودش تعویض کند؛ تا وقتی روشن است، Autoswitch جای Use را میگیرد، و کلیک دوباره روی آن به اطلاعرسانی برمیگردد. برای تغییر آستانه یک عدد اضافه کنید، مانند omarchy agent account mode auto 90. اگر هر حسابی بالای آستانه باشد، یک بار درباره آن خواهید شنید، همراه با اینکه کدام حساب اول آزاد میشود. تا وقتی یک حساب فعال در فاصله 15 واحدی از آستانهاش قرار دارد (80% در حالت پیشفرض)، محدودیتهای آن هر سه دقیقه بهجای هر 15 دقیقه بررسی میشوند.
omarchy agent account list هر حساب و آخرین محدودیتهایش را نشان میدهد، omarchy agent account remove work یکی را فراموش میکند، و omarchy agent account rename primary Hey نام یکی را تغییر میدهد (یا روی نام یک حساب در پنل کلیک کنید). این دستورها روی حسابهای عامل پیشفرض شما کار میکنند؛ برای رسیدن به ارائهدهنده دیگر، ابتدا نام آن را بیاورید، مانند omarchy agent account use codex side. ورودی که از قبل در ~/.claude یا ~/.codex داشتید حساب Main است و همانجا که هست باقی میماند. حسابی که بیش از حدود هشت ساعت بلااستفاده مانده باشد میتواند Sign-in required نشان دهد؛ روی آن کلیک کنید تا آن حساب را درست در پنل دوباره وارد کنید، یا یک نشست در آن آغاز کنید، که ورود را بهخودیخود تازه میکند. سرورهای MCP که وقتی یک حساب اضافه شد داشتید همراه آن میآیند، اما آنهایی که بعداً با claude mcp add اضافه میکنید فقط به حسابی میرسند که آنها را در آن اضافه کردید. Claude Desktop و ابزارهایی که با یک مسیر مطلق به یک باینری CLI پیکربندی شدهاند از تعویض پیروی نمیکنند. یک CLAUDE_CONFIG_DIR، CODEX_HOME یا GROK_HOME صریح بر حساب انتخابشده اولویت دارد.
تشخیص خرابی
Omarchy، systemd-coredump را برای خرابیهای فرایند زیر نظر میگیرد. وقتی چیزی segfault میکند، یک اعلان «Process crashed» میگیرید - روی آن کلیک کنید، و خرابی همراه با مهار diagnose-crash در Omarchy به عامل پیشفرض شما سپرده میشود، که عامل را در برقراری حقایق از core dump و تصمیمگیری درباره اینکه آیا خرابی ارزش گزارش به upstream را دارد یا نه راهنمایی میکند. همچنین میتوانید آن را با دست در برابر هر PID از coredumpctl list با omarchy agent crash <pid> اجرا کنید.
این زیرنظرگیری بهطور پیشفرض روشن است. آن را زیر محرک > تعویض > ضبط خرابی (یا با omarchy toggle crash-capture) خاموش کنید و اعلانها متوقف میشوند؛ omarchy agent crash <pid> همچنان با دست کار میکند.
خرابیها همچنین میتوانند یک برنامه در هر بار ساکت شوند، که همان چیزی است که تشخیص در پایان به شما پیشنهاد میکند. omarchy crash mute hyprland اعلانها را فقط برای آن برنامه متوقف میکند، omarchy crash mute hyprland off آنها را برمیگرداند، و omarchy crash mute بهتنهایی آنچه را بیصدا کردهاید فهرست میکند. مسیر باینری را به همان خوشی نام آن میپذیرد، پس omarchy crash mute /usr/bin/hyprland همان کار را میکند. نامی با فاصله در آن را در نقلقول بگذارید، مانند omarchy crash mute 'Some App'. هر چیز دیگری همچنان اطلاع میدهد، و برنامه بیصداشده همچنان خراب میشود - این یادآور را پنهان میکند، چیزی را درست نمیکند.
برنامههای دسکتاپ
منوی نصب > هوش مصنوعی همچنین چند برنامه گرافیکی هوش مصنوعی را حمل میکند: برنامه دسکتاپ ChatGPT، برنامه دسکتاپ Claude (بتای Linux شرکت Anthropic، با زبانههای Chat، Cowork و Claude Code)، Grok Bot برای گفتگو با مدلهای xAI، Hermes Desktop، OpenClaw، برنامه دسکتاپ Perplexity و T3 Code. Grok Bot برنامه گفتگوی دسکتاپ است. عامل کدنویسی دستور grok است.
Hermes Desktop همان موردی است که باید دربارهاش بدانید، چون یک ماشین یک Hermes دارد، و آن مال برنامه است: Hermes فقط همیشه از طریق برنامه نصب میشود، و دستور hermes که عامل پیشفرض اجرا میکند مال برنامه است. انتخاب Hermes بهعنوان عامل پیشفرض همان چیزی را نصب میکند که مدخل نصب > هوش مصنوعی انجام میدهد: بسته، و یک زمان اجرای Hermes زیر ~/.hermes که توسط نصبکننده خود Hermes راهاندازی شده است، که نخستین بار چند دقیقه طول میکشد. آن زمان اجرا همان Hermes یگانهای است که دستور ترمینال hermes، عامل پیشفرض و برنامه همگی از آن استفاده میکنند، و خود را با hermes update بهروز میکند بهجای آنکه منتظر یک انتشار Omarchy بماند. نصب آن همچنین تم Omarchy را بهعنوان یک پوسته به نام omarchy به Hermes میدهد، که هر سطح Hermes با تغییر تمهای شما از آن پیروی میکند؛ اگر ترجیح میدهید اینطور نباشد یکی دیگر را زیر تنظیمات Appearance در Hermes یا با /skin انتخاب کنید، و Omarchy آن انتخاب را به حال خود میگذارد. حذف برنامه زیر حذف > هوش مصنوعی ابتدا Hermes را میبندد، gateway آن هم شامل، آن زمان اجرا را با خود میبرد، و گفتگوها، خاطرهها و مهارتهایی را که Hermes برای خودش نوشته نگه میدارد مگر اینکه خلاف آن را بگویید: میپرسد، با پیشفرض نه، که آیا آن داده و تنظیمات اتصال شما نیز باید بروند یا نه.
تجربه دسکتاپ OpenClaw همان Control UI آن است، که بهعنوان یک برنامه وب با پشتیبانی gateway محلی خود آن باز میشود. OpenClaw در ~/.openclaw زندگی میکند و خود را بهروز میکند: از دکمه «Update Gateway» در Control UI استفاده کنید یا openclaw update را اجرا کنید، و gateway روی نسخه جدید از نو راهاندازی میشود. Omarchy فقط انتشاری را انتخاب میکند که یک نصب تازه از آن آغاز میشود. حذف OpenClaw زیر حذف > هوش مصنوعی سرویس gateway و برنامه را با خود میبرد و سپس میپرسد که آیا ~/.openclaw نیز باید برود یا نه، چون آن گفتگوها و اعتبارنامههای شما را در کنار خود OpenClaw و زمانهای اجرای افزونهای که دانلود میکند نگه میدارد؛ پیشفرض آن را نگه میدارد، و نصب دوباره OpenClaw آن را بازمیگیرد.
T3 Code از انتشار رسمی AppImage خود در ~/.local/share/t3code اجرا میشود بهجای آنکه از یک بسته باشد، پس خود را بهروز میکند. نصب آن میپرسد که آیا روی کانال Stable یا Nightly آغاز کنید؛ بعداً در تنظیمات T3 Code تغییر دهید. رشتهها و تنظیمات شما در ~/.t3 زندگی میکنند، و حذف T3 Code زیر حذف > هوش مصنوعی آنها را با خود میبرد.
LLMهای محلی
Omarchy دو شیوه برای اجرای مدلهای LLM محلی توصیه میکند: LM Studio و Ollama. LM Studio یک رابط GUI برای یافتن مدلهای با وزن باز، نصب آنها و اجرای آنها فراهم میکند. راهی عالی برای شروع آسان است. Ollama یک CLI برای انجام مشابه آن پیشنهاد میکند. اما اگر در مدلهای محلی تازهکارید، من با LM Studio شروع میکنم. میتوانید هر یک را زیر نصب > هوش مصنوعی در منوی Omarchy نصب کنید.
مهارت Omarchy
مهارتهای عامل به هوش مصنوعی کمک میکنند از ابزارهای خاص به شیوهای خاص استفاده کند، و Omarchy با یک مهارت پیشفرض برای متناسبسازی سیستم عرضه میشود. مانند دستکاری پیکربندی Hyprland شما، تنظیم نوار، یا حتی ساختن یک تم جدید از صفر. این مهارت در پوشههای مهارت برای Claude Code (~/.claude/skills)، Codex (~/.codex/skills)، Pi (~/.pi/agent/skills)، Antigravity (~/.gemini/config/skills)، Hermes (~/.hermes/skills و هر ~/.hermes/profiles/*/skills)، و مکان عمومی ~/.agents/skills پیوند نمادین شده است، پس بیشتر مهارها آن را بهطور خودکار برمیدارند.
اما باید این مهارت را آزمایشی تلقی کنید. مدلهای مختلف آن را با تأثیر متفاوت به کار خواهند برد. بهتر است ابتدا در حالت برنامهریزی اجرا کنید، تا ایدهای داشته باشید که عامل دوست دارد چه چیزی را تغییر دهد. و سپس آماده باشید تغییرات را بازگردانید یا حتی omarchy reinstall configs را فراخوانی کنید، اگر عامل همه چیز را به هم ریخت.