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:
  fetch             Fetch from all configured sources
  fetch-cran        Fetch CRAN download statistics
  fetch-github      Fetch GitHub events (stars, forks, issues, PRs)
  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)

Querying:
  export            Export data to Parquet or CSV files
  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:
  install-ci        Generate GitHub Actions workflow for nightly metric fetching
  sync-secrets      Sync .env secrets to GitHub Actions repository secrets

Data:
  build-db          Build the DuckDB database file for external tools
  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

fetch: Fetch from all configured sources
fetch-cran: Fetch CRAN download statistics
fetch-github: Fetch GitHub events (stars, forks, issues, PRs)
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)
export: Export metrics, events, and projects to separate files in the given directory
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
install-ci: Generate GitHub Actions workflow for nightly metric fetching
sync-secrets: Reads secrets from the .env file and sets them as GitHub Actions secrets using the GitHub API
build-db: Build the DuckDB database file for external tools
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