How gohighlevel/marketplace-cli works
HighLevel Marketplace CLI is a terminal client for creating and managing marketplace apps. Its principal workflow is to authenticate, select an app, pull its configuration into a local workspace, validate and review changes, then push updates or publish. Separate capabilities cover workflow actions and triggers, billing, webhooks, OAuth settings, media, and sandbox accounts. The API client provides resource operations, while shared validation and workspace tooling support these flows. Some subsystem connections are documented in the README; unsampled implementation details and uncertain call paths are not inferred.
Main entry points: index.ts App commands · pull.ts Pull workspace · profile-sections.ts App validation · base.ts Workflow commands
Components 22
CLI and identity
- App commands
src/commands/app/actions/index.ts - Login and accounts
src/commands/login.ts - Auth sessions
src/lib/auth/session.ts
App workspace
- App selection
src/lib/app/context.ts - Pull workspace
src/lib/app/pull.ts - App synchronization
src/lib/app/sync.ts - App validation
src/lib/app/profile-sections.ts - JSON schemas
src/lib/app/json-schemas/builders.ts - Publish readiness
src/lib/app/publish-readiness.ts
Workflow configuration
- Workflow actions
src/lib/workflows/actions/service.ts - Workflow triggers
src/lib/workflows/triggers/service.ts - Workflow commands
src/lib/workflows/commands/base.ts
Marketplace services
- Billing configuration
src/lib/billing/service.ts - Webhook management
src/lib/webhooks/workspace-mutation.ts - Media handling
src/lib/app/media.ts
API and shared layers
- API client
src/lib/api/client.ts - HTTP API core
src/lib/api/core.ts - API resources
src/lib/api/resources/apps.ts - Environment config
src/lib/config/environment.ts - Shared validation
src/lib/shared/validation.ts
Other components
- Developer
- Marketplace services
Connections 26
- Developer → Login and accounts: authenticates
README.md - Login and accounts → Auth sessions: stores session
src/commands/login.ts - Developer → App commands: runs commands
README.md - App commands → App selection: resolves app
- App selection → Pull workspace: binds workspace
src/lib/app/context.ts - App commands → Pull workspace: pulls configuration
README.md - App commands → App validation: validates configuration
README.md - App validation → JSON schemas: checks schema
- App commands → App synchronization: syncs changes
README.md - App commands → Publish readiness: checks readiness
README.md - App commands → Workflow commands: manages workflows
README.md - Workflow commands → Workflow actions: runs action tasks
- Workflow commands → Workflow triggers: runs trigger tasks
- Pull workspace → Workflow actions: pulls actions
src/lib/app/pull.ts - Pull workspace → Workflow triggers: pulls triggers
src/lib/app/pull.ts - App commands → Billing configuration: manages billing
README.md - App commands → Webhook management: manages webhooks
README.md - App commands → Media handling: uploads media
- API client → HTTP API core: extends core
src/lib/api/client.ts - API client → API resources: adds app resource
src/lib/api/client.ts - API resources → HTTP API core: requests data
src/lib/api/resources/apps.ts - Pull workspace → API client: loads remote data
- Environment config → HTTP API core: configures endpoints
src/lib/api/core.ts - App validation → Shared validation: uses validators
src/lib/app/profile-sections.ts - App commands → Marketplace services: manages apps
README.md - Auth sessions → Marketplace services: exchanges credentials