corezoid

Corezoid — Claude Code & Codex Plugin

A plugin for Claude Code and Codex that connects the Corezoid 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.

Not just an MCP wrapper over the Corezoid API — an AI-Native management layer for the platform.

What it does

The 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:

Skill	Activate with	Covers
corezoid	"Corezoid", "process", "conv.json"	Full platform overview, all node types, MCP tools
corezoid-init	"set up", "login", "pull workspace"	OAuth login, workspace pull, environment setup
corezoid-create	"create a process", "new process"	Building processes from scratch
corezoid-edit	"edit", "modify", "update" a process	Modifying existing .conv.json files
corezoid-review	"review", "audit", "check" a process	Analysis, dead code, best-practice violations
corezoid-project-review	"review project", "audit folder"	Cross-process audit of an entire folder
corezoid-dashboard-manager	"create dashboard", "add chart", "visualize metrics"	Dashboards, charts, node metrics, real-time monitoring
corezoid-process-tech-writer	"document", "write docs", "describe process"	Markdown docs + enriched JSON with node descriptions

Design philosophy

This plugin is not simply an MCP wrapper over the Corezoid API. It is an attempt to build an AI-Native management layer — one that understands process structure, validation rules, and platform conventions deeply enough to create, audit, and deploy workflows through natural conversation.

Requirements

• Claude Code or Codex installed
• A Corezoid account

Installation

Claude Code

From the GitHub marketplace:

claude plugin marketplace add corezoid/corezoid-ai-plugin
claude plugin install corezoid@corezoid

Or from a local clone:

git clone https://github.com/corezoid/corezoid-ai-plugin
claude plugin marketplace add ./corezoid-ai-plugin
claude plugin install corezoid@corezoid

Codex

From the GitHub marketplace:

codex plugin marketplace add corezoid/corezoid-ai-plugin
codex plugin install corezoid@corezoid

Or from a local clone:

git clone https://github.com/corezoid/corezoid-ai-plugin
codex plugin marketplace add ./corezoid-ai-plugin
codex plugin install corezoid@corezoid

No build step, no extra setup. The MCP server starts automatically on first use.

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:

export COREZOID_ANALYTICS_DISABLED=1   # add to ~/.zshrc or ~/.bashrc to persist

Updating

claude plugin update corezoid@corezoid   # Claude Code
codex plugin update corezoid@corezoid    # Codex

Restart Claude Code / Codex after updating to apply the new version.

Authentication

On 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.

The token is saved to ~/.corezoid/credentials and reused on every subsequent session across all projects. When it expires, the login flow triggers again automatically.

You can also trigger login manually at any time:

log in to Corezoid

Static token (optional)

If you prefer to manage the token yourself, write it to ~/.corezoid/credentials:

ACCESS_TOKEN=your_token_here

Or export it as an environment variable before starting Claude Code or Codex:

export ACCESS_TOKEN=your_token_here

Configuration