Flowcore Agent Plugin

Connects a coding agent to Flowcore and teaches it to operate the platform safely.

Status: pre-release (0.1.0).

Contents

Component	What it does
flowcore-platform	Resource hierarchy (tenant → data core → flow type → event type → events), naming, safety rules, tool map
flowcore-iam	Users, API keys, roles, policies. The only valid FRN format, with valid and invalid examples
flowcore-data-pathways	Operate Data Pathways: virtual (default) vs managed, pause, resume, restart, troubleshooting
flowcore-pathways	Build apps with the @flowcore/pathways SDK: virtual pathway, cluster + pump, handlers, writes
mcp.json / .mcp.json	The hosted Flowcore MCP server https://flowcore.io/api/mcp

No credentials ship in this package. Your client signs in with OAuth.

Install

The easiest path: open Flowcore, select Connect MCP in the user menu, copy the setup prompt, and paste it into your agent. The prompt does the steps below.

Claude Code (MCP server + skills):

claude plugin marketplace add flowcore-io/flowcore-agent-plugin
claude plugin install flowcore@flowcore

Codex (skills in ~/.agents/skills, MCP server added separately):

git clone --depth 1 https://github.com/flowcore-io/flowcore-agent-plugin /tmp/flowcore-agent-plugin
mkdir -p ~/.agents/skills
cp -R /tmp/flowcore-agent-plugin/skills/* ~/.agents/skills/
codex mcp add flowcore --url https://flowcore.io/api/mcp --oauth-client-id flowcore-mcp
codex mcp login flowcore

Any other agent: add the MCP server https://flowcore.io/api/mcp at user level. Then download each skill listed in the mirror index https://flowcore.io/agent/skills/index.json into the agent's user-level skills directory, one folder per skill.

Details: docs/installation.md · docs/authentication.md · docs/troubleshooting.md

Updating

The skills tell the agent to check the mirror index at most once per day, and to update local copies when the version is newer. Claude Code users can also run claude plugin update flowcore@flowcore.

Development

node scripts/validate-package.mjs     # package, skills, secrets, FRN examples
node tests/smoke/validator.test.mjs   # the validator rejects each known defect
node scripts/build-release.mjs        # release archive into dist/