corezoid-ai-plugin

# Corezoid AI Plugin

> Official Claude Code plugin for Corezoid BPM platform. Provides skills and MCP tools for creating, editing, reviewing, and managing Corezoid business processes directly from the IDE.

## Skills

- [corezoid](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid/SKILL.md): Universal Corezoid assistant
- [corezoid-access](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-access/SKILL.md): Corezoid access-control specialist
- [corezoid-alias-manager](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-alias-manager/SKILL.md): Manages Corezoid aliases — create, list, modify, delete, link/unlink, and use aliases in process JSON
- [corezoid-api-connector](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-api-connector/SKILL.md): Corezoid API connector specialist
- [corezoid-create](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-create/SKILL.md): Corezoid process creation specialist
- [corezoid-dashboard-manager](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-dashboard-manager/SKILL.md): Creates and manages Corezoid dashboards — adds charts (column, pie, funnel, table), binds metrics to process nodes, configures real-time mode, and sets up drill-down linking between dashboards
- [corezoid-describe](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-describe/SKILL.md): Updates or creates the description of a Corezoid process, folder, or project without touching its logic
- [corezoid-edit](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-edit/SKILL.md): Corezoid process editing specialist
- [corezoid-edit-bot](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-edit-bot/SKILL.md): Iteratively edits an already-built messenger bot from corezoid-gen-bot — a Corezoid Communications Orchestrator serving Telegram, Viber, Apple Messages for Business and Facebook Messenger over a backend of existing Corezoid processes called with api_rpc
- [corezoid-feedback](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-feedback/SKILL.md): Collects and submits bug reports, improvement requests, and quality signals about the Corezoid plugin to the Corezoid team
- [corezoid-gen-bot](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-gen-bot/SKILL.md): Generates a multi-platform messenger bot (Telegram, Viber, Apple Messages for Business, Facebook Messenger) on Corezoid from a set of EXISTING Corezoid processes plus a description of the desired bot
- [corezoid-git-context](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-git-context/SKILL.md): Analyzes the current session and updates _ext/docs/*.md in the Corezoid git mirror for the active stage
- [corezoid-gitcall](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-gitcall/SKILL.md): Corezoid Git Call node specialist — run custom code (Python, Go, Java, PHP, JavaScript, Clojure, Lisp, Prolog, or a custom Dockerfile) as a step inside a process
- [corezoid-init](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-init/SKILL.md): Corezoid environment setup specialist
- [corezoid-lifecycle](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-lifecycle/SKILL.md): Safely pauses, resumes, or moves existing Corezoid processes and folders
- [corezoid-logout](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-logout/SKILL.md): Log out of Corezoid: remove saved credentials for the current workspace from `~/.corezoid/config.json`
- [corezoid-node-layout](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-node-layout/SKILL.md): Auto-arrange the nodes of a Corezoid process into a clean, readable layout — a vertical top-to-bottom business flow with error handling railed off to the right and no overlapping nodes
- [corezoid-process-optimizer](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-process-optimizer/SKILL.md): Optimizes a Corezoid process JSON — reduces tact consumption by merging nodes, cleans data flow, fills missing node titles, and adds resilience patterns
- [corezoid-process-tech-writer](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-process-tech-writer/SKILL.md): Documents a Corezoid process — produces a human-readable Markdown file AND enriches the process JSON with descriptions on every node and parameter
- [corezoid-project-review](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-project-review/SKILL.md): Corezoid project review and audit specialist
- [corezoid-retro](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-retro/SKILL.md): Corezoid session retrospective specialist
- [corezoid-review](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-review/SKILL.md): Corezoid process review and audit specialist
- [corezoid-state-diagram-create](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-state-diagram-create/SKILL.md): Corezoid state diagram creation specialist
- [corezoid-state-diagram-edit](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-state-diagram-edit/SKILL.md): Corezoid state diagram editing specialist
- [corezoid-variable-manager](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/corezoid-variable-manager/SKILL.md): Manages Corezoid environment variables (env_var) — create, list, modify, delete, and use variables in process JSON
- [marketplace-publish-validation](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/skills/marketplace-publish-validation/SKILL.md): Corezoid  marketplace pre-publication validator

## MCP Tools

The plugin bundles a Go MCP server (`convctl`) with these tools:

- **add-chart**: Add a chart to a Corezoid dashboard. chart_type must be one of: column, pie, funnel, table (action of `cz-dashboards`)
- **add-to-group**: Add a user (or API key user) to a group (action of `cz-access`)
- **clean-process**: Remove nodes with no traffic in the last N days (default 90) from a Corezoid process, saving a reviewable proposal as <ID>_<title>.cleaned.json — NOT a .conv.json, so it never collides with the pulled process; pass that path explicitly to lint-process/push-process to deploy it
- **create-alias**: Create a short alias for a Corezoid process
- **create-api-key**: Create a new API key in the workspace (action of `cz-access`)
- **create-communications-orchestrator**: Create a Communications Orchestrator: a multi-platform robot handling Telegram, Facebook Messenger, Viber and Apple Messages for Business
- **create-dashboard**: Create a new Corezoid dashboard for visualizing process node metrics (action of `cz-dashboards`)
- **create-folder**: Create a new folder inside a parent Corezoid folder (action of `cz-structure`)
- **create-group**: Create a new user group in the current workspace (action of `cz-access`)
- **create-process**: Create a new empty process (conv_type "process") inside a Corezoid folder
- **create-project**: Create a new Corezoid project (with optional stages) inside a workspace (action of `cz-structure`)
- **create-snapshot**: Snapshot a process's current server state as a manual checkpoint before experiments. push-process already auto-snapshots existing processes (action of `cz-snapshots`)
- **create-state-diagram**: Create a new empty state diagram (conv_type "state") inside a Corezoid folder
- **create-variable**: Create an environment variable in the current Corezoid stage (action of `cz-variables`)
- **cz-access**: Router tool: call it as {"action": "<action>", "args": {…}}
- **cz-dashboards**: Router tool: call it as {"action": "<action>", "args": {…}}
- **cz-git-context**: Router tool: call it as {"action": "<action>", "args": {…}}
- **cz-snapshots**: Router tool: call it as {"action": "<action>", "args": {…}}
- **cz-structure**: Router tool: call it as {"action": "<action>", "args": {…}}
- **cz-tasks**: Router tool: call it as {"action": "<action>", "args": {…}}
- **cz-variables**: Router tool: call it as {"action": "<action>", "args": {…}}
- **delete-api-key**: Delete an API key (action of `cz-access`)
- **delete-folder**: Move a Corezoid folder to the recycle bin (Trash) (action of `cz-structure`)
- **delete-group**: Delete a user group (action of `cz-access`)
- **delete-process**: Move a Corezoid process (or state diagram) to the recycle bin (Trash)
- **delete-project**: Move a Corezoid project to the recycle bin (Trash) (action of `cz-structure`)
- **delete-snapshot**: Delete a snapshot by its obj_id (action of `cz-snapshots`)
- **delete-task**: Delete a task from a process (action of `cz-tasks`)
- **delete-variable**: PERMANENTLY delete a Corezoid environment variable from the current stage (action of `cz-variables`)
- **deploy-stage**: Deploy (promote) one stage's processes onto another within a Corezoid project — e.g. develop → production
- **find-principal**: Search users, groups or API keys in the workspace by substring (action of `cz-access`)
- **get-chart**: Get a single chart with its series data (action of `cz-dashboards`)
- **get-dashboard**: Get a Corezoid dashboard with its charts and series (action of `cz-dashboards`)
- **get-node-stat**: Return time-series statistics (in/out counts) for a node over a time range. node_id is the ID shown in the Corezoid UI archive URL (/diagram/{node_id}/archive). ops[0]['data'] contains [{"date":"YYYY-MM-DD","in":N,"out":M}] for non-zero buckets. ops[0]['title'] is the node title (action of `cz-tasks`)
- **get-snapshot**: Get one snapshot's node list, as it existed at snapshot time, for diffing against the current process (action of `cz-snapshots`)
- **git-pull-context**: Clone or pull the Corezoid git mirror for the current workspace into .git-context/. Requires git_url, api_login, and api_secret to be set in the current Folder in ~/.corezoid/config.json (action of `cz-git-context`)
- **git-push-context**: Commit and push local _ext/ changes to the Corezoid git mirror (action of `cz-git-context`)
- **invite-user**: Invite an external email to the workspace AND share a process/folder/stage/project with them in one call (action of `cz-access`)
- **layout-process**: Auto-arrange a process's node coordinates into a clean, readable layout (waterfall for simple trees, layered+error-rail for meshes, aligned table/star grids for region bundles)
- **lint-process**: Validate process structure
- **list-api-keys**: List API keys visible in the current workspace (action of `cz-access`)
- **list-folders**: List the immediate children of a Corezoid folder (subfolders + processes + state diagrams) (action of `cz-structure`)
- **list-group-objects**: List the processes (conv objects) currently shared with a group (action of `cz-access`)
- **list-groups**: List user groups visible in the current workspace (action of `cz-access`)
- **list-node-tasks**: Return tasks currently sitting in a specific node of a process (action of `cz-tasks`)
- **list-projects**: Return the list of projects inside a Corezoid workspace (company), sorted by title (action of `cz-structure`)
- **list-shares**: List users, API keys and groups that currently have access to a Corezoid object (action of `cz-access`)
- **list-snapshots**: List all snapshots for a process (action of `cz-snapshots`)
- **list-stages**: Return the list of stages (environments) inside a Corezoid project (action of `cz-structure`)
- **list-task-history**: Return the execution history (node path) for a task (action of `cz-tasks`)
- **list-variables**: List all environment variables (env_var) in the current Corezoid stage: short_name, obj_id, data_type (raw/json), env_var_type (visible/secret), title, value and change time (action of `cz-variables`)
- **list-workspaces**: Return the list of Corezoid workspaces (companies) available to the authenticated user (action of `cz-structure`)
- **login**: Authenticate with Corezoid
- **logout**: Remove saved Corezoid credentials from disk
- **modify-api-key**: Update title and/or description of an existing API key (action of `cz-access`)
- **modify-chart**: Modify an existing Corezoid chart (action of `cz-dashboards`)
- **modify-folder**: Rename a Corezoid folder and/or update its description (action of `cz-structure`)
- **modify-group**: Rename a user group and/or update its description (action of `cz-access`)
- **modify-project**: Update a Corezoid project's title, short_name and/or description (action of `cz-structure`)
- **modify-task**: Modify an existing task's data; at least one of task_id or ref is required (action of `cz-tasks`)
- **modify-variable**: Modify a Corezoid environment variable in the current stage: its value, description (display title), data_type (raw/json), and/or rename it (new_name) (action of `cz-variables`)
- **move-folder**: Move (reparent) one existing NORMAL Corezoid folder to another folder in the configured workspace, preserving its folder ID and descendants; NOT copy, import, or deploy (action of `cz-structure`)
- **move-process**: Move (reparent) one existing Corezoid process/state diagram to another folder in the configured workspace, preserving its object ID and graph; NOT copy, import, or deploy (action of `cz-structure`)
- **pause-process**: Pause one Corezoid process without changing or deploying its graph
- **pull-folder**: Recursively export all processes from a Corezoid folder/stage to a local directory
- **pull-process**: Export a single Corezoid process definitions to a JSON file
- **push-process**: Validate and deploy a process file to Corezoid
- **read-context-file**: Read a file from .git-context/ of the current workspace (git mirror local copy) (action of `cz-git-context`)
- **remove-from-group**: Remove a user from a group (action of `cz-access`)
- **resume-process**: Resume (activate) one paused/debug Corezoid process without changing or deploying its graph
- **run-task**: Run a task on an already-deployed Corezoid process (without re-deploying) and wait for it to reach a final node
- **send-feedback**: Submit user feedback about plugin behavior to Corezoid
- **set-dashboard-layout**: Save chart positions on a dashboard grid (action of `cz-dashboards`)
- **set-stage-immutable**: Set a stage's immutable (read-only) flag (action of `cz-structure`)
- **share-object**: Grant or revoke access to a Corezoid object (process/folder/stage/project) for a user, API key, or group (action of `cz-access`)
- **show-folder**: Show metadata for a single Corezoid folder: title, obj_type (0 normal, 2 project, 3 stage), parent folder ID and parent type (action of `cz-structure`)
- **show-project**: Show a Corezoid project's metadata and the stages available to the caller (action of `cz-structure`)
- **show-task**: Return the current state of a single task — data, obj_id (task_id), node_id and status — resolved by task_id and/or ref (action of `cz-tasks`)
- **update-context-file**: Write or append to a file inside _ext/ of the git mirror local copy (.git-context/) (action of `cz-git-context`)

## Documentation

- [Node Structures](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/docs/node-structures.md): JSON schemas for all 24 Corezoid node types
- [Variables Guide](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/docs/variables-guide.md): Environment variable syntax `{{env_var[@name]}}`
- [Process Docs](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/docs/process/): Process format, validation rules, and error handling
- [Node Docs](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/plugins/corezoid/docs/nodes/): Per-node-type documentation (24 types)

## Optional

- [Skills Index](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/public/.well-known/skills/index.json): Machine-readable agent discovery index
- [Changelog](https://raw.githubusercontent.com/corezoid/corezoid-ai-plugin/main/CHANGELOG.md): Release history