Admin Dashboard
Vein serves a web dashboard - package catalog, quarantine review, SBOM inspection - on its own listener next to the proxy, built in with the admin Cargo feature (on by default).
Running it
Section titled “Running it”vein serve --config vein.toml starts it alongside the proxy whenever [admin] enabled is true (the default):
[admin]enabled = truehost = "127.0.0.1" # default; anything else needs trusted_networks or a tokenport = 9400 # defaultBrowse to http://127.0.0.1:9400.
Catalog
Section titled “Catalog”RubyGems names and the gems cached here, with their versions and platforms - needs the gems Cargo feature. crates.io and npm are planned to follow.
Quarantine review
Section titled “Quarantine review”/quarantine shows quarantine stats and lets you approve or block versions without touching the CLI. See Quarantine for the policy this controls.
CycloneDX SBOM access
Section titled “CycloneDX SBOM access”Scope today: SBOMs are generated for cached RubyGems. The roadmap extends generation to crates.io and npm.
-
Admin dashboard: browse to
http://127.0.0.1:9400/catalog/<gem>?version=<version>to preview the generated SBOM and download the JSON. -
Proxy endpoint: fetch it directly from the running proxy without the admin UI:
GET /.well-known/vein/sbom?name=<gem>&version=<version>[&platform=<platform>]Returns a CycloneDX 1.5 document (
Content-Type: application/json) with a download-friendly filename. Omitplatformfor the defaultrubybuild; supply it for native variants (e.g.arm64-darwin).
SBOMs are generated automatically the first time a gem is cached, and refreshed whenever the gem is re-fetched.
The same listener mounts /mcp for coding agents - resources over the cache, plus code-context tools when configured. See MCP for the full reference, including the access model for a non-loopback bind.