v8.3.0

What's Changed

• Sync from internal - version 8.3.0 by @joe-yeager in #1594

Full Changelog: v8.2.0...v8.3.0

New Features

• Added migration support for the 2026.03 platform version
• Updated hs get-started to scaffold projects using the 2026.03 platform version
• The --platform-version flag now defaults to 2026.03 across all relevant commands

Bug Fixes

• Fixed SpinniesManager.remove leaving residual text in stdout after spinner removal
• Fixed hs project add duplicating tooling config entries when run multiple times

v8.2.0

What's Changed

• Sync from internal - version 8.2.0 by @camden11 in #1592

Full Changelog: v8.1.0...v8.2.0

New Features

• Standalone mode for MCP server: The MCP server can now run in standalone mode, providing more flexibility for different usage patterns (See more detailed explanation below)
• 2026.03-beta project support: Added support for the latest beta project version in hs project create

Bug Fixes

• Fixed hs account auth --account flag to work correctly for net-new accounts
• Fixed help command suggestions for custom-object commands to show correct usage
• Improved clarity of CLI update notification messages
• CMS dev server stability: The CMS dev server now runs in a separate process, improving reliability and preventing React reconciliation issues during theme preview
  Improvements and Refactoring

v8.1.0

What's Changed

• Sync from internal - version 8.1.0 by @brandenrodgers in #1588

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

What's Changed

• Sync from internal - version 8.0.0 by @camden11 in #1582

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

What's Changed

• Sync from internal - version 7.11.2 by @brandenrodgers in #1574

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

What's Changed

• Sync from internal - version 7.11.1 by @brandenrodgers in #1571

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

What's Changed

• Sync from internal - version 7.10.0 by @brandenrodgers in #1568

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

What's Changed

• Sync from internal - version 7.9.0 by @brandenrodgers in #1565

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

v7.8.0

What's Changed

• Sync from internal - version 7.8.0 by @brandenrodgers in #1561

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

v7.7.0

What's Changed

• Sync from internal - version 7.7.0 by @brandenrodgers in #1558

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