Path schemes

This page lists every path that omnifs exposes for the five live providers. ls paths are listable directories; cat paths are readable files. {placeholders} mark variable segments. Copy-paste any path into your shell with the omnifs mount prefix (default /omnifs).

WIP providers (huggingface, kubernetes, postgres, slack, redis, s3, stripe, cloudflare, vercel, oci, mcp, spotify, discord) have draft schemes that are not yet stable and are not documented here.

GitHub

Mount root: /github

Requires: GITHUB_TOKEN (personal access token). For GitHub Enterprise, set api_url to your instance’s API base.

Operation	Path	Type
List owner’s repos	`/github/{owner}`	`ls`
List repo sections	`/github/{owner}/{repo}`	`ls`
List repo metadata entries	`/github/{owner}/{repo}/_repo`	`ls`
List open issues	`/github/{owner}/{repo}/_issues/_open`	`ls`
List all issues	`/github/{owner}/{repo}/_issues/_all`	`ls`
Issue title	`/github/{owner}/{repo}/_issues/{filter}/{n}/title`	`cat`
Issue body	`/github/{owner}/{repo}/_issues/{filter}/{n}/body`	`cat`
Issue state	`/github/{owner}/{repo}/_issues/{filter}/{n}/state`	`cat`
Issue comment	`/github/{owner}/{repo}/_issues/{filter}/{n}/comments/{i}`	`cat`
PR diff	`/github/{owner}/{repo}/_prs/{filter}/{n}/diff`	`cat`
Actions run status	`/github/{owner}/{repo}/_actions/runs/{id}/status`	`cat`
Actions run log	`/github/{owner}/{repo}/_actions/runs/{id}/log`	`cat`

{filter} matches the listing directory name (_open, _all). {n} is the issue or PR number. {id} is the Actions run ID. {i} is the comment index.

ls /omnifs/github/ollama/ollama/_issues/_open
cat /omnifs/github/ollama/ollama/_issues/_open/12345/title
cat /omnifs/github/ollama/ollama/_prs/_open/892/diff
cat /omnifs/github/ollama/ollama/_actions/runs/9876543210/status

Docker

Mount root: /docker

No required config. Defaults to unix:///var/run/docker.sock; set endpoint to override.

Operation	Path	Type
System info	`/docker/system/info.json`	`cat`
Daemon version	`/docker/system/version.json`	`cat`
Full container inspection	`/docker/containers/by-name/{name}/inspect.json`	`cat`
Container summary	`/docker/containers/by-name/{name}/summary.txt`	`cat`
Container state	`/docker/containers/by-name/{name}/state`	`cat`
Full container inspection (by ID)	`/docker/containers/by-id/{id}/inspect.json`	`cat`
List running containers	`/docker/containers/_running`	`ls`
List stopped containers	`/docker/containers/_stopped`	`ls`
Compose service containers	`/docker/compose/{project}/services/{service}/containers/{name}`	`ls`

{name} is the container name as shown by docker ps. {id} is the container ID (full or prefix). {project} and {service} match Compose project and service names.

ls /omnifs/docker/containers/_running
cat /omnifs/docker/containers/by-name/postgres/state
cat /omnifs/docker/containers/by-name/nginx/inspect.json | jq .NetworkSettings

arXiv

Mount root: /arxiv

No credentials required.

Operation	Path	Type
List paper files	`/arxiv/papers/{id}`	`ls`
Download PDF	`/arxiv/papers/{id}/paper.pdf`	`cat`
Download source	`/arxiv/papers/{id}/source.tar.gz`	`cat`
Paper metadata	`/arxiv/papers/{id}/metadata.json`	`cat`
List version files	`/arxiv/papers/{id}/versions/v{n}`	`ls`
List new submissions in category	`/arxiv/categories/{cat}/new`	`ls`
List submissions by date	`/arxiv/categories/{cat}/{YYYY}/{MM}/{DD}`	`ls`
Search results	`/arxiv/search/{query}`	`ls`

{id} is the arXiv identifier (e.g. 1706.03762, 2310.06825). {cat} is an arXiv category slug (e.g. cs.AI, math.CO). {query} is a URL-encoded search string.

ls /omnifs/arxiv/papers/1706.03762
# paper.pdf  source.tar.gz  metadata.json  links.json  versions/

cat /omnifs/arxiv/papers/1706.03762/metadata.json | jq .title
# "Attention Is All You Need"

ls /omnifs/arxiv/categories/cs.LG/new
ls /omnifs/arxiv/search/diffusion+transformer

Linear

Mount root: /linear

Requires: LINEAR_TOKEN (personal access token from Linear settings).

Operation	Path	Type
List teams	`/linear/teams`	`ls`
List open issues	`/linear/teams/{KEY}/issues/_open`	`ls`
List all issues	`/linear/teams/{KEY}/issues/_all`	`ls`
Issue title	`/linear/teams/{KEY}/issues/{filter}/{KEY-N}/title`	`cat`
Issue state	`/linear/teams/{KEY}/issues/{filter}/{KEY-N}/state`	`cat`
Issue priority	`/linear/teams/{KEY}/issues/{filter}/{KEY-N}/priority`	`cat`
Issue assignee	`/linear/teams/{KEY}/issues/{filter}/{KEY-N}/assignee`	`cat`
Issue description	`/linear/teams/{KEY}/issues/{filter}/{KEY-N}/description.md`	`cat`

{KEY} is the team identifier (e.g. ENG, PLAT). {KEY-N} is the full issue identifier (e.g. ENG-1421). {filter} matches the listing directory name (_open, _all).

ls /omnifs/linear/teams
ls /omnifs/linear/teams/ENG/issues/_open
# ENG-1387  ENG-1412  ENG-1421  ENG-1438

cat /omnifs/linear/teams/ENG/issues/_open/ENG-1421/state
# In Progress

cat /omnifs/linear/teams/ENG/issues/_open/ENG-1421/description.md

DNS

Mount root: /dns

No credentials required. Cloudflare and Google DoH resolvers are preconfigured. Set resolver to change the default, or scope per query with the @{resolver} segment.

Operation	Path	Type
List available record types	`/dns/{name}`	`ls`
Single record type	`/dns/{name}/{type}`	`cat`
All records	`/dns/{name}/_all`	`cat`
Raw DNS response	`/dns/{name}/_raw`	`cat`
Query via specific resolver	`/dns/@{resolver}/{name}/{type}`	`cat`
Reverse PTR lookup	`/dns/_reverse/{ip}/PTR`	`cat`

{name} is any DNS name (e.g. example.com, _dmarc.example.com). {type} is an uppercase record type: A, AAAA, MX, NS, TXT, CNAME, SOA, SRV, PTR. {resolver} is a named resolver (e.g. cloudflare, google). {ip} is a dotted-decimal IPv4 address.

ls /omnifs/dns/example.com
# A  AAAA  MX  NS  TXT  CNAME  SOA  SRV  _all  _raw

cat /omnifs/dns/example.com/MX
# 10 mail.example.com.
# 20 mail2.example.com.

cat /omnifs/dns/example.com/TXT
cat /omnifs/dns/@google/example.com/A
cat /omnifs/dns/_reverse/93.184.216.34/PTR

WIP providers

The following providers are under active development. Their path schemes exist in the codebase but are not yet stable and may change without notice. Do not build tooling against them.

huggingface, kubernetes, postgres, slack, redis, s3, stripe, cloudflare, vercel, oci, mcp, spotify, discord