| GH-COMPLETION(1) | GitHub CLI manual | GH-COMPLETION(1) |
نام (NAME)
gh-completion - تولید اسکریپتهای تکمیل خودکار دستورات برای پوستهها
خلاصه دستور (SYNOPSIS)
gh completion -s <shell>
توضیحات (DESCRIPTION)
تولید اسکریپتهای تکمیل خودکار برای دستورات واسط خط فرمان گیتهاب (GitHub CLI).
هنگام نصب GitHub CLI از طریق یک مدیر بسته، ممکن است برای فعالسازی پشتیبانی از تکمیل خودکار، به هیچ پیکربندی اضافهای در پوسته نیازی نباشد. برای Homebrew، به نشانی زیر مراجعه کنید: ⟨https://docs.brew.sh/Shell-Completion⟩
اگر نیاز دارید تکمیل خودکار را بهصورت دستی تنظیم کنید، دستورالعملهای زیر را دنبال نمایید. مکان دقیق فایلهای پیکربندی ممکن است بسته به سیستم شما متفاوت باشد. حتماً پیش از آزمایش عملکرد تکمیل خودکار، پوسته خود را دوباره راهاندازی کنید.
bash
ابتدا مطمئن شوید که بستهٔ bash-completion را با استفاده از مدیر بستهٔ خود نصب کردهاید.
سپس، این خط را به فایل ~/.bash_profile خود اضافه کنید:
eval "$(gh completion -s bash)"
zsh
یک اسکریپت تکمیل خودکار _gh تولید کرده و آن را در جایی درون $fpath خود قرار دهید:
gh completion -s zsh > /usr/local/share/zsh/site-functions/_gh
مطمئن شوید که موارد زیر در فایل ~/.zshrc شما وجود دارند:
autoload -U compinit compinit -i
نسخهٔ ۵.۷ یا بالاتر Zsh پیشنهاد میشود.
fish
یک اسکریپت تکمیل خودکار gh.fish تولید کنید:
gh completion -s fish > ~/.config/fish/completions/gh.fish
PowerShell
اسکریپت پروفایل خود را با دستور زیر باز کنید:
mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue notepad $profile
این خط را اضافه کرده و فایل را ذخیره کنید:
Invoke-Expression -Command $(gh completion -s powershell | Out-String)
گزینهها (OPTIONS)
- -s, --shell <string>
- نوع پوسته: {bash|zsh|fish|powershell}
کدهای خروج (EXIT CODES)
0: اجرای موفقیتآمیز
1: خطا
2: دستور لغو شد
4: نیاز به احراز هویت است
نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه نمایید.
همچنین ببینید (SEE ALSO)
| Sep 2026 |