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 you@example.com
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

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.

License

Proprietary, not open source. The license to install and use this CLI is granted by paragraph 11.2 of the plugsync Terms of Service, published at plugsync.com/it/terms: a non-exclusive, non-transferable, free-of-charge license, for the term of your plugsync agreement, solely for the purpose of using the plugsync service. The LICENSE file shipped with the package carries the full notice.