https://github.com/koki-develop/ghatree
🌲 Visualize GitHub Actions workflow dependencies as a tree structure.
https://github.com/koki-develop/ghatree
Last synced: about 2 months ago
JSON representation
🌲 Visualize GitHub Actions workflow dependencies as a tree structure.
- Host: GitHub
- URL: https://github.com/koki-develop/ghatree
- Owner: koki-develop
- License: mit
- Created: 2025-08-19T11:43:30.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-03-03T14:02:27.000Z (about 2 months ago)
- Last Synced: 2026-03-03T18:14:22.470Z (about 2 months ago)
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/ghatree
- Size: 289 KB
- Stars: 17
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/ghatree)
[](https://github.com/koki-develop/ghatree/actions/workflows/release-please.yml)
[](./LICENSE)
# ghatree
Visualize GitHub Actions workflow dependencies as a tree structure.
## Usage
You can run it with `npx`.
```bash
$ npx ghatree@latest
```
`ghatree` internally uses the GitHub REST API to retrieve GitHub Actions information.
You can set the token for the GitHub REST API using the `GITHUB_TOKEN` environment variable.
```bash
$ GITHUB_TOKEN= npx ghatree@latest
```
By default, `ghatree` outputs the GitHub Actions workflow dependencies for the repository in the current directory.
To specify a remote repository, use the `--repo` flag.
```bash
$ npx ghatree@latest --repo koki-develop/ghatree
```
To output in JSON format, use the `--json` flag.
```bash
$ npx ghatree@latest --json
```
Output Example
```json5
{
"type": "repository",
"repository": {
"owner": "koki-develop",
"name": "ghatree"
},
"dependencies": [
{
"type": "workflow",
"repository": {
"owner": "koki-develop",
"name": "ghatree"
},
"path": ".github/workflows/ci.yml",
"dependencies": [
{
"type": "job",
"name": "lint",
"dependencies": [
{
"type": "action",
"repository": {
"owner": "actions",
"name": "checkout"
},
"ref": "11bd71901bbe5b1630ceea73d27597364c9af683",
"dependencies": []
},
// ...
]
},
// ...
]
},
// ...
]
}
```
## License
[MIT](./LICENSE)