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
- 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
- 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