| name | connectwise-manage |
| description | Every ConnectWise PSA workflow from the terminal - with a typed conditions query builder, offline SQLite sync, and cross-entity views (unbilled work, account 360, board triage) the PSA web UI can't give you. Trigger phrases: `list connectwise tickets`, `triage the help desk board`, `find unbilled time in connectwise`, `connectwise account 360 for a client`, `log time on a connectwise ticket`, `use connectwise-manage`, `run connectwise-manage-cli`. |
| author | Damien Stevens |
| license | Apache-2.0 |
| vendor | ConnectWise Manage |
| argument-hint | <command> [args] | install cli|mcp |
| allowed-tools | Read Bash |
| metadata | {"openclaw":{"requires":{"bins":["connectwise-manage-cli"]},"install":[{"kind":"go","bins":["connectwise-manage-cli"],"module":"github.com/mvanhorn/printing-press-library/library/project-management/connectwise-manage/cmd/connectwise-manage-cli"}]}} |
ConnectWise PSA - Printing Press CLI
Prerequisites: Install the CLI
This skill drives the connectwise-manage-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
- Install via the Printing Press installer. It defaults binaries to
$HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
npx -y @mvanhorn/printing-press-library install connectwise-manage --cli-only
- Verify:
connectwise-manage-cli --version
- Ensure the reported install directory is on
$PATH for the agent/runtime that will invoke this skill.
If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.4 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:
go install github.com/mvanhorn/printing-press-library/library/project-management/connectwise-manage/cmd/connectwise-manage-cli@latest
If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.
A spec-generated CLI over the ConnectWise Manage REST API covering tickets, time, companies, contacts, agreements, configurations, projects, opportunities, and members. It syncs the high-gravity entities into a local SQLite store so you get instant full-text search and cross-table views the PSA never surfaces in one place - unbilled reconciles tickets against logged time, account assembles a full company 360, board/stale/workload give a dispatcher's queue at a glance. Every command speaks --json/--select and the whole tree is exposed as an MCP server for AI-driven triage.
When to Use This CLI
Use this CLI when an MSP task touches the ConnectWise PSA system-of-record from the terminal or an agent: triaging or updating service tickets, logging billable time, pulling company / contact / agreement context, checking the CMDB, or reconciling unbilled work and agreement burn. It is the right choice when you want offline-fast queries, cross-entity views the web UI can't compose, or an MCP surface over the PSA. It is not the right choice for ConnectWise Automate (RMM) or for tenant administration screens the REST API doesn't cover.
Unique Capabilities
These capabilities aren't available in any other tool for this API.
Local joins that compound
-
unbilled - Find tickets you touched or closed in a window that have zero or under-threshold time logged against them.
Reach for this before a billing cutoff or at end-of-day to catch revenue leaking from unlogged time.
connectwise-manage-cli unbilled --since 7d --agent
-
account - One card for a company: contacts, active agreements, deployed configurations, open-ticket count, and last activity.
Use it to prep a QBR or to get full context before any escalation call without clicking through tabs.
connectwise-manage-cli account "Acme Corp" --agent
-
agreement-burn - Hours logged against an agreement's company in a period versus the agreement's allotment, as a utilization percentage with over/under flag.
Use it to spot unprofitable clients before they blow their block-hours.
connectwise-manage-cli agreement-burn --period 30d --agent
Dispatcher views
-
board - Open tickets on a board, oldest first, with each ticket's age, owner, status, and priority joined from the synced reference data.
Reach for this for the morning queue sweep instead of reloading the web board view.
connectwise-manage-cli board 2 --unassigned
-
stale - Open tickets with no update in N days, oldest first, with board and owner columns so you see what's rotting and whose it is.
Use it for the daily 'what's rotting on my board' pass before standup.
connectwise-manage-cli stale --days 5
-
workload - Open ticket count and aging per tech, so you route the next ticket to whoever is lightest.
Reach for this when deciding who should take a new escalation.
connectwise-manage-cli workload --agent
Query ergonomics
-
condition - Build a validated ConnectWise conditions expression from flags (handling string quoting, bracketed dates, and AND-default / OR-parentheses), or explain what an existing expression queries.
Use it whenever a list command returns surprisingly empty - the DSL's quoting and AND/OR rules are the usual culprit.
connectwise-manage-cli condition build --field board/name --op = --value "Help Desk"
Command Reference
company - Manage company
connectwise-manage-cli company delete-companies-by-id - Delete ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company delete-companies-statuses-by-id - Delete CompanyStatusconnectwise-manage-cli company delete-companies-types-by-id - Delete Usageconnectwise-manage-cli company delete-configurations-bulk - Delete BulkResultconnectwise-manage-cli company delete-configurations-by-id - Delete Configurationconnectwise-manage-cli company delete-configurations-statuses-by-id - Delete ConfigurationStatusconnectwise-manage-cli company delete-configurations-types-by-id - Delete ConfigurationTypeconnectwise-manage-cli company delete-contacts-by-id - Delete ApiContactconnectwise-manage-cli company delete-contacts-departments-by-id - Delete Usageconnectwise-manage-cli company delete-contacts-relationships-by-id - Delete ContactRelationshipconnectwise-manage-cli company delete-contacts-types-by-id - Delete ContactTypeconnectwise-manage-cli company get-companies - Get List of ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company get-companies-by-id - Get ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company get-companies-by-id-usages - Get List of Usage Countconnectwise-manage-cli company get-companies-by-parent-id-custom-status-notes - Get List of CompanyCustomNoteconnectwise-manage-cli company get-companies-by-parent-id-groups - Get List of CompanyGroupconnectwise-manage-cli company get-companies-by-parent-id-management-report-notifications - Get List of ManagementReportNotificationconnectwise-manage-cli company get-companies-by-parent-id-management-report-setup - Get List of ManagementReportSetupconnectwise-manage-cli company get-companies-by-parent-id-management-summary-reports - Get List of CompanyManagementSummaryconnectwise-manage-cli company get-companies-by-parent-id-notes - Get List of CompanyNoteconnectwise-manage-cli company get-companies-by-parent-id-sites - Get List of CompanySiteconnectwise-manage-cli company get-companies-by-parent-id-teams - Get List of CompanyTeamconnectwise-manage-cli company get-companies-by-parent-id-tracks - Get List of ContactTrackconnectwise-manage-cli company get-companies-by-parent-id-type-associations - Get List of CompanyTypeAssociationconnectwise-manage-cli company get-companies-count - Get Count of ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company get-companies-default - Get ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company get-companies-info - Get List of CompanyInfosconnectwise-manage-cli company get-companies-info-count - Get Count of CompanyInfosconnectwise-manage-cli company get-companies-info-types - Get List of CompanyTypeInfoconnectwise-manage-cli company get-companies-statuses - Get List of CompanyStatusconnectwise-manage-cli company get-companies-statuses-by-id - Get CompanyStatusconnectwise-manage-cli company get-companies-statuses-count - Get Count of CompanyStatusconnectwise-manage-cli company get-companies-types - Get List of CompanyTypeconnectwise-manage-cli company get-companies-types-by-id - Get CompanyTypeconnectwise-manage-cli company get-companies-types-count - Get Count of CompanyTypeconnectwise-manage-cli company get-configurations - Get List of Configurationconnectwise-manage-cli company get-configurations-by-id - Get Configurationconnectwise-manage-cli company get-configurations-count - Get Count of Configurationconnectwise-manage-cli company get-configurations-statuses - Get List of ConfigurationStatusconnectwise-manage-cli company get-configurations-statuses-by-id - Get ConfigurationStatusconnectwise-manage-cli company get-configurations-statuses-count - Get Count of ConfigurationStatusconnectwise-manage-cli company get-configurations-statuses-info - Get List of ConfigurationStatusInfosconnectwise-manage-cli company get-configurations-types - Get List of ConfigurationTypeconnectwise-manage-cli company get-configurations-types-by-id - Get ConfigurationTypeconnectwise-manage-cli company get-configurations-types-count - Get Count of ConfigurationTypeconnectwise-manage-cli company get-contacts - Get List of ApiContactconnectwise-manage-cli company get-contacts-by-id - Get ApiContactconnectwise-manage-cli company get-contacts-by-id-image - Get ValidatePortalResponseconnectwise-manage-cli company get-contacts-by-id-info - Get ContactInfosconnectwise-manage-cli company get-contacts-by-id-portal-security - Get List of PortalSecurityconnectwise-manage-cli company get-contacts-by-id-usages - Get List of Usage Countconnectwise-manage-cli company get-contacts-by-parent-id-communications - Get List of ContactCommunicationconnectwise-manage-cli company get-contacts-by-parent-id-groups - Get List of ContactGroupconnectwise-manage-cli company get-contacts-by-parent-id-notes - Get List of ContactNoteconnectwise-manage-cli company get-contacts-by-parent-id-tracks - Get List of ContactTrackconnectwise-manage-cli company get-contacts-by-parent-id-type-associations - Get List of ContactTypeAssociationconnectwise-manage-cli company get-contacts-count - Get Count of Usageconnectwise-manage-cli company get-contacts-default - Get ApiContactconnectwise-manage-cli company get-contacts-departments - Get List of ContactDepartmentconnectwise-manage-cli company get-contacts-departments-by-id - Get ContactDepartmentconnectwise-manage-cli company get-contacts-departments-count - Get Count of ContactDepartmentconnectwise-manage-cli company get-contacts-departments-info - Get List of ContactDepartmentInfosconnectwise-manage-cli company get-contacts-info - Get List of ContactInfosconnectwise-manage-cli company get-contacts-info-count - Get Count of ContactInfosconnectwise-manage-cli company get-contacts-relationships - Get List of ContactRelationshipconnectwise-manage-cli company get-contacts-relationships-by-id - Get ContactRelationshipconnectwise-manage-cli company get-contacts-relationships-count - Get Count of ContactRelationshipconnectwise-manage-cli company get-contacts-types - Get List of ContactTypeconnectwise-manage-cli company get-contacts-types-by-id - Get ContactTypeconnectwise-manage-cli company get-contacts-types-count - Get Count of ContactTypeconnectwise-manage-cli company get-contacts-types-info - Get List of ContactTypeInfoconnectwise-manage-cli company patch-companies-by-id - Patch ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company patch-companies-statuses-by-id - Patch CompanyStatusconnectwise-manage-cli company patch-companies-types-by-id - Patch CompanyTypeconnectwise-manage-cli company patch-configurations-by-id - Patch Configurationconnectwise-manage-cli company patch-configurations-by-id-change-type - Patch Configurationconnectwise-manage-cli company patch-configurations-statuses-by-id - Patch ConfigurationStatusconnectwise-manage-cli company patch-configurations-types-by-id - Patch ConfigurationTypeconnectwise-manage-cli company patch-contacts-by-id - Patch ApiContactconnectwise-manage-cli company patch-contacts-departments-by-id - Patch ContactDepartmentconnectwise-manage-cli company patch-contacts-relationships-by-id - Patch ContactRelationshipconnectwise-manage-cli company patch-contacts-types-by-id - Patch ContactTypeconnectwise-manage-cli company post-companies - Post ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company post-companies-by-id-merge - Post SuccessResponseconnectwise-manage-cli company post-companies-by-parent-id-custom-status-notes - Post CompanyCustomNoteconnectwise-manage-cli company post-companies-by-parent-id-groups - Post CompanyGroupconnectwise-manage-cli company post-companies-by-parent-id-management-report-notifications - Post ManagementReportNotificationconnectwise-manage-cli company post-companies-by-parent-id-management-report-setup - Post ManagementReportSetupconnectwise-manage-cli company post-companies-by-parent-id-management-summary-reports - Post CompanyManagementSummaryconnectwise-manage-cli company post-companies-by-parent-id-notes - Post CompanyNoteconnectwise-manage-cli company post-companies-by-parent-id-sites - Post CompanySiteconnectwise-manage-cli company post-companies-by-parent-id-teams - Post CompanyTeamconnectwise-manage-cli company post-companies-by-parent-id-tracks - Post ContactTrackconnectwise-manage-cli company post-companies-by-parent-id-type-associations - Post CompanyTypeAssociationconnectwise-manage-cli company post-companies-statuses - Post CompanyStatusconnectwise-manage-cli company post-companies-types - Post CompanyTypeconnectwise-manage-cli company post-configurations - Post Configurationconnectwise-manage-cli company post-configurations-bulk - Post Configurationconnectwise-manage-cli company post-configurations-statuses - Post ConfigurationStatusconnectwise-manage-cli company post-configurations-types - Post ConfigurationTypeconnectwise-manage-cli company post-configurations-types-copy - Post Boardconnectwise-manage-cli company post-contacts - Post ApiContactconnectwise-manage-cli company post-contacts-by-parent-id-communications - Post ContactCommunicationconnectwise-manage-cli company post-contacts-by-parent-id-groups - Post ContactGroupconnectwise-manage-cli company post-contacts-by-parent-id-notes - Post ContactNoteconnectwise-manage-cli company post-contacts-by-parent-id-tracks - Post ContactTrackconnectwise-manage-cli company post-contacts-by-parent-id-type-associations - Post ContactTypeAssociationconnectwise-manage-cli company post-contacts-departments - Post ContactDepartmentconnectwise-manage-cli company post-contacts-relationships - Post ContactRelationshipconnectwise-manage-cli company post-contacts-request-password - Post PortalSecurityconnectwise-manage-cli company post-contacts-types - Post ContactTypeconnectwise-manage-cli company post-contacts-validate-portal-credentials - Post ValidatePortalResponseconnectwise-manage-cli company put-companies-by-id - Put ConnectWise.Apis.v3_0.v2015_3.Company.Company.Companyconnectwise-manage-cli company put-companies-statuses-by-id - Put CompanyStatusconnectwise-manage-cli company put-companies-types-by-id - Put CompanyTypeconnectwise-manage-cli company put-configurations-bulk - Put Configurationconnectwise-manage-cli company put-configurations-by-id - Put Configurationconnectwise-manage-cli company put-configurations-statuses-by-id - Put ConfigurationStatusconnectwise-manage-cli company put-configurations-types-by-id - Put ConfigurationTypeconnectwise-manage-cli company put-contacts-by-id - Put ApiContactconnectwise-manage-cli company put-contacts-departments-by-id - Put ContactDepartmentconnectwise-manage-cli company put-contacts-relationships-by-id - Put ContactRelationshipconnectwise-manage-cli company put-contacts-types-by-id - Put ContactType
finance - Manage finance
connectwise-manage-cli finance delete-agreements-by-id - Delete Agreementconnectwise-manage-cli finance delete-agreements-types-by-id - Delete AgreementTypeconnectwise-manage-cli finance delete-invoices-by-id - Delete Invoiceconnectwise-manage-cli finance get-agreements - Get List of Agreementconnectwise-manage-cli finance get-agreements-by-id - Get Agreementconnectwise-manage-cli finance get-agreements-by-parent-id-additions - Get List of Additionconnectwise-manage-cli finance get-agreements-by-parent-id-adjustments - Get List of Adjustmentconnectwise-manage-cli finance get-agreements-by-parent-id-board-defaults - Get List of BoardDefaultconnectwise-manage-cli finance get-agreements-by-parent-id-configurations - Get List of ConfigurationReferenceconnectwise-manage-cli finance get-agreements-by-parent-id-sites - Get List of AgreementSiteconnectwise-manage-cli finance get-agreements-by-parent-id-work-role-exclusions - Get List of AgreementWorkRoleExclusionconnectwise-manage-cli finance get-agreements-by-parent-id-work-type-exclusions - Get List of AgreementWorkTypeExclusionconnectwise-manage-cli finance get-agreements-by-parent-id-workroles - Get List of AgreementWorkRoleconnectwise-manage-cli finance get-agreements-by-parent-id-worktypes - Get List of AgreementWorkTypeconnectwise-manage-cli finance get-agreements-count - Get Count of Agreementconnectwise-manage-cli finance get-agreements-types - Get List of AgreementTypeconnectwise-manage-cli finance get-agreements-types-by-id - Get AgreementTypeconnectwise-manage-cli finance get-agreements-types-count - Get Count of AgreementTypeconnectwise-manage-cli finance get-agreements-types-info - Get List of AgreementTypeInfoconnectwise-manage-cli finance get-invoices - Get List of Invoiceconnectwise-manage-cli finance get-invoices-by-id - Get Invoiceconnectwise-manage-cli finance get-invoices-by-id-pdf - Get Invoiceconnectwise-manage-cli finance get-invoices-by-parent-id-commissions - Get List of InvoiceCommissionsconnectwise-manage-cli finance get-invoices-by-parent-id-gl-entries - Get List of GLEntriesconnectwise-manage-cli finance get-invoices-by-parent-id-payments - Get List of Paymentconnectwise-manage-cli finance get-invoices-by-parent-id-routings - Get List of Invoice Routingsconnectwise-manage-cli finance get-invoices-count - Get Count of Invoiceconnectwise-manage-cli finance patch-agreements-by-id - Patch Agreementconnectwise-manage-cli finance patch-agreements-types-by-id - Patch AgreementTypeconnectwise-manage-cli finance patch-invoices-by-id - Patch Invoiceconnectwise-manage-cli finance post-agreements - Post Agreementconnectwise-manage-cli finance post-agreements-by-id-copy - Post AgreementTypeconnectwise-manage-cli finance post-agreements-by-id-invoice - Post AgreementInvoiceconnectwise-manage-cli finance post-agreements-by-parent-id-additions - Post Additionconnectwise-manage-cli finance post-agreements-by-parent-id-adjustments - Post Adjustmentconnectwise-manage-cli finance post-agreements-by-parent-id-board-defaults - Post BoardDefaultconnectwise-manage-cli finance post-agreements-by-parent-id-configurations - Post ConfigurationReferenceconnectwise-manage-cli finance post-agreements-by-parent-id-copy - Post CopyAgreementActionconnectwise-manage-cli finance post-agreements-by-parent-id-sites - Post AgreementSiteconnectwise-manage-cli finance post-agreements-by-parent-id-work-role-exclusions - Post AgreementWorkRoleExclusionconnectwise-manage-cli finance post-agreements-by-parent-id-work-type-exclusions - Post AgreementWorkTypeExclusionconnectwise-manage-cli finance post-agreements-by-parent-id-workroles - Post AgreementWorkRoleconnectwise-manage-cli finance post-agreements-by-parent-id-worktypes - Post AgreementWorkTypeconnectwise-manage-cli finance post-agreements-types - Post AgreementTypeconnectwise-manage-cli finance post-invoices - Post Invoiceconnectwise-manage-cli finance post-invoices-by-parent-id-payments - Post Paymentconnectwise-manage-cli finance post-invoices-by-parent-id-routings - Post Invoice Routingsconnectwise-manage-cli finance put-agreements-by-id - Put Agreementconnectwise-manage-cli finance put-agreements-types-by-id - Put AgreementTypeconnectwise-manage-cli finance put-invoices-by-id - Put Invoice
procurement - Manage procurement
connectwise-manage-cli procurement delete-products-by-id - Delete ProductItemconnectwise-manage-cli procurement delete-purchaseorders-by-id - Delete PurchaseOrderconnectwise-manage-cli procurement delete-purchaseorders-by-parent-id-lineitems - Delete PurchaseOrderLineItemconnectwise-manage-cli procurement get-products - Get List of ProductItemconnectwise-manage-cli procurement get-products-by-id - Get ProductItemconnectwise-manage-cli procurement get-products-by-parent-id-components - Get List of ProductComponentconnectwise-manage-cli procurement get-products-by-parent-id-picking-shipping-details - Get List of ProductPickingShippingDetailconnectwise-manage-cli procurement get-products-count - Get Count of ProductItemconnectwise-manage-cli procurement get-purchaseorders - Get List of PurchaseOrderconnectwise-manage-cli procurement get-purchaseorders-by-id - Get PurchaseOrderconnectwise-manage-cli procurement get-purchaseorders-by-id-info - Get PurchaseOrderInfoconnectwise-manage-cli procurement get-purchaseorders-by-parent-id-lineitems - Get List of PurchaseOrderLineItemconnectwise-manage-cli procurement get-purchaseorders-count - Get Count of PurchaseOrderconnectwise-manage-cli procurement get-purchaseorders-info - Get List of PurchaseOrderInfoconnectwise-manage-cli procurement get-purchaseorders-info-count - Get Count of PurchaseOrderInfoconnectwise-manage-cli procurement patch-products-by-id - Patch ProductItemconnectwise-manage-cli procurement patch-purchaseorders-by-id - Patch PurchaseOrderconnectwise-manage-cli procurement post-products - Post ProductItemconnectwise-manage-cli procurement post-products-by-id-detach - Post ProductDetachconnectwise-manage-cli procurement post-products-by-parent-id-components - Post List of ProductComponentconnectwise-manage-cli procurement post-products-by-parent-id-picking-shipping-details - Post List of ProductPickingShippingDetailconnectwise-manage-cli procurement post-purchaseorders - Post PurchaseOrderconnectwise-manage-cli procurement post-purchaseorders-by-id-copy - Post PurchaseOrderCopyconnectwise-manage-cli procurement post-purchaseorders-by-id-rebatch - Post RebatchPurchaseOrderconnectwise-manage-cli procurement post-purchaseorders-by-id-unbatch - Post UnbatchPurchaseOrderconnectwise-manage-cli procurement post-purchaseorders-by-parent-id-lineitems - Post PurchaseOrderLineItemconnectwise-manage-cli procurement post-purchaseorders-by-parent-id-notes - Post PurchaseOrderNoteconnectwise-manage-cli procurement put-products-by-id - Put ProductItemconnectwise-manage-cli procurement put-purchaseorders-by-id - Put PurchaseOrder
project - Manage project
connectwise-manage-cli project delete-by-id - Delete ApiProjectconnectwise-manage-cli project delete-tickets-by-id - Delete ProjectTicketconnectwise-manage-cli project get - Get List of ApiProjectconnectwise-manage-cli project get-by-id - Get ApiProjectconnectwise-manage-cli project get-by-id-workplan - Get ProjectWorkplanconnectwise-manage-cli project get-by-parent-id-contacts - Get List of ProjectContactconnectwise-manage-cli project get-by-parent-id-notes - Get List of ProjectNoteconnectwise-manage-cli project get-by-parent-id-phases - Get List of ProjectPhaseconnectwise-manage-cli project get-by-parent-id-team-members - Get List of ProjectTeamMemberconnectwise-manage-cli project get-count - Get Count of ApiProjectconnectwise-manage-cli project get-tickets - Get List of ProjectTicketconnectwise-manage-cli project get-tickets-by-id - Get ProjectTicketconnectwise-manage-cli project get-tickets-by-parent-id-activities - Get List of ActivityReference Gets activities associated to the ticket Please use the /sales/activities?connectwise-manage-cli project get-tickets-by-parent-id-all-notes - Get List of ProjectTicketNoteconnectwise-manage-cli project get-tickets-by-parent-id-configurations - Get List of ConfigurationReferenceconnectwise-manage-cli project get-tickets-by-parent-id-documents - Get List of DocumentReference Gets the documents associated to the ticket Please use the /system/documents?connectwise-manage-cli project get-tickets-by-parent-id-notes - Get List of TicketNoteconnectwise-manage-cli project get-tickets-by-parent-id-products - Get List of ProductReference Gets the products associated to the ticket Please use the /procurement/products?connectwise-manage-cli project get-tickets-by-parent-id-scheduleentries - Get List of ScheduleEntryReference Gets the schedule entries associated to the ticket Please use the /schedule/entries?connectwise-manage-cli project get-tickets-by-parent-id-tasks - Get List of TicketTaskconnectwise-manage-cli project get-tickets-by-parent-id-timeentries - Get List of TimeEntryReference Gets time entries associated to the ticket Please use the /time/entries?connectwise-manage-cli project get-tickets-count - Get Count of ProjectTicketconnectwise-manage-cli project patch-by-id - Patch ApiProjectconnectwise-manage-cli project patch-tickets-by-id - Patch ProjectTicketconnectwise-manage-cli project post - Post ApiProjectconnectwise-manage-cli project post-by-parent-id-apply-templates - Post ApplyTemplatesconnectwise-manage-cli project post-by-parent-id-contacts - Post ProjectContactconnectwise-manage-cli project post-by-parent-id-notes - Post ProjectNoteconnectwise-manage-cli project post-by-parent-id-phases - Post ProjectPhaseconnectwise-manage-cli project post-by-parent-id-team-members - Post ProjectTeamMemberconnectwise-manage-cli project post-tickets - Post ProjectTicketconnectwise-manage-cli project post-tickets-by-parent-id-configurations - Post ConfigurationReferenceconnectwise-manage-cli project post-tickets-by-parent-id-convert - Post SuccessResponseconnectwise-manage-cli project post-tickets-by-parent-id-notes - Post TicketNoteconnectwise-manage-cli project post-tickets-by-parent-id-tasks - Post TicketTaskconnectwise-manage-cli project post-tickets-search - Post List of ProjectTicketconnectwise-manage-cli project put-by-id - Put ApiProjectconnectwise-manage-cli project put-tickets-by-id - Put ProjectTicket
sales - Manage sales
connectwise-manage-cli sales delete-activities-by-id - Delete Activityconnectwise-manage-cli sales delete-activities-statuses-by-id - Delete ActivityStatusconnectwise-manage-cli sales delete-activities-types-by-id - Delete ActivityTypeconnectwise-manage-cli sales delete-opportunities-by-id - Delete ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales delete-opportunities-by-parent-id-forecast - Delete Forecastconnectwise-manage-cli sales delete-opportunities-ratings-by-id - Delete OpportunityRatingconnectwise-manage-cli sales delete-opportunities-statuses-by-id - Delete OpportunityStatusconnectwise-manage-cli sales delete-opportunities-types-by-id - Delete OpportunityTypeconnectwise-manage-cli sales get-activities - Get List of Activityconnectwise-manage-cli sales get-activities-by-id - Get Activityconnectwise-manage-cli sales get-activities-count - Get Count of Activityconnectwise-manage-cli sales get-activities-statuses - Get List of ActivityStatusconnectwise-manage-cli sales get-activities-statuses-by-id - Get ActivityStatusconnectwise-manage-cli sales get-activities-statuses-count - Get Count of ActivityStatusconnectwise-manage-cli sales get-activities-statuses-info - Get List of ActivityStatusInfosconnectwise-manage-cli sales get-activities-types - Get List of ActivityTypeconnectwise-manage-cli sales get-activities-types-by-id - Get ActivityTypeconnectwise-manage-cli sales get-activities-types-count - Get Count of ActivityTypeconnectwise-manage-cli sales get-opportunities - Get List of ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales get-opportunities-by-id - Get ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales get-opportunities-by-parent-id-contacts - Get List of OpportunityContactconnectwise-manage-cli sales get-opportunities-by-parent-id-forecast - Get List of Forecastconnectwise-manage-cli sales get-opportunities-by-parent-id-notes - Get List of OpportunityNoteconnectwise-manage-cli sales get-opportunities-by-parent-id-team - Get List of Teamconnectwise-manage-cli sales get-opportunities-conversions-by-id - Get Conversionconnectwise-manage-cli sales get-opportunities-count - Get Count of ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales get-opportunities-default - Get ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales get-opportunities-ratings - Get List of OpportunityRatingconnectwise-manage-cli sales get-opportunities-ratings-by-id - Get OpportunityRatingconnectwise-manage-cli sales get-opportunities-ratings-count - Get Count of OpportunityRatingconnectwise-manage-cli sales get-opportunities-ratings-info - Get List of OpportunityRatingInfoconnectwise-manage-cli sales get-opportunities-statuses - Get List of OpportunityStatusconnectwise-manage-cli sales get-opportunities-statuses-by-id - Get OpportunityStatusconnectwise-manage-cli sales get-opportunities-statuses-count - Get Count of OpportunityStatusconnectwise-manage-cli sales get-opportunities-statuses-info - Get List of OpportunityStatusInfosconnectwise-manage-cli sales get-opportunities-types - Get List of OpportunityTypeconnectwise-manage-cli sales get-opportunities-types-by-id - Get OpportunityTypeconnectwise-manage-cli sales get-opportunities-types-count - Get Count of OpportunityTypeconnectwise-manage-cli sales get-opportunities-types-info - Get List of OpportunityTypeInfosconnectwise-manage-cli sales patch-activities-by-id - Patch Activityconnectwise-manage-cli sales patch-activities-statuses-by-id - Patch ActivityStatusconnectwise-manage-cli sales patch-activities-types-by-id - Patch ActivityTypeconnectwise-manage-cli sales patch-opportunities-by-id - Patch ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales patch-opportunities-by-parent-id-forecast - Patch Forecastconnectwise-manage-cli sales patch-opportunities-ratings-by-id - Patch OpportunityRatingconnectwise-manage-cli sales patch-opportunities-statuses-by-id - Patch OpportunityStatusconnectwise-manage-cli sales patch-opportunities-types-by-id - Patch OpportunityTypeconnectwise-manage-cli sales post-activities - Post Activityconnectwise-manage-cli sales post-activities-statuses - Post ActivityStatusconnectwise-manage-cli sales post-activities-types - Post ActivityTypeconnectwise-manage-cli sales post-opportunities - Post ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales post-opportunities-by-id-convert-to-agreement - Post ApiAgreementconnectwise-manage-cli sales post-opportunities-by-id-convert-to-order - Post ApiSalesOrderconnectwise-manage-cli sales post-opportunities-by-id-convert-to-project - Post ApiProjectconnectwise-manage-cli sales post-opportunities-by-id-convert-to-service-ticket - Post ApiTicketconnectwise-manage-cli sales post-opportunities-by-parent-id-contacts - Post OpportunityContactconnectwise-manage-cli sales post-opportunities-by-parent-id-forecast - Post Forecastconnectwise-manage-cli sales post-opportunities-by-parent-id-notes - Post OpportunityNoteconnectwise-manage-cli sales post-opportunities-by-parent-id-team - Post Teamconnectwise-manage-cli sales post-opportunities-ratings - Post OpportunityRatingconnectwise-manage-cli sales post-opportunities-statuses - Post OpportunityStatusconnectwise-manage-cli sales post-opportunities-types - Post OpportunityTypeconnectwise-manage-cli sales put-activities-by-id - Put Activityconnectwise-manage-cli sales put-activities-statuses-by-id - Put ActivityStatusconnectwise-manage-cli sales put-activities-types-by-id - Put ActivityTypeconnectwise-manage-cli sales put-opportunities-by-id - Put ConnectWise.Apis.v3_0.v2015_3.Sales.Opportunity.Opportunityconnectwise-manage-cli sales put-opportunities-by-parent-id-forecast - Put Forecastconnectwise-manage-cli sales put-opportunities-ratings-by-id - Put OpportunityRatingconnectwise-manage-cli sales put-opportunities-statuses-by-id - Put OpportunityStatusconnectwise-manage-cli sales put-opportunities-types-by-id - Put OpportunityType
service - Manage service
connectwise-manage-cli service delete-boards-by-id - Delete Boardconnectwise-manage-cli service delete-priorities-by-id - Delete Priorityconnectwise-manage-cli service delete-sources-by-id - Delete Sourceconnectwise-manage-cli service delete-tickets-by-id - Delete Ticketconnectwise-manage-cli service delete-tickets-by-parent-id-configurations-by-id - Delete ConfigurationReferenceconnectwise-manage-cli service delete-tickets-by-parent-id-notes-by-id - Delete ServiceNoteconnectwise-manage-cli service delete-tickets-by-parent-id-tasks-by-id - Delete Taskconnectwise-manage-cli service delete-tickets-changelogs - Delete Ticket Change Logsconnectwise-manage-cli service get-boards - Get List of Boardconnectwise-manage-cli service get-boards-by-id - Get Boardconnectwise-manage-cli service get-boards-by-id-usages - Get List of Usage Countconnectwise-manage-cli service get-boards-by-parent-id-statuses - Get List of BoardStatusconnectwise-manage-cli service get-boards-by-parent-id-type-sub-type-item-associations - Get List of BoardTypeSubTypeItemAssociationconnectwise-manage-cli service get-boards-count - Get Count of Boardconnectwise-manage-cli service get-priorities - Get List of Priorityconnectwise-manage-cli service get-priorities-by-id - Get Priorityconnectwise-manage-cli service get-priorities-by-id-image - Get Priorityconnectwise-manage-cli service get-priorities-by-id-usages - Get List of Usage Countconnectwise-manage-cli service get-priorities-count - Get Count of Priorityconnectwise-manage-cli service get-sources - Get List of Sourceconnectwise-manage-cli service get-sources-by-id - Get Sourceconnectwise-manage-cli service get-sources-by-id-info - Get SourceInfosconnectwise-manage-cli service get-sources-by-id-usages - Get List of Usage Countconnectwise-manage-cli service get-sources-count - Get Count of Sourceconnectwise-manage-cli service get-sources-info - Get List of SourceInfosconnectwise-manage-cli service get-sources-info-count - Get Count of SourceInfoconnectwise-manage-cli service get-tickets - Get List of ConnectWise.Apis.v3_0.v2015_3.Service.Ticket.Ticketconnectwise-manage-cli service get-tickets-by-id - Get Ticketconnectwise-manage-cli service get-tickets-by-id-info - Get TicketInfosconnectwise-manage-cli service get-tickets-by-parent-id-activities - Get List of ActivityReference Gets activities associated to the ticket Please use the /sales/activities?connectwise-manage-cli service get-tickets-by-parent-id-activities-count - Get Count of ActivityReference Gets count of activities associated to the ticket Please use the /sales/activities/count?connectwise-manage-cli service get-tickets-by-parent-id-all-notes - Get List of ServiceTicketNoteconnectwise-manage-cli service get-tickets-by-parent-id-configurations - Get List of ConfigurationReferenceconnectwise-manage-cli service get-tickets-by-parent-id-configurations-by-id - Get ConfigurationReferenceconnectwise-manage-cli service get-tickets-by-parent-id-configurations-count - Get Count of ConfigurationReferenceconnectwise-manage-cli service get-tickets-by-parent-id-documents - Get List of DocumentReference Gets the documents associated to the ticket Please use the /system/documents?connectwise-manage-cli service get-tickets-by-parent-id-documents-count - Get Count of DocumentReferenceconnectwise-manage-cli service get-tickets-by-parent-id-notes - Get List of ServiceNoteconnectwise-manage-cli service get-tickets-by-parent-id-notes-by-id - Get ServiceNoteconnectwise-manage-cli service get-tickets-by-parent-id-notes-count - Get Count of ServiceNoteconnectwise-manage-cli service get-tickets-by-parent-id-products - Get List of ProductReference Gets the products associated to the ticket Please use the /procurement/products?connectwise-manage-cli service get-tickets-by-parent-id-products-count - Get Count of ProductReference Gets the products associated to the ticket Please use the /procurement/products/count?connectwise-manage-cli service get-tickets-by-parent-id-scheduleentries - Get List of ScheduleEntryReference Gets the schedule entries associated to the ticket Please use the /schedule/entries?connectwise-manage-cli service get-tickets-by-parent-id-scheduleentries-count - Get Count of ScheduleEntryReference Gets the schedule entries count associated to the ticket Please use theconnectwise-manage-cli service get-tickets-by-parent-id-tasks - Get List of Taskconnectwise-manage-cli service get-tickets-by-parent-id-tasks-by-id - Get Taskconnectwise-manage-cli service get-tickets-by-parent-id-tasks-count - Get Count of Taskconnectwise-manage-cli service get-tickets-by-parent-id-timeentries - Get List of TimeEntryReference Gets time entries associated to the ticket Please use the /time/entries?connectwise-manage-cli service get-tickets-by-parent-id-timeentries-count - Get Count of TimeEntryReference Gets time entries count associated to the ticket Please use the /time/entries/count?connectwise-manage-cli service get-tickets-calculate-sla - Get List of ConnectWise.Apis.v3_0.v2015_3.Service.Ticket.Ticket with SLA calculatedconnectwise-manage-cli service get-tickets-changelogs - Get List of Ticket Change Logconnectwise-manage-cli service get-tickets-count - Get Count of ConnectWise.Apis.v3_0.v2015_3.Service.Ticket.Ticketconnectwise-manage-cli service get-tickets-info - Get List of TicketInfosconnectwise-manage-cli service get-tickets-info-count - Get Count of TicketInfoconnectwise-manage-cli service patch-boards-by-id - Patch Boardconnectwise-manage-cli service patch-priorities-by-id - Patch Priorityconnectwise-manage-cli service patch-sources-by-id - Patch Sourceconnectwise-manage-cli service patch-tickets-by-id - Patch Ticketconnectwise-manage-cli service patch-tickets-by-parent-id-notes-by-id - Patch ServiceNoteconnectwise-manage-cli service patch-tickets-by-parent-id-tasks-by-id - Patch Taskconnectwise-manage-cli service post-boards - Post Boardconnectwise-manage-cli service post-boards-by-parent-id-statuses - Post BoardStatusconnectwise-manage-cli service post-boards-copy - Post Boardconnectwise-manage-cli service post-priorities - Post Priorityconnectwise-manage-cli service post-sources - Post Sourceconnectwise-manage-cli service post-tickets - Post Ticketconnectwise-manage-cli service post-tickets-by-id-copy - Post TicketCopyconnectwise-manage-cli service post-tickets-by-parent-id-attach-children - Post SuccessResponseconnectwise-manage-cli service post-tickets-by-parent-id-configurations - Post ConfigurationReferenceconnectwise-manage-cli service post-tickets-by-parent-id-convert - Post SuccessResponseconnectwise-manage-cli service post-tickets-by-parent-id-merge - Post SuccessResponseconnectwise-manage-cli service post-tickets-by-parent-id-notes - Post ServiceNoteconnectwise-manage-cli service post-tickets-by-parent-id-tasks - Post Taskconnectwise-manage-cli service post-tickets-search - Post List of Ticketconnectwise-manage-cli service put-boards-by-id - Put Boardconnectwise-manage-cli service put-priorities-by-id - Put Priorityconnectwise-manage-cli service put-sources-by-id - Put Sourceconnectwise-manage-cli service put-tickets-by-id - Put Ticketconnectwise-manage-cli service put-tickets-by-parent-id-notes-by-id - Put ServiceNoteconnectwise-manage-cli service put-tickets-by-parent-id-tasks-by-id - Put Task
system - Manage system
connectwise-manage-cli system delete-members-by-id-unused-time-sheets - Delete Memberconnectwise-manage-cli system delete-members-types-by-id - Delete MemberTypeconnectwise-manage-cli system get-info - Get Infoconnectwise-manage-cli system get-info-departmentlocations - Get List of DepartmentLocationInfoconnectwise-manage-cli system get-info-departmentlocations-by-id - Get DepartmentLocationInfoconnectwise-manage-cli system get-info-departmentlocations-count - Get Count of DepartmentLocationInfoconnectwise-manage-cli system get-info-departments - Get List of DepartmentInfoconnectwise-manage-cli system get-info-departments-by-id - Get DepartmentInfoconnectwise-manage-cli system get-info-departments-count - Get Count of DepartmentInfoconnectwise-manage-cli system get-info-links - Get List of LinkInfoconnectwise-manage-cli system get-info-links-by-id - Get LinkInfoconnectwise-manage-cli system get-info-links-count - Get Count of LinkInfoconnectwise-manage-cli system get-info-locales - Get List of LocaleInfoconnectwise-manage-cli system get-info-locales-by-id - Get LocaleInfoconnectwise-manage-cli system get-info-locales-count - Get Count of LocaleInfoconnectwise-manage-cli system get-info-locations - Get List of LocationInfoconnectwise-manage-cli system get-info-locations-by-id - Get LocationInfoconnectwise-manage-cli system get-info-locations-count - Get Count of LocationInfoconnectwise-manage-cli system get-info-members - Get List of MemberInfoconnectwise-manage-cli system get-info-members-by-id - Get MemberInfoconnectwise-manage-cli system get-info-members-count - Get Count of MemberInfoconnectwise-manage-cli system get-info-membersmember-identifierregextypes - Get MemberInfoconnectwise-manage-cli system get-info-personas - Get List of PersonasInfoconnectwise-manage-cli system get-info-personas-by-id - Get PersonasInfoconnectwise-manage-cli system get-info-personas-count - Get Count of PersonasInfoconnectwise-manage-cli system get-info-standard-notes - Get List of StandardNoteInfoconnectwise-manage-cli system get-info-standard-notes-by-id - Get StandardNoteInfoconnectwise-manage-cli system get-info-standard-notes-count - Get Count of StandardNoteInfoconnectwise-manage-cli system get-members - Get List of Memberconnectwise-manage-cli system get-members-by-id - Get Memberconnectwise-manage-cli system get-members-by-id-image - Getconnectwise-manage-cli system get-members-by-id-usages - Get List of Usage Countconnectwise-manage-cli system get-members-by-parent-id-certifications - Get List of MemberCertificationconnectwise-manage-cli system get-members-by-parent-id-managed-device-accounts - Get List of ManagedDeviceAccountconnectwise-manage-cli system get-members-by-parent-id-mycertifications - Get List of MemberCertificationconnectwise-manage-cli system get-members-by-parent-id-notification-settings - Get List of MemberNotificationSettingconnectwise-manage-cli system get-members-by-parent-id-personas - Get List of MemberPersonaconnectwise-manage-cli system get-members-calendarsync - Get List of Member to be use for calendar sync subscriptionsconnectwise-manage-cli system get-members-count - Get Count of Usageconnectwise-manage-cli system get-members-types - Get List of MemberTypeconnectwise-manage-cli system get-members-types-by-id - Get MemberTypeconnectwise-manage-cli system get-members-types-count - Get Count of MemberTypeconnectwise-manage-cli system get-members-types-info - Get List of MemberTypeconnectwise-manage-cli system get-members-with-sso - Get List of Memberconnectwise-manage-cli system patch-members-by-id - Patch Memberconnectwise-manage-cli system patch-members-types-by-id - Patch MemberTypeconnectwise-manage-cli system post-members - Post Memberconnectwise-manage-cli system post-members-by-id-deactivate - Post MemberDeactivationconnectwise-manage-cli system post-members-by-id-link-sso-user - Post SuccessResponseconnectwise-manage-cli system post-members-by-id-submit - Post SuccessResponseconnectwise-manage-cli system post-members-by-id-unlink-sso-user - Post SuccessResponseconnectwise-manage-cli system post-members-by-member-identifier-tokens - Post Tokenconnectwise-manage-cli system post-members-by-parent-id-certifications - Post MemberCertificationconnectwise-manage-cli system post-members-by-parent-id-mycertifications - Post MemberCertificationconnectwise-manage-cli system post-members-by-parent-id-notification-settings - Post MemberNotificationSettingconnectwise-manage-cli system post-members-by-parent-id-personas - Post MemberPersonaconnectwise-manage-cli system post-members-by-ssoid-deactivate-iam-member - Delete Member Via IAMconnectwise-manage-cli system post-members-types - Post MemberTypeconnectwise-manage-cli system put-members-by-id - Put Memberconnectwise-manage-cli system put-members-types-by-id - Put MemberType
time - Manage time
connectwise-manage-cli time delete-entries-by-id - Delete TimeEntryconnectwise-manage-cli time delete-sheets-by-id - Delete TimeSheetconnectwise-manage-cli time get-entries - Get List of TimeEntryconnectwise-manage-cli time get-entries-by-id - Get TimeEntryconnectwise-manage-cli time get-entries-by-parent-id-audits - Get List of TimeEntryAuditconnectwise-manage-cli time get-entries-count - Get Count of TimeEntryconnectwise-manage-cli time get-sheets - Get List of TimeSheetconnectwise-manage-cli time get-sheets-by-id - Get TimeSheetconnectwise-manage-cli time get-sheets-by-parent-id-audits - Get List of TimeSheetAuditconnectwise-manage-cli time get-sheets-count - Get Count of TimeSheetconnectwise-manage-cli time patch-entries-by-id - Patch TimeEntryconnectwise-manage-cli time post-entries - Post TimeEntryconnectwise-manage-cli time post-entries-defaults - Post TimeEntryconnectwise-manage-cli time post-sheets-by-id-approve - Post SuccessResponseconnectwise-manage-cli time post-sheets-by-id-reject - Post SuccessResponseconnectwise-manage-cli time post-sheets-by-id-reverse - Post SuccessResponseconnectwise-manage-cli time post-sheets-by-id-submit - Post SuccessResponseconnectwise-manage-cli time put-entries-by-id - Put TimeEntry
Finding the right command
When you know what you want to do but not which command does it, ask the CLI directly:
connectwise-manage-cli which "<capability in your own words>"
which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match - fall back to --help or use a narrower query.
Recipes
Triage new tickets, agent-friendly
connectwise-manage-cli service get-tickets --conditions 'status/name="New"' --agent --select id,summary,board.name,company.identifier,owner.identifier
Narrows the deeply-nested ticket payload to the five fields an agent actually needs, so it doesn't burn context parsing the full record.
Find unbilled work before the billing cutoff
connectwise-manage-cli unbilled --since 7d --agent
Lists tickets touched this week with zero or under-threshold time logged - the join the PSA won't give you.
Account 360 before a QBR
connectwise-manage-cli account "Acme Corp" --agent
One card with contacts, active agreements, deployed configurations, and open-ticket count instead of five web screens.
Build a safe conditions filter
connectwise-manage-cli condition build --field board/id --op in --value 2,3 --field status/name --op = --value New
Emits a validated conditions string (correct quoting, AND join) you can paste into any list command.
Large / historical tenant: keep sync and reads fast
On a tenant with years of history, a plain sync is expensive: ConnectWise list endpoints declare no "changed since" parameter, so every sync re-fetches each resource in full (you'll see resource_not_incremental warnings) and --since has no effect on the sync itself. Use these levers:
-
Scope the sync with a conditions filter so it fetches only a working window instead of the whole history. Build the expression with condition build, then pass it to sync via --param (repeat per high-volume resource):
connectwise-manage-cli sync service-tickets --param "conditions=lastUpdated > [2025-01-01T00:00:00Z]"
-
Keep reads local. The cross-entity views (unbilled, account, agreement-burn, board, stale, workload) read the local mirror. search defaults to auto mode (it tries the live API first); add --data-source local and/or --type <resource> to stay fully offline. If a command exceeds its default timeout on a big tenant, give it more room with --timeout 2m.
-
On the MCP server, the search tool is already local-only and bounded; run the other commands via connectwise-manage_execute and add the same --param / --data-source local / --timeout flags when the tenant is large.
Auth Setup
ConnectWise Manage uses HTTP Basic auth with a twist: the username is the composite companyId+publicKey and the password is the privateKey, plus a clientId GUID header is required on every call (registered at developer.connectwise.com). Set CW_COMPANY_ID, CW_PUBLIC_KEY, CW_PRIVATE_KEY, and CW_CLIENT_ID; set CW_SITE to your region host (api-na, api-eu, api-au) or your on-prem host. Run doctor to validate all four credentials and reachability before anything else.
Run connectwise-manage-cli doctor to verify setup.
Agent Mode
Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.
-
Pipeable - JSON on stdout, errors on stderr
-
Filterable - --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
connectwise-manage-cli project get --agent --select id,name,status
-
Previewable - --dry-run shows the request without sending
-
Offline-friendly - sync/search commands can use the local SQLite store when available
-
Non-interactive - never prompts, every input is a flag
-
Explicit retries - use --idempotent only when an already-existing create should count as success, and --ignore-missing only when a missing delete target should count as success
Response envelope
Commands that read from the local store or the API wrap output in a provenance envelope:
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}
Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set - piped/agent consumers and explicit-format runs get pure JSON on stdout.
Agent Feedback
When you (or the agent) notice something off about this CLI, record it:
connectwise-manage-cli feedback "the --since flag is inclusive but docs say exclusive"
connectwise-manage-cli feedback --stdin < notes.txt
connectwise-manage-cli feedback list --json --limit 10
Entries are stored locally at ~/.local/share/connectwise-manage-cli/feedback.jsonl. They are never POSTed unless CONNECTWISE_MANAGE_FEEDBACK_ENDPOINT is set AND either --send is passed or CONNECTWISE_MANAGE_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
Output Delivery
Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
| Sink | Effect |
|---|
stdout | Default; write to stdout only |
file:<path> | Atomically write output to <path> (tmp + rename) |
webhook:<url> | POST the output body to the URL (application/json or application/x-ndjson when --compact) |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
Named Profiles
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
connectwise-manage-cli profile save briefing --json
connectwise-manage-cli --profile briefing project get
connectwise-manage-cli profile list --json
connectwise-manage-cli profile show briefing
connectwise-manage-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
Argument Parsing
Parse $ARGUMENTS:
- Empty,
help, or --help → show connectwise-manage-cli --help output
- Starts with
install → ends with mcp → MCP installation; otherwise → see Prerequisites above
- Anything else → Direct Use (execute as CLI command with
--agent)
MCP Server Installation
- Install the MCP server:
go install github.com/mvanhorn/printing-press-library/library/project-management/connectwise-manage/cmd/connectwise-manage-mcp@latest
- Register with Claude Code:
claude mcp add connectwise-manage-mcp -- connectwise-manage-mcp
- Verify:
claude mcp list
Direct Use
- Check if installed:
which connectwise-manage-cli
If not found, offer to install (see Prerequisites at the top of this skill).
- Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the
--agent flag:
connectwise-manage-cli <command> [subcommand] [args] --agent
- If ambiguous, drill into subcommand help:
connectwise-manage-cli <command> --help.
