Skip to content

Releases: HubSpot/hubspot-cli

v8.1.0

04 Mar 15:18
203e1ec

Choose a tag to compare

What's Changed

Full Changelog: v8.0.0...v8.1.0

New Features

  • Platform version validation: Added max supported platform version checking to help users identify when their CLI needs updating. When working with newer platform versions, the CLI now warns users and suggests upgrading.
  • Account authentication in “use” flow: The hs account use command now supports authenticating new accounts directly during the account selection process, streamlining the workflow when switching to unauthenticated accounts.
  • Remove beta label from MCP features: Removed beta tags from Model Context Protocol help text, indicating the feature is now production-ready.

Bug Fixes

  • Project logs for v2 projects: Fixed hs project logs functionality for v2 projects running on platform version 2025.2 and later.
  • Profile variable type handling: Corrected an issue where profile variables were being injected as strings regardless of their actual type, ensuring proper type preservation.
  • MCP setup error messages: Improved error messages in hs mcp setup to provide clearer guidance when tools aren't installed properly.
  • Template source messaging: Fixed misleading messaging around template source selection to better guide users.
  • Node 20.11.0 compatibility: Pinned eslint-visitor-keys to version 4.2.0 to ensure compatibility with Node 20.11.0.

Improvements and Refactoring

  • Project upload error handling: Enhanced error messages when project uploads fail, providing more actionable feedback to users.
  • Marketplace validation refactoring: Removed direct process.exit() calls from marketplace validation utilities, improving testability and error handling patterns.
  • Dev server updates: Updated cms-dev-server to 1.2.16 and ui-extensions-dev-server to 1.1.8, bringing in the latest improvements for local development.

v8.0.0

11 Feb 15:50
0bd2ad1

Choose a tag to compare

What's Changed

Full Changelog: v7.11.2...v8.0.0

Breaking Changes

Deprecated commands removed in favor of newer versions

  • hs create -> hs cms app|theme|module|webpack|function|template create
  • hs fetch -> hs cms fetch
  • hs function deploy -> hs cms function deploy
  • hs function list -> hs cms function list
  • hs function server -> hs cms function server
  • hs lint -> hs cms lint
  • hs list -> hs cms list
  • hs logs -> hs cms function logs
  • hs module marketplace-validate -> hs cms module marketplace-validate
  • hs mv -> hs cms mv
  • hs remove -> hs cms delete
  • hs theme generate-selectors -> hs cms theme generate-selectors
  • hs theme marketplace-validate -> hs cms theme marketplace-validate
  • hs theme preview -> hs cms theme preview
  • hs upload -> hs cms upload
  • hs watch -> hs cms watch
  • hs custom-object schema create -> hs custom-object create-schema
  • hs custom-object schema delete -> hs custom-object delete-schema
  • hs custom-object schema fetch-all -> hs custom-object fetch-all-schemas
  • hs custom-object schema fetch -> hs custom-object fetch-schema
  • hs custom-object schema list -> hs custom-object list-schemas
  • hs custom object schema update -> hs custom-object update-schema
  • hs project migrate-app -> hs app migrate

Deprecated commands removed

  • hs project clone-app

https://developers.hubspot.com/changelog/introducing-hubspot-cli-v8.0.0

Other breaking changes

  • Support for HUBSPOT_PORTAL_ID environment variable removed. Use HUBSPOT_ACCOUNT_ID instead
  • Minimum version of node is being bumped to 20
  • Legacy behavior for hs theme preview on node versions lower than 20 has been removed

Bug Fixes

  • Fix a bug where versions of the CLI > 7.9.0 did not work with the --use-env flag set

v7.11.2

23 Dec 17:55
123b7bd

Choose a tag to compare

What's Changed

Full Changelog: 7.11.1...v7.11.2\

Breaking Changes

  • None

New Features

  • None

Bug Fixes

  • Fixed bin file extension issue on Node.js 20.9 by adding .js extension to hs and hscms bin files
    Fixed issue with the --use-env flag that was causing commands to fail

Improvements and Refactoring

  • Bumped @hubspot/local-dev-lib dependency from 4.0.3 to 4.0.4
  • Refactored environment variable usage to use constants from @hubspot/local-dev-lib/constants/config instead of hardcoded strings for better maintainability
  • Updated git middleware to skip git inclusion checks when using environment config

v7.11.1

22 Dec 21:46
94bc801

Choose a tag to compare

What's Changed

Full Changelog: v7.10.0...7.11.1

Breaking Changes

  • None - This release maintains backward compatibility with existing workflows and configurations.

