Skip to content

README.md

Latest commit

 

History

History
82 lines (53 loc) · 3.51 KB

README.md

File metadata and controls

82 lines (53 loc) · 3.51 KB

fledge-plugin-github

CI

GitHub commands for fledge — view CI checks, issues, and pull requests through the gh CLI.

These commands lived in fledge core through v0.14, then moved to this plugin as part of the v0.15 tight-core refactor. The plugin keeps fledge's binary lean for users on GitLab, Gitea, or self-hosted Git, and lets the GitHub-specific surface evolve independently.

Install

fledge plugins install CorvidLabs/fledge-plugin-github

Requires the gh CLI installed and authenticated (gh auth login).

Commands

All commands are nested under fledge github so the GitHub-specific surface stays out of the way for users on other forges.

fledge github checks [--branch <name>] [--json]

Show CI/CD check-run status for a branch. Defaults to the current branch.

$ fledge github checks
* CI checks for main:

  ✅ test (macos-latest)    success    37s
  ✅ test (ubuntu-latest)   success    41s
  ✅ test (windows-latest)  success    2m 22s
  ✅ lint                   success    30s
  ✅ spec-check             success    4s

  5 checks: 5 passed

JSON output is the raw GitHub API response from repos/{owner}/{repo}/commits/{branch}/check-runs.

fledge github issues [list | view <num> | create] [OPTIONS]

Browse and create issues. Lists by default; view <number> shows a specific one; create opens a new issue.

$ fledge github issues --state all --limit 5
$ fledge github issues view 42 --json
$ fledge github issues create --title "Bug: something broke"
$ fledge github issues create --title "Feature request" --label enhancement --assignee octocat --json

List/view options: --state {open,closed,all}, --limit <N>, --label <label>, --json.
Create options: --title <title>, --body <body>, --label <label>, --assignee <login>, --json.

fledge github prs [list | view <num> | create] [OPTIONS]

Browse and create pull requests. Lists by default; view <number> shows a specific one; create opens a new PR.

$ fledge github prs --state merged --limit 5
$ fledge github prs view 256 --json
$ fledge github prs create --fill
$ fledge github prs create --ai
$ fledge github prs create --ai --draft
$ fledge github prs create --title "My feature" --draft --json

List/view options: --state {open,closed,merged,all}, --limit <N>, --json.
Create options: --title <title>, --body <body>, --base <branch>, --draft, --fill, --ai, --json.

--ai generates a PR title and body by sending your commits and diff to fledge ask. It shows a preview and lets you confirm, edit, or abort before creating the PR.

Why a plugin?

A flat checks/issues/prs surface bakes "all dev happens on GitHub" into fledge core. A user on GitLab or self-hosted Gitea would carry these as dead weight. Nesting under fledge github keeps the namespace honest and lets a future fledge-plugin-gitlab register fledge gitlab ... alongside it without colliding.

Hacking

bin/fledge-github is a thin dispatcher; each subcommand is a self-contained POSIX-ish shell script (bin/fledge-github-checks, …-issues, …-prs). The scripts use gh api (or gh issue/gh pr) to talk to GitHub, then format the response — no extra runtime dependencies beyond gh, git, jq, and awk.

License

MIT — see LICENSE.