gh-org-view

command module
v0.4.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 28, 2026 License: MIT Imports: 1 Imported by: 0

README

gh-org-view

Test Release

A GitHub CLI extension that renders an interactive, offline HTML explorer of a GitHub organization's teams, members (with roles), owned repositories, and CODEOWNERS path attributions.

Note: this is a permission/ownership view, not a management org chart. GitHub teams reflect access grouping, not reporting lines.

Installation

gh extension install jackchuka/gh-org-view

Requires GitHub CLI authenticated with the read:org scope (gh auth refresh -s read:org).

Usage

gh org-view <org>                 # collect (or reuse 24h cache) and open the explorer
gh org-view <org> --refresh       # force re-collection
gh org-view <org> --no-codeowners # skip the CODEOWNERS scan (faster on big orgs)
gh org-view <org> --no-members    # skip collecting members
gh org-view <org> --json          # print canonical JSON to stdout (for jq/scripting)
gh org-view <org> --no-open       # render but do not open a browser
gh org-view <org> --out-dir ./site # write index.html + org.json into ./site (for CI/static hosting)

Artifacts are written to ${TMPDIR:-/tmp}/gh-org-view/: <org>-org.json (canonical, hand-editable, 24h cache) and <org>-org.html (self-contained explorer).

License

MIT

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
Package cmd implements the gh-org-view CLI.
Package cmd implements the gh-org-view CLI.
internal
cache
Package cache stores the canonical org JSON on disk and treats it as a 24h cache that is also hand-editable between runs.
Package cache stores the canonical org JSON on disk and treats it as a 24h cache that is also hand-editable between runs.
github
Package github collects an organization's team/member/repo/CODEOWNERS topology from the GitHub GraphQL API (CODEOWNERS file contents via REST) into a canonical, JSON-serializable model.
Package github collects an organization's team/member/repo/CODEOWNERS topology from the GitHub GraphQL API (CODEOWNERS file contents via REST) into a canonical, JSON-serializable model.
render
Package render fills the embedded HTML UI from an Org model.
Package render fills the embedded HTML UI from an Org model.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL