GH-COMPLETION(1) GitHub CLI manual GH-COMPLETION(1)

gh-completion - تولید اسکریپت‌های تکمیل خودکار دستورات برای پوسته‌ها

gh completion -s <shell>

تولید اسکریپت‌های تکمیل خودکار برای دستورات واسط خط فرمان گیت‌هاب (GitHub CLI).

هنگام نصب GitHub CLI از طریق یک مدیر بسته، ممکن است برای فعال‌سازی پشتیبانی از تکمیل خودکار، به هیچ پیکربندی اضافه‌ای در پوسته نیازی نباشد. برای Homebrew، به نشانی زیر مراجعه کنید: ⟨https://docs.brew.sh/Shell-Completion⟩

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

ابتدا مطمئن شوید که بستهٔ bash-completion را با استفاده از مدیر بستهٔ خود نصب کرده‌اید.

سپس، این خط را به فایل ~/.bash_profile خود اضافه کنید:

eval "$(gh completion -s bash)"

یک اسکریپت تکمیل خودکار _gh تولید کرده و آن را در جایی درون $fpath خود قرار دهید:

gh completion -s zsh > /usr/local/share/zsh/site-functions/_gh

مطمئن شوید که موارد زیر در فایل ~/.zshrc شما وجود دارند:

autoload -U compinit
compinit -i

نسخهٔ ۵.۷ یا بالاتر Zsh پیشنهاد می‌شود.

یک اسکریپت تکمیل خودکار gh.fish تولید کنید:

gh completion -s fish > ~/.config/fish/completions/gh.fish

اسکریپت پروفایل خود را با دستور زیر باز کنید:

mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue
notepad $profile

این خط را اضافه کرده و فایل را ذخیره کنید:

Invoke-Expression -Command $(gh completion -s powershell | Out-String)

نوع پوسته: {bash|zsh|fish|powershell}

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

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

gh(1)

Sep 2026