Skip to main content
Storage plugin · listing tai42/storage-github

​
Install

​
Permissions

​
Provides

​
github

Storage — Storage backend serving text and binary/media content over a GitHub repository. Stores content as files on a branch of a GitHub repository, which makes every write a commit and every version reviewable. Select it in the manifest:
manifest.yml

​
Configuration

​
Token scopes

A fine-grained token needs Contents: read and write on the repository; a classic token needs repo. Only STORAGE_GITHUB_TOKEN is read — an ambient GITHUB_TOKEN is ignored, as are proxy environment variables.

​
Quirks

Two limits shape what this provider suits. Writes are capped at 1 MiB and a larger payload raises before the request. Reads come from the raw content CDN, which can serve a stale copy for a few minutes after a write — do not use GitHub storage for content a tool writes and immediately reads back.
Listing uses the recursive tree API and raises on a truncated response rather than acting on a partial listing. The API host is fixed, so GitHub Enterprise Server is not supported.

​
See also