v8.5.0

New Features

• NPM workspace support for project uploads: Projects using NPM workspaces can now be uploaded successfully. The CLI detects workspace configurations and properly packages all workspace dependencies during upload.
• Actions component onboarding: Adds support for the new actions component type in projects, wired through the latest @hubspot/project-parsing-lib.
• Enhanced MCP tool capabilities: The search-docs MCP tool now supports a limit parameter and automatically deduplicates results for cleaner output.

Bug Fixes

• Version reporting: hs --version now correctly reports the CLI version instead of host project versions.
• Upgrade notifications: Pre-release versions (beta, alpha, rc) no longer incorrectly suggest downgrading to older stable versions when checking for updates.
• hs project logs --function flag: Fixed the --function=<name> flag being ignored in projects with multiple functions, which previously caused a misleading "There aren't any functions in this project" error even when functions existed. The error message was also split so a missing function name no longer falsely claims the project has none. Addresses hubspot-cli#1601.
• hs sandbox create ETIMEDOUT: Fixed the v2 sandbox create call falling back to the default HTTP timeout instead of the 60s SANDBOX_TIMEOUT, which caused sandbox creation to fail with ETIMEDOUT on slower creates. Addresses hubspot-cli#1593.
• CMS serverless function runtime default: Templates generated by hs cms create function now default to nodejs20.x instead of the deprecated nodejs18.x. Addresses hubspot-cli#1543.
• HubSpotHttpError debug output: Error payloads are no longer double-stringified into escape-soup in --debug logs.
• Account flag error typo: Fixed a "is is not supported supported" duplication in the deprecated --account flag error for platform v2025.2+ projects.
• hs api command description: Clarified that hs api only works with PAK-supported endpoints.
• Upload profile field: Softened the description for the profile parameter in the upload-project MCP tool.
• Legacy CRM card migration: When unsupported legacy CRM card components are detected during app migration, users now see helpful documentation links for manual migration steps.
• Copy improvements: Updated messaging for themes and apps restrictions to be clearer.

Improvements and Refactoring

• Security dependency bumps: Bumped axios (1.15.2), express (4.22.1), js-yaml (4.1.1), and minimatch (10.2.5) to patch multiple CVEs flagged in hubspot-cli#1554, including SSRF via NO_PROXY bypass, cloud-metadata exfiltration via header injection, path-to-regexp ReDoS, and qs arrayLimit DoS variants.
• Platform version logic centralized: Moved all platform version utilities to @hubspot/project-parsing-lib so the CLI and downstream consumers share one implementation.
• MCP tool usage tracking: Centralized tracking logic in the Tool base class for more consistent analytics.
• Test account creation UX: Reordered prompts to show the guided "from scratch" option first, as it's the most common choice for users.
• Feature gate cleanup: Removed the APPS_HOME feature gate as the UIE:AppHome feature is fully rolled out.
• Dependency bumps: @hubspot/local-dev-lib → 5.4.0 (sandbox timeout, CMS runtime default, HubSpotHttpError guard, security transitives), @hubspot/project-parsing-lib → 0.16.0, @hubspot/ui-extensions-dev-server → 2.0.5, @hubspot/cms-dev-server → 1.2.26.
• Debug capabilities: Added debug logging to MCP server tools and updated the bug report template to request debug output

v8.4.0

New Features

• New command: `hs project info`. This command logs useful project and app metadata in the CLI. It will also enable AI agents to generate app install URLS.
• New command: `hs project delete`. This command allows users to delete apps directly from the CLI. It will also enable AI agents to delete apps.
• New command: `hs api`. This command allows users to make authenticated HTTP requests to any HubSpot API endpoint using their configured CLI authentication
• Improvement: If a user runs a command without the --profile flag in a project configured to use profiles, they will now be prompted to select a profile
• Improvement: New logging UI using unicode characters for terminals that support it

Bug Fixes

• The `hs project watch` command has been deprecated but previously didn’t log a deprecation warning. This has been corrected.
• Fixed a bug in `hs project dev` where the CLI used the incorrect project srcDir when comparing the local project to the deployed project
• Better error handling when attempting to use profiles on 2025.1 projects, which don’t support them
• Fixed a bug where local development of serverless functions would fail if an app’s distribution type was set to “PRIVATE” in all caps
• Fixed a bug where serverless functions were not detected in subdirectories of /app/functions

Improvements and Refactoring

• New and improved usage tracking system that makes collected metadata more consistent from command to command. Adds usage tracking to any commands that previously didn’t have it. Tracks whether or not command executions were successful
• New log that informs users that certain data is being collected for usage tracking purposes and tells them how to opt out.

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