plugsync-cli 0.1.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, diff against the remote, validate, preview a publish, and manage plugins -- all without cloning the plugsync backend repo.

Install

pip install plugsync-cli

Requires Python 3.12+.

Quickstart

plugsync config set api_url https://your-plugsync-instance.example.com
plugsync auth login -e [e-mail]
plugsync pull my-connector

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 as a local directory
plugsync push <name>	Upload a local connector directory
plugsync diff <name>	Diff local vs. remote working state
plugsync validate <name>	Validate a local connector config
plugsync preview <name>	Preview a publish's effects
plugsync log <name>	Show a connector's revision history
plugsync rollback <name>	Restore a previous revision
plugsync plugin init/push/list/status/logs/invoke	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.