发布
- 作者仓库星标 16
- 许可证 MIT
- 作者仓库 wave
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 94 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @re-cinq · MIT
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# List PR numbers and titles
gh pr list --json number,title --jq '.[] | "\(.number): \(.title)"'
# Get issue labels
gh issue view 123 --json labels --jq '.labels[].name'
# Filter open PRs by author
gh pr list --json number,title,author \
--jq '.[] | select(.author.login == "alice")'
# GitHub CLI (gh)
Work seamlessly with GitHub from the command line. For the complete command reference see [`references/full-reference.md`](references/full-reference.md).
## Authentication
```bash
# Interactive login
gh auth login
# Login with token
gh auth login --with-token < token.txt
# Check status
gh auth status
# Switch accounts
gh auth switch --hostname github.com --user username
# Setup git credential helper
gh auth setup-git
# Print active token
gh auth token
```
## Pull Requests
```bash
# Create PR (interactive)
gh pr create
# Create with title, body, base, draft, reviewer
gh pr create --title "Feature: X" --body "Details..." --base main --draft --reviewer alice
# List open PRs
gh pr list
# List with filters
gh pr list --author @me --labels bug --state all --limit 50
# View a PR
gh pr view 123
gh pr view 123 --comments --web
# Merge a PR
gh pr merge 123 --squash --delete-branch
# Check CI status
gh pr checks 123
gh pr checks 123 --watch
```
## Issues
```bash
# Create issue (interactive)
gh issue create
# Create with title and labels
gh issue create --title "Bug: X" --body "Steps..." --labels bug,high-priority --assignee @me
# List open issues
gh issue list
# List with filters
gh issue list --assignee @me --labels bug --state all --search "is:open label:bug"
# View an issue
gh issue view 123
gh issue view 123 --comments --web
# Close / reopen
gh issue close 123 --comment "Fixed in PR #456"
gh issue reopen 123
```
## Common Flags
| Flag | Description |
|---|---|
| `--repo OWNER/REPO` | Target a specific repository |
| `--json FIELDS` | Output JSON for given fields |
| `--jq EXPRESSION` | Filter JSON output with jq |
| `--web` | Open result in browser |
| `--paginate` | Follow pagination for large result sets |
| `--limit N` | Cap result count |
## API Requests
```bash
# REST GET
gh api /user --jq '.login'
# REST POST with fields
gh api --method POST /repos/owner/repo/issues \
--field title="Issue title" --field body="Body"
# Paginate all results
gh api /user/repos --paginate
# GraphQL query
gh api graphql -f query='{ viewer { login } }'
```
## JSON Output Examples
```bash
# List PR numbers and titles
gh pr list --json number,title --jq '.[] | "\(.number): \(.title)"'
# Get issue labels
gh issue view 123 --json labels --jq '.labels[].name'
# Filter open PRs by author
gh pr list --json number,title,author \
--jq '.[] | select(.author.login == "alice")'
```
## Complete Reference
For all commands including repos, releases, Actions, projects, gists, codespaces, search, secrets, extensions, and more, see:
**[`references/full-reference.md`](references/full-reference.md)**
章节与文件索引
按说明文件中的顺序排列。
通用标志
完整参考
文件/命令 -> references/full-reference.md · --repo OWNER/REPO · --json FIELDS · --jq EXPRESSION · --web · --paginate · --limit N
内容校验值 -> 73a0b950b18b
当前原文的自动摘译,尚未人工审校。
通用标志
标志 · 描述
--repo OWNER/REPO· 定位特定存储库--json FIELDS· 给定字段的输出 JSON--jq EXPRESSION· 使用 jq 过滤 JSON 输出--web· 在浏览器中打开结果完整参考
有关所有命令,包括存储库、发布、操作、项目、要点、代码空间、搜索、秘密、扩展等,请参阅:
references/full-reference.md