Global Plugs

Configure channel-level engagement rules (auto-reply, repost when likes cross a threshold) via the CLI.

1 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Overview

The plugs:* commands wrap the global plug endpoints under Integrations APIs. Use them to manage channel-level rules that fire when a published post crosses a likes threshold.

Internal vs global plugs

Internal plugs (same-account replies, cross-account comments on create) are set on posts:create via providerSettingsByIntegrationId — not these commands. See Public API → Plugs and Threads CLI examples.

Plug catalog

openquok plugs:catalog

Filter to one provider:

openquok plugs:catalog | jq '.plugs[] | select(.identifier=="threads")'

Use each catalog entry’s methodName as --func on upsert. Field names match fields[].name in the catalog JSON.

List saved rules

openquok plugs:list <integration-id>

Create or update a rule

openquok plugs:upsert <integration-id> 
  --func autoPlugPost 
  --fields '[{"name":"likesAmount","value":"100"},{"name":"post","value":"Thanks for reading!"}]'

Pass --plug-id to update an existing row instead of creating another rule for the same plug type.

Pause, resume, or delete

openquok plugs:activate <plug-id> --activated false
openquok plugs:activate <plug-id> --activated true
openquok plugs:delete <plug-id>

Upsert Global Plug

Create or update global plug rules via the public API

Integrations

List channels and channel groups before configuring plugs

Public API → Plugs

Internal vs global plugs, curl examples, and SDK usage