{"id":50838097,"url":"https://github.com/corezoid/corezoid-ai-plugin","last_synced_at":"2026-06-14T05:05:37.552Z","repository":{"id":357567344,"uuid":"1229023725","full_name":"corezoid/corezoid-ai-plugin","owner":"corezoid","description":"Corezoid AI plugin marketplace for Claude Code and Codex: product knowledge, workflow skills, schemas, templates, playbooks, samples, and MCP references for building Corezoid processes.","archived":false,"fork":false,"pushed_at":"2026-06-09T12:21:23.000Z","size":3450,"stargazers_count":58,"open_issues_count":2,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-09T14:13:23.319Z","etag":null,"topics":["ai-plugin","api-orchestration","claude-code","claude-plugin","codex","codex-plugin","corezoid","developer-tools","mcp","process-engine","workflow-automation"],"latest_commit_sha":null,"homepage":"https://corezoid.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/corezoid.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-04T16:10:41.000Z","updated_at":"2026-06-09T09:59:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/corezoid/corezoid-ai-plugin","commit_stats":null,"previous_names":["corezoid/corezoid-ai-plugin"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/corezoid/corezoid-ai-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corezoid%2Fcorezoid-ai-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corezoid%2Fcorezoid-ai-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corezoid%2Fcorezoid-ai-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corezoid%2Fcorezoid-ai-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/corezoid","download_url":"https://codeload.github.com/corezoid/corezoid-ai-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/corezoid%2Fcorezoid-ai-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34309716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-plugin","api-orchestration","claude-code","claude-plugin","codex","codex-plugin","corezoid","developer-tools","mcp","process-engine","workflow-automation"],"created_at":"2026-06-14T05:05:36.935Z","updated_at":"2026-06-14T05:05:37.542Z","avatar_url":"https://github.com/corezoid.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Corezoid — Claude Code \u0026 Codex Plugin\n\nA plugin for [Claude Code](https://claude.ai/code) and [Codex](https://openai.com/codex) that connects the [Corezoid](https://corezoid.com) platform to Claude via MCP. Claude gets direct access to Corezoid processes and deep platform knowledge to create, edit, review, and deploy workflows through natural conversation.\n\n\u003e *Not just an MCP wrapper over the Corezoid API — an AI-Native management layer for the platform.*\n\n## What it does\n\nThe plugin bundles a Go MCP server that exposes Corezoid operations as MCP tools and provides specialist skills that teach Claude the platform model and common workflows:\n\n| Skill                          | Activate with                            | Covers                                            |\n|--------------------------------|------------------------------------------|---------------------------------------------------|\n| `corezoid`                     | \"Corezoid\", \"process\", \"conv.json\"       | Full platform overview, all node types, MCP tools |\n| `corezoid-init`                | \"set up\", \"login\", \"pull workspace\"      | OAuth login, workspace pull, environment setup    |\n| `corezoid-create`              | \"create a process\", \"new process\"        | Building processes from scratch                   |\n| `corezoid-edit`                | \"edit\", \"modify\", \"update\" a process     | Modifying existing `.conv.json` files             |\n| `corezoid-review`              | \"review\", \"audit\", \"check\" a process     | Analysis, dead code, best-practice violations     |\n| `corezoid-project-review`      | \"review project\", \"audit folder\"         | Cross-process audit of an entire folder           |\n| `corezoid-dashboard-manager`   | \"create dashboard\", \"add chart\", \"visualize metrics\" | Dashboards, charts, node metrics, real-time monitoring |\n| `corezoid-process-tech-writer` | \"document\", \"write docs\", \"describe process\" | Markdown docs + enriched JSON with node descriptions |\n\n## Design philosophy\n\nThis plugin is not simply an MCP wrapper over the Corezoid API. It is an attempt to\nbuild an AI-Native management layer — one that understands process structure,\nvalidation rules, and platform conventions deeply enough to create, audit, and deploy\nworkflows through natural conversation.\n\n## Requirements\n\n- [Claude Code](https://claude.ai/code) or [Codex](https://openai.com/codex) installed\n- A Corezoid account\n\n## Installation\n\n### Claude Code\n \n**From the GitHub marketplace:**\n\n```bash\nclaude plugin marketplace add corezoid/corezoid-ai-plugin\nclaude plugin install corezoid@corezoid\n```\n\n**Or from a local clone:**\n\n```bash\ngit clone https://github.com/corezoid/corezoid-ai-plugin\nclaude plugin marketplace add ./corezoid-ai-plugin\nclaude plugin install corezoid@corezoid\n```\n\n### Codex\n\n**From the GitHub marketplace:**\n\n```bash\ncodex plugin marketplace add corezoid/corezoid-ai-plugin\ncodex plugin install corezoid@corezoid\n```\n\n**Or from a local clone:**\n\n```bash\ngit clone https://github.com/corezoid/corezoid-ai-plugin\ncodex plugin marketplace add ./corezoid-ai-plugin\ncodex plugin install corezoid@corezoid\n```\n\nNo build step, no extra setup. The MCP server starts automatically on first use.\n\n\u003e **Telemetry:** the plugin collects anonymous usage data (tool name, duration, error type, transport version) to improve reliability. No tokens, workspace IDs, or process content are ever sent. To opt out:\n\u003e ```bash\n\u003e export COREZOID_ANALYTICS_DISABLED=1   # add to ~/.zshrc or ~/.bashrc to persist\n\u003e ```\n\n### Updating\n\n```bash\nclaude plugin update corezoid@corezoid   # Claude Code\ncodex plugin update corezoid@corezoid    # Codex\n```\n\nRestart Claude Code / Codex after updating to apply the new version.\n\n## Authentication\n\nOn the first Corezoid operation Claude detects that no token is present and runs the `login` tool automatically — your browser opens for OAuth2 sign-in and the session continues without interruption.\n\nThe token is saved to `~/.corezoid/credentials` and reused on every subsequent session across all projects. When it expires, the login flow triggers again automatically.\n\nYou can also trigger login manually at any time:\n\n```\nlog in to Corezoid\n```\n\n### Static token (optional)\n\nIf you prefer to manage the token yourself, write it to `~/.corezoid/credentials`:\n\n```\nACCESS_TOKEN=your_token_here\n```\n\nOr export it as an environment variable before starting Claude Code or Codex:\n\n```bash\nexport ACCESS_TOKEN=your_token_here\n```\n\n## Configuration\n\n| Environment variable       | Required | Description                                       |\n|----------------------------|----------|---------------------------------------------------|\n| `ACCESS_TOKEN`             | No       | Static token — overrides OAuth2 saved credentials |\n| `COREZOID_API_URL`         | No       | Override the default Corezoid API base URL        |\n| `WORKSPACE_ID`             | No       | Default workspace ID                              |\n| `COREZOID_STAGE_ID`        | No       | Default stage ID                                  |\n| `COREZOID_APIGW_URL`       | No       | Override the API Gateway URL                      |\n| `COREZOID_OAUTH_CLIENT_ID` | No       | OAuth2 client ID — on-prem deployments with a custom authorization server should set this to their own client ID; cloud (account.corezoid.com) users do not need it |\n| `COREZOID_HTTP_PORT`       | No       | Activate the Streamable HTTP transport on this port (e.g. `8080`). When set the server listens for MCP over HTTP instead of stdio — intended for hosted marketplace deployments. Credentials must be pre-configured via env vars; the browser OAuth login flow is not available in HTTP mode |\n\n## Telemetry\n\nThe MCP server collects anonymous usage data (tool name, duration, error type, API hostname) to help improve the plugin. **Tokens, workspace identifiers, process content, and personal data are never sent.**\n\nTo opt out, set the environment variable before starting Claude Code:\n\n```bash\nexport COREZOID_ANALYTICS_DISABLED=1\n```\n\nSee [SECURITY.md](SECURITY.md) for the full list of collected fields.\n\n## Usage\n\nOnce installed, just talk to Claude naturally:\n\n```\nPull my Corezoid workspace and show me what processes are in the Payments folder.\n```\n\n```\nCreate a process that calls any weather API, handles errors,\nand sends the forecast back to the caller.\n```\n\n```\nCreate a folder named \"Services\" in Corezoid.\n```\n\n```\nEdit the \"payment\" process — add retry logic on API timeout\nwith exponential backoff up to 3 attempts.\n```\n\n```\nEdit process with id 1278273  — add retry logic\non API timeout with exponential backoff up to 3 attempts.\n```\n\n```\nReview process ID 2778176 for dead nodes, missing error handlers,\nand hardcoded values.\n```\n\n```\nReview the process at 1278273_Business.folder/2778176_payment.conv.json\nfor dead nodes, missing error handlers, and hardcoded values.\n```\n\n```\nPush the updated payment process to Corezoid and run a test task with\n{\"amount\": 100, \"currency\": \"USD\"}.\n```\n\n```\nAudit the entire Payments folder — list all processes, check for\nvalidation errors, and summarize what each process does.\n```\n\n## MCP Tools\n\n| Tool                | Description                                        |\n|---------------------|----------------------------------------------------|\n| `login`             | Authenticate via OAuth2 (opens browser)            |\n| `logout`            | Remove saved credentials                           |\n| `list-workspaces`   | List available workspaces and stages               |\n| `list-stages`       | List stages in a workspace                         |\n| `list-projects`     | List folders and processes in a stage              |\n| `pull-folder`       | Export an entire folder/stage to local files       |\n| `pull-process`      | Export a single process to a `.conv.json` file     |\n| `push-process`      | Validate and deploy a `.conv.json` to Corezoid     |\n| `lint-process`      | Validate process structure locally (no API call)   |\n| `run-task`          | Send a task to a deployed process                  |\n| `list-node-tasks`   | List tasks currently sitting in a node             |\n| `list-task-history` | Show task execution history                        |\n| `get-node-stat`     | Return time-series in/out statistics for a node   |\n| `delete-task`       | Remove a task from a node                          |\n| `modify-task`       | Update task parameters                             |\n| `create-process`    | Create a new empty process in a folder             |\n| `create-state-diagram` | Create a new empty state diagram (conv_type \"state\") in a folder |\n| `create-folder`     | Create a new subfolder                             |\n| `create-alias`      | Create a short alias for a process                 |\n| `create-variable`   | Create a Corezoid environment variable             |\n| `create-dashboard`  | Create a new dashboard for visualizing node metrics |\n| `get-dashboard`     | Get a dashboard with its charts and series         |\n| `add-chart`         | Add a chart (column, pie, funnel, table) to a dashboard |\n| `modify-chart`      | Modify an existing chart (full series replace)     |\n| `get-chart`         | Get a single chart with its series data            |\n| `set-dashboard-layout` | Save chart positions on a dashboard grid        |\n| `share-object`      | Grant or revoke access on a process/folder/stage/project for a user, API key or group (use privs=\"none\" to revoke) |\n| `list-shares`       | List principals with access to a shared object     |\n| `create-group`      | Create a new user group (optional description)     |\n| `modify-group`      | Rename a group or update its description           |\n| `list-group-objects`| List processes currently shared with a group       |\n| `delete-group`      | Delete a user group (refuses by default if shares active; force=true to override) |\n| `add-to-group`      | Add a user or API key to a group                   |\n| `remove-from-group` | Remove a user or API key from a group              |\n| `list-groups`       | List user groups in the workspace                  |\n| `create-api-key`    | Create a new API key (secret written to ~/.corezoid/api-keys/, never printed in chat) |\n| `modify-api-key`    | Rename or re-describe an API key                   |\n| `delete-api-key`    | Delete an API key (invalidates secret immediately) |\n| `list-api-keys`     | List API keys in the workspace                     |\n| `find-principal`    | Resolve user / group / API-key name to obj_id      |\n| `invite-user`       | Invite an external email and share an object in one call |\n\n## Architecture\n\n```\nClaude Code / Codex\n  └── corezoid MCP server (prebuilt binary)\n        ├── Auth          login, logout\n        ├── Workspace     list-workspaces, list-stages, list-projects\n        ├── Processes     pull-process, pull-folder, push-process, lint-process\n        │                 create-process, create-folder, create-alias, create-variable\n        ├── Tasks         run-task, list-node-tasks, list-task-history\n        │                 modify-task, delete-task\n        ├── Dashboards    create-dashboard, get-dashboard, add-chart,\n        │                 modify-chart, get-chart, set-dashboard-layout\n        └── Access        share-object, list-shares,\n                          create-group, modify-group, delete-group, list-group-objects,\n                          add-to-group, remove-from-group, list-groups,\n                          create-api-key, modify-api-key, delete-api-key, list-api-keys,\n                          find-principal, invite-user\n```\n\n## Project structure\n\n```\ncorezoid-ai-plugin/\n├── .claude-plugin/\n│   └── marketplace.json         # Claude Code marketplace listing (points to plugins/corezoid)\n├── .agents/\n│   └── plugins/\n│       └── marketplace.json     # Codex marketplace listing (points to plugins/corezoid)\n├── plugins/corezoid/            # Plugin root (CLAUDE_PLUGIN_ROOT for both Claude Code and Codex)\n│   ├── .claude-plugin/\n│   │   └── plugin.json          # Claude Code plugin manifest\n│   ├── .codex-plugin/\n│   │   └── plugin.json          # Codex plugin manifest\n│   ├── .mcp.json                # MCP server configuration\n│   ├── mcp-server/              # MCP server source\n│   ├── skills/\n│   │   ├── corezoid/                    # Universal assistant skill\n│   │   ├── corezoid-init/               # Environment setup skill\n│   │   ├── corezoid-create/             # Process creation skill\n│   │   ├── corezoid-edit/               # Process editing skill\n│   │   ├── corezoid-review/             # Process review skill\n│   │   ├── corezoid-project-review/     # Project audit skill\n│   │   ├── corezoid-dashboard-manager/  # Dashboard \u0026 chart management skill\n│   │   └── corezoid-process-tech-writer/ # Process documentation skill\n│   ├── docs/                    # Node and process documentation\n│   └── samples/                 # Example .conv.json processes\n```\n\n## Debugging\n\nThe MCP server always writes debug output to `/tmp/corezoid.log` when running in MCP mode. View it with:\n\n```bash\ntail -f /tmp/corezoid.log\n```\n\nIn CLI mode, enable verbose output with:\n\n```bash\nCOREZOID_DEBUG=1 ./convctl pull-process process_id=123\n```\n\n## Troubleshooting\n\nSee [docs/Troubleshooting.md](docs/Troubleshooting.md) for solutions to common problems:\n\n- Browser did not open during `login`\n- Expired or missing `ACCESS_TOKEN`\n- `push-process` validation errors\n- MCP server startup failures\n- Common Corezoid API error codes\n\n## Compatibility\n\n| Component         | Supported versions            | Notes |\n|-------------------|-------------------------------|-------|\n| Claude Code       | ≥ 1.x                         | MCP protocol 2025-03-26 |\n| Codex             | current stable                | Same MCP server, same skills |\n| macOS             | 13 Ventura and later          | Tested on arm64 and amd64 |\n| Linux             | Ubuntu 22.04+, Debian 12+     | amd64 tested in CI |\n| Windows           | not tested                    | Likely works; PRs welcome |\n\n## Links\n\n- [Corezoid](https://corezoid.com)\n- [Claude Code](https://claude.ai/code)\n- [Changelog](CHANGELOG.md)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcorezoid%2Fcorezoid-ai-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcorezoid%2Fcorezoid-ai-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcorezoid%2Fcorezoid-ai-plugin/lists"}