Releases: HubSpot/hubspot-cli
Releases · HubSpot/hubspot-cli
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
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 previewon 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
hsandhscmsbin files
Fixed issue with the--use-envflag 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 lintcommand 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 createandhs project addUX with loading indicators and enhanced visual feedback - Added account ID display in
hs account listoutput - 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 devto prevent crashes from unhandled exceptions - Bug fix for
hs project migratefor projects that use “.” as the “srcDir” - Adding the missing
hs cms module marketplace-validatecommand
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-depscommand: New command that operates similarly tohs project install-depsbut 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 renamewill 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 createhelp 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
v7.5.4
What's Changed
- fix: Fix platform version logs by @joe-yeager in #1482
- Setup hs create asset TS + convert api-sample by @camden11 in #1489
- Port feedback to TS by @brandenrodgers in #1488
- chore: Port lang/en.ts by @joe-yeager in #1493
- Port lint to TS by @brandenrodgers in #1491
- Port more
hs createasset types by @camden11 in #1492 - chore: Port the module commands by @joe-yeager in #1490
- Convert all hs create asset types to ts by @camden11 in #1497
- chore: Port the fetch command to ts by @joe-yeager in #1495
- Update ts patterns for hubdb commands by @brandenrodgers in #1500
- Update ts pattern for secret commands by @brandenrodgers in #1499
- Convert hs create command bucket to TS by @camden11 in #1503
- chore: Convert function ls command to TS by @kemmerle in #1487
- chore: Convert
hs function deployto TS by @kemmerle in #1494 - chore: Convert
hs function serverto TS by @kemmerle in #1496 - Update TS pattern for custom object commands by @brandenrodgers in #1498
- chore: Port
hs logsby @joe-yeager in #1501 - port cms lighthouse-score to TS (waiting for LDL release) by @brandenrodgers in #1485
- Port cms convert-fields to TS (waiting for LDL release) by @brandenrodgers in #1484
- Port cms get-react-module to TS (waiting for LDL release) by @brandenrodgers in #1486
- chore: Convert
hs uploadto TS (Relies on upcoming LDL release) by @kemmerle in #1502 - fix: Remove unnecessary
@ts-expect-errorby @kemmerle in #1506 - porting cms command bucket to ts by @brandenrodgers in #1507
- port feedback tests to ts by @brandenrodgers in #1505
- port completion command to ts by @brandenrodgers in #1508
- final two tests to TS! by @brandenrodgers in #1509
- chore: Port watch by @joe-yeager in #1504
- update ts pattern for sandbox commands by @brandenrodgers in #1510
- Revamp local dev to support websocket server for UI by @camden11 in #1479
- Fix: Bugs in
accountcommands by @kemmerle in #1511 - Fix TS build errors with local dev logging by @camden11 in #1515
- Setup local dev websocket server by @camden11 in #1513
- feat: Onboard app-functions by @joe-yeager in #1476
- fix: Incorrect translation keys by @joe-yeager in #1516
- Refactor: Improve migration flow by @kemmerle in #1512
- Fix duplicate local dev watcher calls by @camden11 in #1517
- Improved local dev state by @camden11 in #1518
- Better errors for hs create by @brandenrodgers in #1519
- chore: Add tests for the migration flow by @joe-yeager in #1472
- Support project profiles by @brandenrodgers in #1520
- Support private oauth apps in hs project dev by @camden11 in #1521
- Fixing some type issues in deploy tests by @brandenrodgers in #1522
- Fixing the typing for some commands by @brandenrodgers in #1523
- TS updates for the account commands by @brandenrodgers in #1524
- Update hs feedback destination by @brandenrodgers in #1525
- Finish command ts pattern updates by @brandenrodgers in #1526
- chore: Create script to help with linking by @joe-yeager in #1527
- chore: Update codeowners by @joe-yeager in #1530
- Support auto updates (opt-in) by @brandenrodgers in #1514
- Support static auth apps by @camden11 in #1531
- Show warning in profiles if there are duplicate ids in use by @brandenrodgers in #1534
- Use delete instead of remove for profile command by @brandenrodgers in #1536
- Support dev on dev sandbox accounts if the portal has access by @brandenrodgers in #1535
- Support app secrets by @brandenrodgers in #1537
- Some copy updates for app secrets by @brandenrodgers in #1538
- Don't prompt for static apps that are already installed by @camden11 in #1540
- feat: Improve error message when project with 2025.2 components is uploaded with lower platform version by @joe-yeager in #1539
- Update unified account check to allow all ungated accounts by @camden11 in #1541
- Support projectAccount and testingAccount flags + clean up unified app account logic by @camden11 in #1542
Full Changelog: v7.4.8...v7.5.4
v7.4.8
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