أكاكوس كود في سطر الأوامرAcacus Code on the command line

التثبيتInstall

أمر واحد يثبّت كل شيء، ويصلح أيضًا للتحديث لاحقًا. الحجم نحو 57 ميغابايت على ويندوز ونحو 55 على لينكس.One command installs everything, and works again later as an update. The download is about 57 MB on Windows and 55 MB on Linux.

ويندوز (PowerShell)Windows (PowerShell)

irm https://acacus.ly/cli/install.ps1 | iex

لينكسLinux

curl -fsSL https://acacus.ly/cli/install.sh | sh

ما يفعله المثبّت: ينزّل البرنامج من acacus.ly ويتحقق من بصمته (SHA-256) قبل أن يثبّته، ويضعه في المجلد .acacus\bin داخل مجلد المستخدم (~/.acacus/bin في لينكس)، ويضيف هذا المجلد إلى مسار الأوامر (PATH). لا يحتاج صلاحيات مدير ولا sudo، ولا يرسل أي بيانات قياس، ولا يقرأ موقعًا آخر.What the installer does: it downloads the program from acacus.ly, checks its SHA-256 sum before installing, puts it in the .acacus\bin folder inside your user folder (~/.acacus/bin on Linux), and adds that folder to your PATH. It needs no administrator rights and no sudo, sends no telemetry, and reads no other site.

