.nh
.TH "GH-PROJECT-ITEM-LIST" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-project-item-list \- فهرست کردن آیتم‌های یک پروژه


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh project item-list [<number>] [flags]\fR


.SH "توضیحات (DESCRIPTION)"
فهرست کردن آیتم‌های یک پروژه.

.PP
در صورت پشتیبانی میزبان API (شامل github.com و GHES نسخه ۳.۲۰ به بالا)، گزینه
.B \-\-query
می‌تواند برای انجام جستجوی پیشرفته استفاده شود. برای مشاهده نحو کامل، ببینید:
\[la]https://docs.github.com/en/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects\[ra]


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--field\fR \fB<stringArray>\fR
نام فیلدی برای نمایش به عنوان یک ستون اضافی

.TP
\fB--field-id\fR \fB<stringArray>\fR
شناسه فیلدی برای نمایش به عنوان یک ستون اضافی

.TP
\fB--format\fR \fB<string>\fR
قالب خروجی: {json}

.TP
\fB-q\fR, \fB--jq\fR \fB<expression>\fR
فیلتر کردن خروجی JSON با استفاده از عبارت jq

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 30)\fR
حداکثر تعداد آیتم‌ها برای واکشی

.TP
\fB--owner\fR \fB<string>\fR
نام کاربری مالک. از "@me" برای کاربر فعلی استفاده کنید

.TP
\fB--query\fR \fB<string>\fR
فیلتر کردن آیتم‌ها با استفاده از نحو فیلتر Projects، مانند "assignee:octocat -status:Done"

.TP
\fB-t\fR, \fB--template\fR \fB<string>\fR
قالب‌بندی خروجی JSON با استفاده از یک الگوی Go؛ دستور "gh help formatting" را ببینید


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

.PP
1: خطا

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

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

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


.SH "مثال‌ها (EXAMPLES)"
.EX
# فهرست کردن آیتم‌های پروژه "1" کاربر فعلی
$ gh project item-list 1 --owner "@me"

# فهرست کردن آیتم‌های واگذارشده به یک کاربر خاص
$ gh project item-list 1 --owner "@me" --query "assignee:monalisa"

# فهرست کردن ایشیوهای باز واگذارشده به خودتان
$ gh project item-list 1 --owner "@me" --query "assignee:@me is:issue is:open"

# فهرست کردن آیتم‌های دارای برچسب "bug" که انجام نشده‌اند
$ gh project item-list 1 --owner "@me" --query "label:bug -status:Done"

# نمایش مقادیر فیلدهای "Status" و "Priority" به عنوان ستون‌های اضافی
$ gh project item-list 1 --owner "@me" --field "Status" --field "Priority"

.EE


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