GitHub provider

The GitHub provider mirrors repositories, issues, pull requests, and CI runs into the local filesystem. Once mounted, every GitHub resource is a path; no SDK, no pagination loop, no auth dance per call.

Note

Status: live. The provider is available today via npm install -g @0xff-ai/omnifs.

Mount

omnifs mount /omnifs

The GitHub provider activates automatically when you access any path under /omnifs/github. Configure credentials before mounting (see Configuration).

Path reference

Paths follow this grammar:

/github/{owner}
/github/{owner}/{repo}
/github/{owner}/{repo}/_repo
/github/{owner}/{repo}/_issues/_open
/github/{owner}/{repo}/_issues/_all
/github/{owner}/{repo}/_issues/{filter}/{n}/title
/github/{owner}/{repo}/_issues/{filter}/{n}/body
/github/{owner}/{repo}/_issues/{filter}/{n}/state
/github/{owner}/{repo}/_issues/{filter}/{n}/comments/{i}
/github/{owner}/{repo}/_prs/{filter}/{n}/diff
/github/{owner}/{repo}/_actions/runs/{id}/status
/github/{owner}/{repo}/_actions/runs/{id}/log

{owner} is a GitHub user or organization name. {repo} is the repository name. {filter} is one of the directory names listed under _issues or _prs (e.g. _open, _all). {n} is the issue or pull request number. {id} is the Actions run ID. {i} is the zero-based comment index.

Owner

ls /omnifs/github/ollama

Lists the repositories visible to your token under that owner.

Repository root

ls /omnifs/github/ollama/ollama

Returns the top-level entries for that repository:

_actions  _issues  _prs  _repo

Repository metadata

ls /omnifs/github/ollama/ollama/_repo

Lists metadata fields (description, default branch, visibility, etc.) as individual files.

cat /omnifs/github/ollama/ollama/_repo/description

Issues

List open or all issues by directory:

ls /omnifs/github/ollama/ollama/_issues/_open
ls /omnifs/github/ollama/ollama/_issues/_all

Read individual fields for issue number 12345:

cat /omnifs/github/ollama/ollama/_issues/_open/12345/title
cat /omnifs/github/ollama/ollama/_issues/_open/12345/body
cat /omnifs/github/ollama/ollama/_issues/_open/12345/state

Read a specific comment (zero-based index):

cat /omnifs/github/ollama/ollama/_issues/_open/12345/comments/0

Pull requests

Read the unified diff for PR number 42:

cat /omnifs/github/ollama/ollama/_prs/_open/42/diff

Pipe it anywhere you’d pipe a diff:

cat /omnifs/github/ollama/ollama/_prs/_open/42/diff | grep '^+' | wc -l

Actions runs

Read the conclusion of a run by its ID:

cat /omnifs/github/ollama/ollama/_actions/runs/9876543210/status

Stream the full log:

cat /omnifs/github/ollama/ollama/_actions/runs/9876543210/log

tail -f works if the run is still in progress and the host runtime is receiving upstream events.

Configuration

Key	Required	Description
token	yes	GitHub personal access token. Reads from $GITHUB_TOKEN if set.
api_url	no	API base URL. Default: https://api.github.com. Override for GitHub Enterprise.

Set your token before mounting:

export GITHUB_TOKEN=ghp_...
omnifs mount /omnifs

For GitHub Enterprise, specify the API base URL in your omnifs config file:

[providers.github]
token = "${GITHUB_TOKEN}"
api_url = "https://github.example.com/api/v3"

Caution

The host runtime holds the token and makes every outbound HTTPS request on the provider’s behalf. The provider WASM component never opens a socket and never reads the credential directly. This is enforced by the sandbox; there is no ambient authority.

Examples

Find all open issues mentioning “quantized”:

grep -r "quantized" /omnifs/github/ollama/ollama/_issues/_open/

Diff two PRs side by side:

diff \
  <(cat /omnifs/github/ollama/ollama/_prs/_open/100/diff) \
  <(cat /omnifs/github/ollama/ollama/_prs/_open/101/diff)

Watch a CI run finish:

watch -n5 cat /omnifs/github/ollama/ollama/_actions/runs/9876543210/status

Pull every open issue title into a plain list:

for f in /omnifs/github/ollama/ollama/_issues/_open/*/title; do cat "$f"; done

Combine with Linear to cross-reference a failing run against the relevant ticket (both providers live, one shell):

cat /omnifs/github/myorg/api/_actions/runs/9876543210/status
cat /omnifs/linear/teams/ENG/issues/_open/ENG-412/title