{"id":13787492,"url":"https://github.com/HubSpot/hubspot-cli","last_synced_at":"2025-05-12T00:31:06.170Z","repository":{"id":37078159,"uuid":"215885888","full_name":"HubSpot/hubspot-cli","owner":"HubSpot","description":"A CLI for HubSpot","archived":false,"fork":false,"pushed_at":"2025-05-08T18:47:23.000Z","size":12005,"stargazers_count":161,"open_issues_count":50,"forks_count":63,"subscribers_count":136,"default_branch":"main","last_synced_at":"2025-05-08T19:38:31.806Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://developers.hubspot.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HubSpot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"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,"zenodo":null}},"created_at":"2019-10-17T21:08:00.000Z","updated_at":"2025-05-07T20:20:54.000Z","dependencies_parsed_at":"2023-12-13T20:45:59.250Z","dependency_job_id":"caa34744-503f-4c87-b50f-6ec102bda29a","html_url":"https://github.com/HubSpot/hubspot-cli","commit_stats":{"total_commits":3710,"total_committers":55,"mean_commits":67.45454545454545,"dds":0.7495956873315364,"last_synced_commit":"63787ff3afa816c04e08459ef3a192740bc5ea2f"},"previous_names":["hubspot/hubspot-cms-tools"],"tags_count":360,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fhubspot-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fhubspot-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fhubspot-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HubSpot%2Fhubspot-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HubSpot","download_url":"https://codeload.github.com/HubSpot/hubspot-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253655813,"owners_count":21943069,"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":[],"created_at":"2024-08-03T20:00:36.687Z","updated_at":"2025-05-12T00:31:06.153Z","avatar_url":"https://github.com/HubSpot.png","language":"TypeScript","funding_links":[],"categories":["Resources","TypeScript"],"sub_categories":[],"readme":"# @hubspot/cli\n\n[![Official Release](https://img.shields.io/npm/v/@hubspot/cli/latest?label=Official%20Release)](https://www.npmjs.com/package/@hubspot/cli) [![Latest Beta Version](https://img.shields.io/npm/v/@hubspot/cli/next?label=Latest%20Beta%20Version)](https://www.npmjs.com/package/@hubspot/cli?activeTab=versions)\n\nA CLI for HubSpot developers to enable local development and automation. [Learn more about building on HubSpot](https://developers.hubspot.com).\n\n## Contributing\n\nFor more information on developing, see the [Contributing Guide](CONTRIBUTING.md).\n\n## Getting started\n\nFor more information on using these tools, see [Local Development Tooling: Getting Started](https://developers.hubspot.com/docs/cms/guides/getting-started-with-local-development)\n\n### Installation\n\n```bash\nnpm install -g @hubspot/cli\n```\n\n### Configuring\n\nOnce the `@hubspot/cli` has been added to a project, a config file named [hubspot.config.yml](../../docs/HubspotConfigFile.md) will also be needed. It is recommended that the config file is kept in your `$HOME` directory.\n\n```bash\ncd ~\nhs init\n```\n\n#### Auto Completion\n\nYou can set up command autocompletion by running\n\n```bash\nhs completion\n```\n\nand copying the output to either your `.bashrc` or `.zshrc`, and then sourcing that file `source ~/.bashrc` `source ~/.zshrc` or restarting your terminal.\n\n## Commands\n\nA full breakdown of the commands can be found on the [local development tools reference page](https://developers.hubspot.com/docs/cms/developer-reference/local-development-cli).\n\n**Note:** When `@hubspot/cli` is installed local to a project, the commands need to be prefixed with either `yarn` if using `yarn` or `npx` if using `npm`.\n\n## Authentication\n\nThere are two ways that the tools can authenticate with HubSpot.\n\n### Personal Access Key (recommended)\n\n1. Run `hs init` or `hs auth personalaccesskey` and follow the instructions\n\n### OAuth2\n\n1. [Create a developer app](https://developers.hubspot.com/docs/faq/how-do-i-create-an-app-in-hubspot)\n2. Run `hs auth oauth2`\n3. Select `OAuth2` and follow the steps\n\n_**Note:** The Account ID used should be the Test Account ID (not the developer app ID). Client ID and Client Secret are from the developer app._\n\n### Exit Codes\n\nThe CLI will exit with one of the following exit codes:\n\n- `0`: A successful run\n- `1`: There was a config problem or an internal error\n- `2`: There are warnings or validation issues\n\n## Changelog\n\nThe best way to stay up to date is to check out the [Github Releases](https://github.com/HubSpot/hubspot-cli/releases) and also follow our [developer changelog posts](https://developers.hubspot.com/changelog) for an easier to read breakdown of major changes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHubSpot%2Fhubspot-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHubSpot%2Fhubspot-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHubSpot%2Fhubspot-cli/lists"}