# 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. ``` bash 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](../../reference/cli/fetch.md) `fetch-cran` [Fetch CRAN download statistics](../../reference/cli/fetch_cran.md) `fetch-github` [Fetch GitHub events (stars, forks, issues, PRs)](../../reference/cli/fetch_github.md) `fetch-homebrew` [Fetch Homebrew install counts](../../reference/cli/fetch_homebrew.md) `fetch-linkedin` [Fetch LinkedIn post metrics and content](../../reference/cli/fetch_linkedin.md) `fetch-openvsx` [Fetch Open VSX extension metrics](../../reference/cli/fetch_openvsx.md) `fetch-plausible` [Fetch Plausible analytics (pageviews, visitors, visits)](../../reference/cli/fetch_plausible.md) `fetch-pypi` [Fetch PyPI download statistics](../../reference/cli/fetch_pypi.md) `fetch-rss` [Fetch items from RSS or Atom feeds as content entries](../../reference/cli/fetch_rss.md) `fetch-traffic` [Fetch GitHub traffic data (views and clones)](../../reference/cli/fetch_traffic.md) `fetch-youtube` [Fetch YouTube metrics (views, likes, comments, subscribers)](../../reference/cli/fetch_youtube.md) `export` [Export metrics, events, and projects to separate files in the given directory](../../reference/cli/export.md) `query` [Run a SQL query against the metrics data](../../reference/cli/query.md) `schema` [Show table schemas](../../reference/cli/schema.md) `show-indicators` [Print indicator definitions as TOML](../../reference/cli/show_indicators.md) `badge` [Generate shields.io-style SVG badges](../../reference/cli/badge.md) `add-view` [Create a new view directory with render.sh and template files](../../reference/cli/add_view.md) `list-views` [List all views](../../reference/cli/list_views.md) `remove-view` [Remove a view directory](../../reference/cli/remove_view.md) `render-view` [Render a view or all views in a directory](../../reference/cli/render_view.md) `render-views` [Render all or filtered views](../../reference/cli/render_views.md) `serve-view` [Start the view's serve.sh script for live development](../../reference/cli/serve_view.md) `setup-views` [Run uv sync for Python views](../../reference/cli/setup_views.md) `show-view` [Show details about a view](../../reference/cli/show_view.md) `add-project` [Add a new project to the config](../../reference/cli/add_project.md) `import-projects` [Bulk-add projects from an external source](../../reference/cli/import_projects.md) `init` [Create a new velocirepo.toml config file](../../reference/cli/init.md) `list-projects` [List all configured projects](../../reference/cli/list_projects.md) `remove-project` [Remove a project from the config](../../reference/cli/remove_project.md) `rename-project` [Rename a project's ID](../../reference/cli/rename_project.md) `show-project` [Show detailed information about a project](../../reference/cli/show_project.md) `status` [Report the last date each source/target was successfully fetched, using watermarks so unchanged total\_\* gauges are not misreported as stale](../../reference/cli/status.md) `update-project` [Update a project's configuration](../../reference/cli/update_project.md) `validate-projects` [Verify that configured sources are reachable](../../reference/cli/validate_projects.md) `install-ci` [Generate GitHub Actions workflow for nightly metric fetching](../../reference/cli/install_ci.md) `sync-secrets` [Reads secrets from the .env file and sets them as GitHub Actions secrets using the GitHub API](../../reference/cli/sync_secrets.md) `build-db` [Build the DuckDB database file for external tools](../../reference/cli/build_db.md) `migrate` [Migrate data to the latest schema version](../../reference/cli/migrate.md) `validate-data` [Check data files for integrity issues](../../reference/cli/validate_data.md) `auth` [Authenticate with an OAuth provider](../../reference/cli/auth.md) `mcp` [Start an MCP server that exposes velocirepo's functionality to AI assistants](../../reference/cli/mcp.md) `update` [Update velocirepo to the latest release](../../reference/cli/update.md) `version` [Print the version](../../reference/cli/version.md)