velocirepo

velocirepo tracks your open-source project’s pulse across package registries, GitHub, and the web — collecting daily metrics from GitHub, PyPI, CRAN, Homebrew, Plausible, OpenVSX, and YouTube.

velocirepo [OPTIONS] COMMAND [ARGS]...

Full --help output

velocirepo tracks your open-source project's pulse across package registries, GitHub, and the web — collecting daily metrics from GitHub, PyPI, CRAN, Homebrew, Plausible, OpenVSX, and YouTube.

Usage:
  velocirepo [command]

Fetching:
  download-archive  Download archived runs from the data repository's releases, for replay
  fetch             Fetch from all configured sources
  fetch-cran        Fetch CRAN download statistics
  fetch-github      Fetch GitHub events (forks, issues, PRs, comments) and stars
  fetch-homebrew    Fetch Homebrew install counts
  fetch-linkedin    Fetch LinkedIn post metrics and content
  fetch-openvsx     Fetch Open VSX extension metrics
  fetch-plausible   Fetch Plausible analytics (pageviews, visitors, visits)
  fetch-pypi        Fetch PyPI download statistics
  fetch-rss         Fetch items from RSS or Atom feeds as content entries
  fetch-traffic     Fetch GitHub traffic data (views and clones)
  fetch-youtube     Fetch YouTube metrics (views, likes, comments, subscribers)
  replay            Rebuild the records of archived runs from their responses

Querying:
  export            Export data to Parquet, CSV or a standalone DuckDB database
  query             Run a SQL query against the metrics data
  schema            Show table schemas
  show-indicators   Print indicator definitions as TOML

Badges:
  badge             Generate SVG badges from metrics

Views:
  add-view          Scaffold a new view directory
  list-views        List all views
  remove-view       Remove a view directory
  render-view       Render a view or all views in a directory
  render-views      Render all or filtered views
  serve-view        Start a dev server for a view
  setup-views       Install dependencies for all views
  show-view         Show details about a view

Projects:
  add-project       Add a new project to the config
  import-projects   Bulk-add projects from an external source
  init              Create a new velocirepo.toml config file
  list-projects     List all configured projects
  remove-project    Remove a project from the config
  rename-project    Rename a project's ID
  show-project      Show detailed information about a project
  status            Summarize fetch state for each project, source, and target
  update-project    Update a project's configuration
  validate-projects Verify that configured sources are reachable

CI/CD:
  check-heartbeat   Check that the nightly workflow ran, and report it when it didn't
  digest            Post a weekly digest of the data on its own issue
  gate              Run the nightly fetch so that it only adds data
  install-ci        Generate GitHub Actions workflows for the nightly run and its heartbeat
  sync-secrets      Sync .env secrets to GitHub Actions repository secrets
  upload-archive    Store archived runs as release assets of the data repository

Data:
  build-db          Build the DuckDB database file for external tools
  check             Check stored data and a fetch run for problems
  migrate           Migrate data to the latest schema version
  validate-data     Check data files for integrity issues

Additional Commands:
  auth              Authenticate with an OAuth provider
  completion        Generate the autocompletion script for the specified shell
  help              Help about any command
  mcp               Start the MCP (Model Context Protocol) server
  update            Update velocirepo to the latest release
  version           Print the version

Flags:
      --config string   config file (default: walk up for velocirepo.toml)
  -h, --help            help for velocirepo
  -q, --quiet           suppress progress output
  -v, --verbose         enable debug logging

Use "velocirepo [command] --help" for more information about a command.

Options

--config: string = walk up for velocirepo.toml: config file
-h, --help: help for velocirepo
-q, --quiet: suppress progress output
-v, --verbose: enable debug logging

Commands

download-archive: Download archived runs from the data repository’s releases, for replay
fetch: Fetch from all configured sources
fetch-cran: Fetch CRAN download statistics
fetch-github: Fetch GitHub events (forks, issues, PRs, comments) and stars
fetch-homebrew: Fetch Homebrew install counts
fetch-linkedin: Fetch LinkedIn post metrics and content
fetch-openvsx: Fetch Open VSX extension metrics
fetch-plausible: Fetch Plausible analytics (pageviews, visitors, visits)
fetch-pypi: Fetch PyPI download statistics
fetch-rss: Fetch items from RSS or Atom feeds as content entries
fetch-traffic: Fetch GitHub traffic data (views and clones)
fetch-youtube: Fetch YouTube metrics (views, likes, comments, subscribers)
replay: Rebuild the records of archived runs: each job runs again with the options in the run’s manifest, against the archived responses instead of the…
export: Export the data as plain tables to the given directory: one file per table for parquet and csv, or one database file (velocirepo.duckdb) for duckdb
query: Run a SQL query against the metrics data
schema: Show table schemas
show-indicators: Print indicator definitions as TOML
badge: Generate shields.io-style SVG badges
add-view: Create a new view directory with render.sh and template files
list-views: List all views
remove-view: Remove a view directory
render-view: Render a view or all views in a directory
render-views: Render all or filtered views
serve-view: Start the view’s serve.sh script for live development
setup-views: Run uv sync for Python views
show-view: Show details about a view
add-project: Add a new project to the config
import-projects: Bulk-add projects from an external source
init: Create a new velocirepo.toml config file
list-projects: List all configured projects
remove-project: Remove a project from the config
rename-project: Rename a project’s ID
show-project: Show detailed information about a project
status: Report the last date each source/target was successfully fetched, using watermarks so unchanged total_* gauges are not misreported as stale
update-project: Update a project’s configuration
validate-projects: Verify that configured sources are reachable
check-heartbeat: Check with GitHub’s Actions API that the nightly workflow started its scheduled run since it was last due; a run in progress counts, manual runs don’t
digest: Render a sparkline per source and project over the last 8 weeks, with the week’s findings, and post it as a comment on the long-lived “Weekly digest”…
gate: Run the nightly fetch in GitHub Actions: check the commits made since the last run, fetch, check the night’s changes, commit the data, concatenate on…
install-ci: Generate GitHub Actions workflows for the nightly run and its heartbeat
sync-secrets: Reads secrets from the .env file and sets them as GitHub Actions secrets using the GitHub API
upload-archive: Store archived runs as assets of the data repository’s monthly raw-YYYY-MM release, a pre-release that’s never the latest release
build-db: Build the DuckDB database file for external tools
check: Run velocirepo’s checks and report their findings
migrate: Migrate data to the latest schema version
validate-data: Check data files for integrity issues
auth: Authenticate with an OAuth provider
mcp: Start an MCP server that exposes velocirepo’s functionality to AI assistants
update: Update velocirepo to the latest release
version: Print the version