Kapso Agent Plugins

Use Kapso with your favorite agent harness. These plugins give Codex, Cursor, and Claude Code focused skills for building, integrating, and operating WhatsApp automations and Project Event workflows on Kapso.

Missing an agent harness? Open an issue in this repository.

What It Includes

• integrate-whatsapp: connect WhatsApp to products, onboard customers, configure webhooks, send messages, manage templates, and work with WhatsApp Flows.
• automate-whatsapp: build workflows with WhatsApp and Project Event triggers, event emissions, functions, agents, app integrations, and database-backed automations.
• observe-whatsapp: investigate recurring Findings, search unified project logs, inspect delivery, webhook retries, API errors, workflow events, number health, templates, and operational incidents.
• Kapso MCP server configs for remote authenticated access to Kapso.
• Safety guidance, examples, and validation scripts for release checks.

Cursor

/add-plugin kapso

For local testing from this repository:

/add-plugin /path/to/kapso-agent-plugins

Claude Code

Add the custom marketplace:

/plugin marketplace add gokapso/agent-plugins

Install the plugin:

/plugin install kapso@kapso

Codex

Add the custom marketplace:

codex plugin marketplace add gokapso/agent-plugins

Install the plugin:

codex plugin add app-69e50baf29a48191847ceec3bfd887a4@kapso

You can also browse and install plugins interactively from Codex after adding the marketplace.

For local testing, add this repository directory as the marketplace root:

codex plugin marketplace add /path/to/kapso-agent-plugins
codex plugin add app-69e50baf29a48191847ceec3bfd887a4@kapso

Prerequisites

• Sign in or create a Kapso account during the host's Connect account flow, then approve project access.
• Node.js 20+ for the bundled helper scripts.
• Installing through the Codex UI requests account connection. No API key is needed. For CLI-installed plugins that still need authentication, run:

codex mcp login kapso

Direct API fallback scripts, including unified log search, use:

export KAPSO_API_BASE_URL="https://api.kapso.ai"
export KAPSO_API_KEY="..."

Validation

bun run validate
bun run test:integration
bun run check:syntax

CI runs these commands on every pull request and push to main. The integration tests use offline API fixtures and compare supported requests and outputs against the original agent-skills baseline.

For OpenAI public-directory packaging and review, see PUBLISHING.md. Build the submission ZIP with python3 scripts/package-codex.py.

Safety

The plugin treats read-only inspection and local validation as safe defaults. Actions that send messages, emit Project Events, deploy functions, mutate workflows, create templates, update webhooks, create setup links, start or retry Finding investigations, dismiss Findings, mark Findings addressed, or delete resources should be confirmed explicitly by the user before running.

Release checks reject local filesystem paths, obvious secret files, invalid JSON, unsafe remote MCP URLs, and incomplete marketplace metadata.