1. ويندوز 64 بت (ويندوز على معالج ARM يشغّله بمحاكاة ويندوز). لا حاجة إلى تغيير سياسة تنفيذ السكربتات.64-bit Windows (Windows on ARM runs it through Windows' own emulation). You do not need to change the script execution policy.
2. لينكس على معالج x86_64 أو arm64 ومكتبة glibc (أوبنتو ودبيان وفيدورا). لا يعمل على Alpine. يحتاج المثبّت curl أو wget، وtar، وsha256sum.Linux on x86_64 or arm64 with glibc (Ubuntu, Debian, Fedora). It does not run on Alpine. The installer needs curl or wget, tar and sha256sum.
3. ماك غير متاح بعد.macOS is not available yet.
4. يحتاج الاستخدام باقة العادي فما فوق. الباقاتUsing it needs the Standard plan or above. Plans

بعد التثبيت افتح نافذة طرفية جديدة، فتغييرات PATH لا تظهر في النوافذ المفتوحة قبلها.After installing, open a new terminal window: a PATH change does not show in windows that were already open.

أول تشغيل وتسجيل الدخولFirst run and signing in

acacus

1. ينفتح المتصفح على acacus.ly. وإن لم ينفتح (جلسة SSH مثلًا) فيطبع البرنامج عنوانًا تفتحه بنفسك، حتى من جهاز آخر.Your browser opens on acacus.ly. If it cannot (an SSH session, for example) the program prints an address for you to open yourself, even on another device.
2. تعرض الصفحة رمزًا قصيرًا، ويطبع البرنامج رمزًا في الطرفية. اعتمد الدخول فقط إن كان الرمزان متطابقين. وإن لم تكن أنت من بدأ العملية فأغلق الصفحة.The page shows a short code, and the program prints a code in the terminal. Approve only if the two codes match. If you did not start this sign-in, close the page.
3. يتلقى البرنامج الموافقة ويكمل، ثم تظهر لك مرة واحدة إرشادات قصيرة. اضغط Ctrl+C أثناء الانتظار لتلغي.The program receives the approval and goes on, and a short guide appears once. Press Ctrl+C while it waits to cancel.

حدّ تسجيلات الدخول: خمسةThe sign-in limit: five

تسجيل الدخول من سطر الأوامر ليس «جهازًا» من أجهزة باقتك، وله حدّه: خمسة تسجيلات نشطة معًا لكل حساب، من سطر الأوامر والإضافة معًا. فإذا سجّلت السادس أُنهي أقدمها. تجدها وتنهيها من صفحة الأجهزة والتطبيقات في قسم «Acacus Code».Signing in from the command line is not one of your plan's devices; it has its own limit: five active sign-ins at once per account, counting the command line and the extension together. When you sign in a sixth time, the oldest one is ended. You can see and end them on the Devices & apps page, in the Acacus Code section.

acacus auth status    # who is signed in
acacus auth login     # sign in again
acacus auth logout    # sign out on this computer

الاستخدام اليوميDaily use

افتح الطرفية في مجلد مشروعك ثم شغّل الأوامر التالية.Open the terminal in your project folder, then run these.

acacus                     # the interactive session, in this folder
acacus run "explain this repo"   # one request from the command line
acacus run -i "fix the failing test"   # same, and you approve edits and commands
acacus usage               # your windows and when they reset (--json for scripts)
acacus models              # the models your plan includes

1. داخل الجلسة تبدّل بين الوكلاء بمفتاح Tab: code يعدّل الملفات وينفّذ الأوامر بعد أن يسألك، وplan يقرأ ويخطط دون تغيير، وask يجيب عن الأسئلة دون تغيير.Inside the session, press Tab to change agent: code edits files and runs commands after asking you, plan reads and plans and changes nothing, ask answers questions and changes nothing.
2. أوامر الجلسة: /new جلسة جديدة، و/compact لتقصير جلسة طويلة، و/help لكل الأوامر.Session commands: /new starts a fresh session, /compact shortens a long one, /help lists them all.

الأذونات: يسألك قبل أي تعديلPermissions: it asks before it changes anything

قبل أن يعدّل ملفًا أو ينفّذ أمرًا قد يغيّر شيئًا يتوقف ويسألك: «السماح مرة»، أو «السماح دائمًا» لهذا النوع من الأعمال في هذه الجلسة، أو «رفض». اختر بالسهمين ثم Enter. القراءة والبحث لا يحتاجان إلى إذن. وليس في البرنامج خيار لتجاوز الأذونات.Before it edits a file or runs a command that could change something, it stops and asks: Allow once, Allow always (this kind of action, this session) or Reject. Choose with the arrow keys, then Enter. Reading and searching need no approval. The program has no option to skip the approvals.

من أين تُحسب حصتي؟Where does my allowance come from?

من حصة باقتك نفسها (نافذة الساعات الخمس والحصة الأسبوعية)، مشتركة مع المحادثة على الموقع والإضافة، ولا تُخصم من رصيد الواجهة البرمجية. الجلسات القصيرة تستهلك أقل من النافذة. شغّل acacus usage في أي نافذة طرفية أخرى لترى ما بقي.From your plan's own allowance (the five-hour window and the weekly share), shared with the chat on the website and the extension. It is never charged to the API balance. Short sessions use less of the window. Run acacus usage in any other terminal window to see what is left.

التحديثUpdating

acacus upgrade           # update to the latest version
acacus upgrade --check   # only look, install nothing

الأمر يقرأ قائمة الإصدارات من acacus.ly، ولا يثبّت إلا ما كان موقَّعًا: القائمة موقّعة بتوقيع ed25519 يتحقق منه البرنامج بمفتاح عام مدمج فيه، ثم يتحقق من بصمة الملف قبل أن يحلّه محل النسخة الحالية. إن فشل التحقق لم يتغير شيء. ويمكنك بدلًا من ذلك إعادة تشغيل أمر التثبيت نفسه.The command reads the list of releases from acacus.ly and installs only what is signed: the list carries an ed25519 signature that the program checks against a public key built into it, then checks the file's sum before it replaces the current copy. If a check fails, nothing changes. You can also just run the install command again.

النسخة التي لم تُثبَّت بالمثبّت لا تحدّث نفسها. وفي ويندوز قد يبقى ملف acacus.exe.old بعد التحديث، ويُحذف عند التشغيل التالي.A copy that was not installed with the installer cannot update itself. On Windows an acacus.exe.old file may be left after an update; it is removed at the next start.

الإزالةUninstall

ابدأ بتسجيل الخروج حتى ينتهي تسجيل الدخول في حسابك أيضًا، ثم احذف ما ثبّته المثبّت.Start by signing out, so the sign-in also ends on your account, then remove what the installer put there.

acacus auth logout

ويندوزWindows

1. احذف مجلد %USERPROFILE%\.acacus (فيه البرنامج في bin).Delete the %USERPROFILE%\.acacus folder (the program is in bin).
2. احذف مدخل المسار: %USERPROFILE%\.acacus\bin من متغير Path الخاص بحسابك. إما من «تحرير متغيرات البيئة لحسابك» في إعدادات ويندوز، أو بالأمر أدناه.Remove the PATH entry %USERPROFILE%\.acacus\bin from your user Path variable, either in Windows' Edit environment variables for your account, or with the command below.

Remove-Item -Recurse -Force "$env:USERPROFILE\.acacus"
$bin = Join-Path $env:USERPROFILE '.acacus\bin'
$parts = [Environment]::GetEnvironmentVariable('Path', 'User') -split ';' | Where-Object { $_ -and ($_.TrimEnd('\') -ine $bin) }
[Environment]::SetEnvironmentVariable('Path', ($parts -join ';'), 'User')

لينكسLinux

1. احذف مجلد ~/.acacus.Delete the ~/.acacus folder.
2. افتح ملف بدء الطرفية (‎~/.bashrc أو ~/.zshrc أو ~/.bash_profile أو ~/.profile) واحذف الكتلة الموسومة التي أضافها المثبّت، من السطر # >>> acacus >>> إلى السطر # <<< acacus <<<. وإن كنت تستخدم fish فاحذف الملف ~/.config/fish/conf.d/acacus.fish.Open your shell start-up file (~/.bashrc, ~/.zshrc, ~/.bash_profile or ~/.profile) and delete the marked block the installer added, from the line # >>> acacus >>> to the line # <<< acacus <<<. With fish, delete the file ~/.config/fish/conf.d/acacus.fish.

rm -rf ~/.acacus

إن كنت عيّنت ACACUS_HOME عند التثبيت فالمجلد هناك لا في ‎.acacus. وللإبقاء على المسار دون تعديل ملفاتك عيّن ACACUS_NO_MODIFY_PATH=1 قبل التثبيت. إعدادات البرنامج وبياناته المحلية تُحفظ عادة في مجلدات باسم acacus-code تحت ~/.local/share و~/.config و~/.cache (في ويندوز تحت %USERPROFILE%)، ويمكنك حذفها أيضًا.If you set ACACUS_HOME when installing, the folder is there instead of .acacus. To keep your PATH and shell files untouched, set ACACUS_NO_MODIFY_PATH=1 before installing. The program's settings and local data are usually kept in folders named acacus-code under ~/.local/share, ~/.config and ~/.cache (on Windows under %USERPROFILE%); you can delete those too.

حل المشكلاتTroubleshooting

ويندوز يقول «Windows protected your PC» (SmartScreen)Windows says “Windows protected your PC” (SmartScreen)

البرنامج غير موقَّع برمز توقيع شركة في هذا الإصدار. والتثبيت بأمر PowerShell أعلاه لا يضع على الملف علامة «منزَّل من الإنترنت» التي تثير التحذير، فلا يظهر عادة. وإن نزّلت الملف بالمتصفح وظهر التحذير فاضغط «More info» ثم «Run anyway» إن كانت بصمة الملف تطابق ما في قائمة الإصدارات. ويفحص Windows Defender الملف كالمعتاد.In this version the program is not code-signed. Installing with the PowerShell command above does not put the “downloaded from the internet” mark on the file that raises the warning, so it usually does not appear. If you downloaded the file with a browser and the warning shows, press More info, then Run anyway, only if the file's sum matches the release list. Windows Defender scans the file as usual.

قائمة الإصدارات وبصمة كل ملف: acacus.ly/cli/manifest.json.The release list with the sum of each file: acacus.ly/cli/manifest.json.

«acacus is not recognized» أو «command not found»“acacus is not recognized” or “command not found”

افتح نافذة طرفية جديدة، فالتغيير في PATH لا يصل إلى النوافذ المفتوحة. وإن استمرت المشكلة فتأكد أن المجلد .acacus\bin موجود في PATH، أو شغّل البرنامج بمساره الكامل.Open a new terminal window: a PATH change does not reach windows that were already open. If it persists, check that the .acacus\bin folder is on your PATH, or run the program by its full path.

الطرفية تفتح في C:\Windows\System32 أو في مجلد المستخدمThe terminal opens in C:\Windows\System32 or in your home folder

يحدث هذا حين تفتح الطرفية من قائمة ابدأ أو بخيار «Run as administrator». أكاكوس كود يعمل على المجلد الذي تبدأ فيه، فلا تشغّله من System32 ولا من مجلد النظام. ينبّهك البرنامج إلى ذلك دون أن يمنعك. انتقل أولًا إلى مشروعك ثم شغّله:This happens when the terminal is opened from the Start menu or with Run as administrator. Acacus Code works on the folder you start it in, so do not run it from System32 or another system folder. The program warns you but does not stop you. Go to your project first, then start it:

cd path\to\your\project
acacus

حدود الباقةPlan limits

1. تظهر رسالة بأن أكاكوس كود ليس ضمن باقة الحساب: باقتك لا تشمله. يحتاج سطر الأوامر باقة العادي فما فوق. شغّل acacus usage لترى ما تشمله باقتك.“Acacus Code is not part of this account's plan”: your plan does not include it. The command line needs the Standard plan or above. Run acacus usage to see what your plan includes.
2. انتهت النافذة أو الحصة الأسبوعية: لا تُقبل طلبات جديدة حتى تتجدد، ويخبرك البرنامج متى. acacus usage يعرض موعد التجدد.A window or the weekly share is used up: no new requests are accepted until it renews, and the program tells you when. acacus usage shows the renewal time.
3. «Your sign-in has ended»: انتهى تسجيل الدخول (أُنهي من صفحة الأجهزة، أو تجاوزت الخمسة). شغّل acacus auth login.“Your sign-in has ended”: the sign-in was ended (on the Devices page, or by going past five). Run acacus auth login.
4. «Too many sign-in attempts are waiting»: انتظر بضع دقائق ثم أعد المحاولة.“Too many sign-in attempts are waiting”: wait a few minutes and try again.

المثبّت يتوقف عند فحص البصمةThe installer stops at the checksum

لم يثبّت شيء. أعد المحاولة بعد قليل، فقد يكون التنزيل انقطع. وإن تكرر فراسلنا.Nothing was installed. Try again in a moment; the download may have been cut short. If it repeats, write to us.

أسئلة أخرى؟ المساعدة أو تواصل معنا.More questions? Help or contact us.