plugsync-cli 0.3.0

Command-line client for plugsync HubSpot connectors -- manage connectors and plugins like code, no repo checkout required

plugsync-cli

Command-line client for plugsync, managing HubSpot connectors like code: pull a connector's config to a local directory, edit it, push it back to the draft, diff against a published version, validate, preview a publish, and manage plugins -- all without cloning the plugsync backend repo.

push writes the draft and stops. Publishing is opt-in (push --publish), so a config never reaches production as a side effect of saving a file.

Install

pip install plugsync-cli

Requires Python 3.12+.

Quickstart

plugsync auth login -e [e-mail]
plugsync pull my-connector

api_url defaults to the hosted platform (https://app.plugsync.com), so there's nothing to configure for the common case. Point it elsewhere with plugsync config set api_url <url>. plugsync auth login saves a bearer credential to ~/.plugsync/config.yaml that every subsequent command reuses. PLUGSYNC_API_URL / PLUGSYNC_API_KEY environment variables override the config file, handy for CI.

Commands

Command	Purpose
plugsync auth login / logout	Authenticate (email/password JWT, or a long-lived org API key with --token)
plugsync config set/get/show	Manage ~/.plugsync/config.yaml
plugsync pull <name>	Download a connector's draft as a local directory (--revision N for a published version)
plugsync push <name>	Upload a local connector directory to the draft (--publish to also publish)
plugsync diff <name>	Diff local files vs. a published version
plugsync validate <name>	Preflight the draft; non-zero exit on an error
plugsync preview <name>	Preview a publish's effects and its preflight findings
plugsync log <name>	Show a connector's published version history
plugsync rollback <name>	Restore a published version into the draft
plugsync plugin init/push/list/status/logs/metrics/invoke/promote/publish/rollback	Author and manage plugins (Enterprise tier)

Run plugsync --help or plugsync <command> --help for the full option list.

Compatibility

This CLI ships on its own release cadence, independent of the plugsync backend. It declares the minimum API version it expects and checks it against the API at the start of any command that talks to it, warning (never failing outright) if the API is older than expected.

Documentation

Full reference docs, including the plugin authoring dev-loop, live at docs.plugsync.com and in the plugsync repository.

License

Proprietary. This CLI talks to the plugsync SaaS API; see plugsync.com/terms for the terms governing use of the plugsync service.