Skip to main content

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

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 <connector> Download a connector's draft as a local directory (--revision N for a published version, --output <path> to choose the directory)
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 [connector] Show a connector's published version history
plugsync rollback <version> [connector] Restore a published version into the draft
plugsync connector poll <connector> Poll the connector's polled sources now (--source <name> for one source)
plugsync connector breakers <name> List the connector's flows whose circuit breaker is open
plugsync connector flow retry <name> <flow> Retry one blocked flow now, instead of waiting for its automatic attempt
plugsync plugin init/push/list/status/logs/metrics/invoke/promote/publish/rollback Author and manage plugins (Enterprise tier)

<connector> is a connector name or id.

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 the plugsync Terms of Service, published at plugsync.com/it/terms. The LICENSE file shipped with the package carries the full notice.

Metadata

Release files for plugsync-cli 0.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plugsync-cli 0.10.0
File Size Uploaded Provenance Actions
plugsync_cli-0.10.0.tar.gz 125.1 kB With provenance Details for plugsync_cli-0.10.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for plugsync-cli 0.10.0
File Interpreter ABI Platform Actions
plugsync_cli-0.10.0-py3-none-any.whl Python 3 none any Details for plugsync_cli-0.10.0-py3-none-any.whl

Total release size: 197.3 kB

Release files / plugsync_cli-0.10.0.tar.gz

Download URL plugsync_cli-0.10.0.tar.gz
Size 125.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e1ac8a38eaae292361cebae19c07880291578b06bf4c4ac225819b9bd63d6503
BLAKE2b-256 checksum
How to use checksums
8d0406fdbb6757606838f7976831f4cf35a3962520df2e8908b74f9c3e839fa0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / plugsync_cli-0.10.0-py3-none-any.whl

Download URL plugsync_cli-0.10.0-py3-none-any.whl
Size 72.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4221d41977e0c55c9c6ef6024563a3aeb5a8703a9138e0caece6ebf5293f3b24
BLAKE2b-256 checksum
How to use checksums
bfb1c94444642fe979fe6787d331b97b77d2706395adcc8eaf55db332124b0aa
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for plugsync-cli 0.10.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for plugsync_cli-0.10.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page