{"id":15032833,"url":"https://github.com/verygoodopensource/very_good_cli","last_synced_at":"2026-04-01T17:25:42.558Z","repository":{"id":37081931,"uuid":"334282617","full_name":"VeryGoodOpenSource/very_good_cli","owner":"VeryGoodOpenSource","description":"A Very Good Command-Line Interface for Dart created by Very Good Ventures 🦄","archived":false,"fork":false,"pushed_at":"2024-12-23T14:16:24.000Z","size":26901,"stargazers_count":2205,"open_issues_count":47,"forks_count":198,"subscribers_count":45,"default_branch":"main","last_synced_at":"2024-12-24T22:33:11.493Z","etag":null,"topics":["cli","dart","dart-library","dart-package","flutter","flutter-package"],"latest_commit_sha":null,"homepage":"http://cli.vgv.dev","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VeryGoodOpenSource.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-29T23:01:39.000Z","updated_at":"2024-12-24T00:11:07.000Z","dependencies_parsed_at":"2023-12-06T16:26:39.819Z","dependency_job_id":"57de7d69-fb5d-4f07-8efe-9e2136e381d5","html_url":"https://github.com/VeryGoodOpenSource/very_good_cli","commit_stats":{"total_commits":658,"total_committers":31,"mean_commits":"21.225806451612904","dds":0.5653495440729484,"last_synced_commit":"472c0e68537b535881c2797fb17045ea3b934a46"},"previous_names":[],"tags_count":107,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeryGoodOpenSource%2Fvery_good_cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeryGoodOpenSource%2Fvery_good_cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeryGoodOpenSource%2Fvery_good_cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeryGoodOpenSource%2Fvery_good_cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VeryGoodOpenSource","download_url":"https://codeload.github.com/VeryGoodOpenSource/very_good_cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248225333,"owners_count":21068076,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","dart","dart-library","dart-package","flutter","flutter-package"],"created_at":"2024-09-24T20:19:33.013Z","updated_at":"2026-04-01T17:25:42.541Z","avatar_url":"https://github.com/VeryGoodOpenSource.png","language":"Dart","readme":"[\u003cimg src=\"https://raw.githubusercontent.com/VeryGoodOpenSource/very_good_cli/main/site/static/img/cli_icon.svg\" align=\"left\" /\u003e](https://cli.vgv.dev/)\n\n### Very Good CLI\n\n\u003cbr clear=\"left\"/\u003e\n\n[![ci][ci_badge]][ci_link]\n[![coverage][coverage_badge]][ci_link]\n[![pub package][pub_badge]][pub_link]\n[![style: very good analysis][very_good_analysis_badge]][very_good_analysis_link]\n[![License: MIT][license_badge]][license_link]\n\n---\n\nA Very Good Command-Line Interface for Dart.\n\nDeveloped with 💙 by [Very Good Ventures][very_good_ventures_link] 🦄\n\n## Documentation 📝\n\nFor official documentation, please visit https://cli.vgv.dev.\n\n## Quick Start 🚀\n\n### Installing 🧑‍💻\n\n```sh\ndart pub global activate very_good_cli\n```\n\nOr install a [specific version](https://pub.dev/packages/very_good_cli/versions) using:\n\n```sh\ndart pub global activate very_good_cli \u003cversion\u003e\n```\n\nIf you haven't already, you might need to [set up your path][path_setup_link].\n\nWhen that is not possible (eg: CI environments), run `very_good` commands via:\n\n```sh\ndart pub global run very_good_cli:very_good \u003ccommand\u003e \u003cargs\u003e\n```\n\n### Commands ✨\n\n### [`very_good create`](https://cli.vgv.dev/docs/category/templates)\n\nCreate a very good project in seconds based on the provided template. Each template has a corresponding sub-command (e.g.,`very_good create flutter_app` will generate a Flutter starter app).\n\n![Very Good Create][very_good_create]\n\n```sh\nCreates a new very good project in the specified directory.\n\nUsage: very_good create \u003csubcommand\u003e \u003cproject-name\u003e [arguments]\n-h, --help    Print this usage information.\n\nAvailable subcommands:\n  app_ui_package    Generate a Very Good App UI package.\n  dart_cli          Generate a Very Good Dart CLI application.\n  dart_package      Generate a Very Good Dart package.\n  docs_site         Generate a Very Good documentation site.\n  flame_game        Generate a Very Good Flame game.\n  flutter_app       Generate a Very Good Flutter application.\n  flutter_package   Generate a Very Good Flutter package.\n  flutter_plugin    Generate a Very Good Flutter plugin.\n\nRun \"very_good help\" to see global options.\n```\n\n#### Usage\n\n```sh\n# Create a new Flutter app named my_app\nvery_good create flutter_app my_app\n\n# Create a new Flutter app named my_app with a custom org\nvery_good create flutter_app my_app --desc \"My new Flutter app\" --org \"com.custom.org\"\n\n# Create a new Flutter app named my_app with a custom application id\nvery_good create flutter_app my_app --desc \"My new Flutter app\" --application-id \"com.custom.app.id\"\n\n# Create a new App UI package named my_app_ui_package\nvery_good create app_ui_package my_app_ui_package --desc \"My new App UI package\"\n\n# Create a new Flame game named my_game\nvery_good create flame_game my_game --desc \"My new Flame game\"\n\n# Create a new Flutter package named my_flutter_package\nvery_good create flutter_package my_flutter_package --desc \"My new Flutter package\"\n\n# Create a new Dart package named my_dart_package\nvery_good create dart_package my_dart_package --desc \"My new Dart package\"\n\n# Create a new Dart package named my_dart_package that is publishable\nvery_good create dart_package my_dart_package --desc \"My new Dart package\" --publishable\n\n# Create a new Dart CLI application named my_dart_cli\nvery_good create dart_cli my_dart_cli --desc \"My new Dart CLI package\"\n\n# Create a new Dart CLI application named my_dart_cli with a custom executable name\nvery_good create dart_cli my_dart_cli --desc \"My new Dart CLI package\" --executable-name my_executable_name\n\n# Create a new Flutter plugin named my_flutter_plugin (all platforms enabled)\nvery_good create flutter_plugin my_flutter_plugin --desc \"My new Flutter plugin\"\n\n# Create a new Flutter plugin named my_flutter_plugin (some platforms only)\nvery_good create flutter_plugin my_flutter_plugin --desc \"My new Flutter plugin\" --platforms android,ios,macos\n\n# Create a new docs site named my_docs_site\nvery_good create docs_site my_docs_site\n\n```\n\n---\n\n### [`very_good test`](https://cli.vgv.dev/docs/commands/test)\n\nRun tests in a Dart or Flutter project.\n\n```sh\n# Run all tests\nvery_good test\n\n# Run all tests and collect coverage\nvery_good test --coverage\n\n# Run all tests and enforce 100% coverage\nvery_good test --coverage --min-coverage 100\n\n# Run only tests in ./some/other/directory\nvery_good test ./some/other/directory\n\n# Run tests recursively\nvery_good test --recursive\n\n# Run tests recursively (shorthand)\nvery_good test -r\n\n# Run tests on a specific platform\nvery_good test --platform chrome\n```\n\n### [`very_good packages get`](https://cli.vgv.dev/docs/commands/get_pkgs)\n\nGet packages in a Dart or Flutter project.\n\n```sh\n# Install packages in the current directory\nvery_good packages get\n\n# Install packages in ./some/other/directory\nvery_good packages get ./some/other/directory\n\n# Install packages recursively\nvery_good packages get --recursive\n\n# Install packages recursively (shorthand)\nvery_good packages get -r\n```\n\n### [`very_good packages check licenses`](https://cli.vgv.dev/docs/commands/check_licenses)\n\nCheck packages' licenses in a Dart or Flutter project.\n\n```sh\n# Check licenses in the current directory\nvery_good packages check licenses\n\n# Only allow the use of certain licenses\nvery_good packages check licenses --allowed=\"MIT,BSD-3-Clause,BSD-2-Clause,Apache-2.0\"\n\n# Deny the use of certain licenses\nvery_good packages check licenses --forbidden=\"unknown\"\n\n# Check licenses for certain dependencies types\nvery_good packages check licenses --dependency-type=\"direct-main,transitive\"\n\n# Check and list licenses in the current directory\nvery_good packages check licenses --reporter=\"csv\"\n```\n\n### [`very_good mcp`](https://cli.vgv.dev/docs/commands/mcp)\n\nStart the MCP (Model Context Protocol) server for AI assistant integration.\n\n\u003e ℹ️ **Experimental**  \n\u003e This command relies on the [Dart MCP Server](https://docs.flutter.dev/ai/mcp-server). This is an experimental package and may change or become unstable without notice. Use it with caution at your own risk.\n\n```sh\n# Start the MCP server\nvery_good mcp\n```\n\nThe MCP server exposes Very Good CLI functionality through the Model Context Protocol, allowing AI assistants to interact with the CLI programmatically. This enables automated project creation, testing, and package management through MCP-compatible tools.\n\n**Available MCP Tools:**\n\n- `create`: Create new Dart/Flutter projects (https://cli.vgv.dev/docs/category/templates)\n- `tests`: Run tests with optional coverage and optimization (https://cli.vgv.dev/docs/commands/test)\n- `packages_check_licenses`: Check packages for issues and licenses (https://cli.vgv.dev/docs/commands/check_licenses)\n- `packages_get`: Get package information and dependencies (https://cli.vgv.dev/docs/commands/get_pkgs)\n\n### [`very_good --help`](https://cli.vgv.dev/docs/overview)\n\nSee the complete list of commands and usage information.\n\n```sh\n🦄 A Very Good Command-Line Interface\n\nUsage: very_good \u003ccommand\u003e [arguments]\n\nGlobal options:\n-h, --help            Print this usage information.\n    --version         Print the current version.\n    --[no-]verbose    Noisy logging, including all shell commands executed.\n\nAvailable commands:\n  create     very_good create \u003csubcommand\u003e \u003cproject-name\u003e [arguments]\n             Creates a new very good project in the specified directory.\n  mcp        Start the MCP (Model Context Protocol) server. WARNING: This is an experimental package and may change or become unstable without notice. Use it with caution at your own risk.\n  packages   Command for managing packages.\n  test       Run tests in a Dart or Flutter project.\n  update     Update Very Good CLI.\n\nRun \"very_good help \u003ccommand\u003e\" for more information about a command.\n```\n\n[bloc_link]: https://bloclibrary.dev\n[ci_badge]: https://github.com/VeryGoodOpenSource/very_good_cli/workflows/very_good_cli/badge.svg\n[ci_link]: https://github.com/VeryGoodOpenSource/very_good_cli/actions\n[coverage_badge]: https://raw.githubusercontent.com/VeryGoodOpenSource/very_good_cli/main/coverage_badge.svg\n[flutter_cross_platform_link]: https://flutter.dev/docs/development/tools/sdk/release-notes/supported-platforms\n[flutter_flavors_link]: https://flutter.dev/docs/deployment/flavors\n[github_actions_link]: https://github.com/features/actions\n[internationalization_link]: https://flutter.dev/docs/development/accessibility-and-localization/internationalization\n[license_badge]: https://img.shields.io/badge/license-MIT-blue.svg\n[license_link]: https://opensource.org/licenses/MIT\n[cli_logo_icon]: https://raw.githubusercontent.com/VeryGoodOpenSource/very_good_cli/main/site/static/img/cli_icon.svg\n[logging_link]: https://api.flutter.dev/flutter/dart-developer/log.html\n[null_safety_link]: https://flutter.dev/docs/null-safety\n[pub_badge]: https://img.shields.io/pub/v/very_good_cli.svg\n[pub_link]: https://pub.dev/packages/very_good_cli\n[testing_link]: https://flutter.dev/docs/testing\n[very_good_analysis_badge]: https://img.shields.io/badge/style-very_good_analysis-B22C89.svg\n[very_good_analysis_link]: https://pub.dev/packages/very_good_analysis\n[very_good_core_link]: site/docs/templates/core.md\n[new_syntax_link]: site/docs/resources/syntax_changes_in_0_10_0.md\n[very_good_create]: https://raw.githubusercontent.com/VeryGoodOpenSource/very_good_cli/main/doc/assets/very_good_create.gif\n[very_good_ventures_link]: https://verygood.ventures\n[path_setup_link]: https://dart.dev/tools/pub/cmd/pub-global#running-a-script-from-your-path\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverygoodopensource%2Fvery_good_cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fverygoodopensource%2Fvery_good_cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fverygoodopensource%2Fvery_good_cli/lists"}