New Features

  • Added hs project lint command to lint HubSpot projects with ESLint, including automatic dependency installation and configuration setup
  • Added MCP tool GetBuildStatusTool to retrieve build status and error messages for HubSpot projects
  • Added MCP tool GetBuildLogsTool to fetch build logs from Blazar build server
  • Improved hs project create and hs project add UX with loading indicators and enhanced visual feedback
  • Added account ID display in hs account list output
  • Automatically set newly authenticated accounts as default when no other accounts are configured.

Bug Fixes

  • Fixed update notification to correctly detect globally installed CLI instances
  • Fixed debug output for HTTP error causes
  • Fixed bug with 2025.1 platform version in hs project deploy
  • Fixed legacy add command to use project name correctly
  • Fixed error handling in port manager server during hs project dev to prevent crashes from unhandled exceptions
  • Bug fix for hs project migrate for projects that use “.” as the “srcDir”
  • Adding the missing hs cms module marketplace-validate command

Improvements and Refactoring

  • Replaced Boxen with React Ink boxes for improved terminal UI rendering in project migrate, fire alarms, auto-update, and project - create/add flows
  • Refactored config system to support new config format with migration tooling (hs config migrate)
  • Bumped UI Extensions dev server to version 1.0.1
  • Updated CMS dev server packages to latest versions
  • Bumped Local Dev Library (LDL) to latest version
  • Added centered text support in status message UI boxes
  • Improved MCP tool handling for absolute current working directory paths
  • Enhanced error handling and logging throughout the codebase
  • Improved local config file handling in MCP tools
  • Bump MCP SDK version to 1.25.0 to remove vulnerability issues

v7.10.0

26 Nov 22:39
bf262b5

Choose a tag to compare

What's Changed

Full Changelog: v7.9.0...v7.10.0

Breaking Changes

  • None - This release maintains backward compatibility with existing workflows and configurations.

New Features

  • Add hs project update-deps command: New command that operates similarly to hs project install-deps but runs npm update instead of npm install to update existing dependencies in project components
  • Add codex to hs mcp setup: Enhanced MCP setup with codex integration for improved developer experience
  • Add profile and message support to project upload MCP tool: MCP project upload tool now supports profile selection and custom upload messages for better workflow integration
  • Add create-test-account MCP tool: New MCP tool that enables AI assistants to create HubSpot developer test accounts programmatically, supporting both configuration file-based and flag-based account creation with customizable hub tier levels
  • Add network request context to debug: Enhanced debugging output includes network request context for better troubleshooting of API interactions
  • Allow installation of dev dependencies: Dependency management utilities now support installing dev dependencies with the --save-dev flag
  • Update feature highlight in get-started for non-uploaded projects: Improved onboarding experience with better feature highlighting for new users
  • hs account rename will now sanitize the new account name

Bug Fixes

  • Fix require.resolve() error in CMS theme preview: Resolved ES module compatibility issue that caused ReferenceError: require is not defined when using CMS theme preview with type:module in package.json
  • Fix installPackagesInDirectory flag usage: Install flags are now only used when there are specified packages to install, preventing incorrect flag application
  • Fix dependency management error messages: Correct error messages are now shown for installDeps vs updateDeps operations, improving user feedback
  • Update validateProjectConfig to throw instead of exiting: Improved error handling by throwing errors instead of exiting the process, allowing better error recovery
  • Update no features added copy: Improved messaging when no features are added to a project for clearer user communication

Improvements and Refactoring

  • Remove references to install-deps: Cleaned up references to deprecated install-deps step from get-started workflow. This is no longer necessary now that local dev will automatically install deps.
  • Update hs test-account create help text: Improved help text for test account creation command with clearer instructions
  • Add annotations to MCP tools: All MCP tools now include annotation metadata (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to help AI assistants better understand tool behavior and make safer, more informed tool selections

v7.9.0

26 Nov 19:00
7dd1d5f

Choose a tag to compare

What's Changed

Full Changelog: v7.8.0...v7.9.0

v7.8.0

26 Nov 19:00
631b93d

Choose a tag to compare

What's Changed

Full Changelog: v7.7.0...v7.8.0

v7.7.0

23 Sep 19:45
e3e8ef5

Choose a tag to compare

What's Changed

Full Changelog: v7.5.4...v7.7.0

v7.5.4

11 Jul 15:56
8b6c017

Choose a tag to compare

What's Changed

Full Changelog: v7.4.8...v7.5.4

v7.4.8

07 May 16:59
218eafa

Choose a tag to compare

What's Changed

  • fix: The auth command is failing when token.hubName is null by @joe-yeager in #1481

Full Changelog: v7.4.7...v7.4.8