CLI Reference
- velocirepo
- velocirepo tracks your open-source project’s pulse across package registries, GitHub, and the web — collecting daily metrics from GitHub, PyPI, CRAN,…
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
- mcp
- Start an MCP server that exposes velocirepo’s functionality to AI assistants
- update
- Update velocirepo to the latest release
- version
- Print the version
auth
Authenticate with an OAuth provider