.nh
.TH "GH-COMPLETION" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-completion \- تولید اسکریپت‌های تکمیل خودکار دستورات برای پوسته‌ها


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh completion -s <shell>\fR


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

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

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

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

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

.EX
eval "$(gh completion -s bash)"
.EE

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

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

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

.EX
autoload -U compinit
compinit -i
.EE

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

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

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

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

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

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

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


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-s\fR, \fB--shell\fR \fB<string>\fR
نوع پوسته: {bash|zsh|fish|powershell}


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

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

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

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


.SH "همچنین ببینید (SEE ALSO)"
\fBgh(1)\fR