mcpField
W
workflow-run

workflow-run

github.com/ruvnetAgent workflows80.0k743 installsUpdated today
Repository

About workflow-run

workflow-run is a skill for running and managing persisted MCP workflows or named native JavaScript workflows. It covers execution, monitoring, pause and resume, cancellation, and passing arguments to scripts.

Key features

  1. 01Run persisted MCP workflows
  2. 02Monitor status and step outcomes
  3. 03Pause, resume, or cancel MCP runs
  4. 04Run named JavaScript workflows
  5. 05Pass arguments or resume by run ID

Use cases

  1. 01Managing a workflow that needs human approval
  2. 02Resuming a paused MCP workflow
  3. 03Running a named subagent fan-out workflow

MCP support

For persisted workflows, it uses MCP tools to execute, monitor, pause, resume, and cancel runs. It also describes native `.claude/workflows/*.js` workflows run with the `Workflow` tool.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ruvnet/ruflo --skill workflow-run

After installing, type/workflow-runin Claude Code to confirm it loaded.

Details

From the project README

Workflow Run

Run and manage a workflow on either surface.

A — MCP workflow lifecycle

When you need to run a persisted definition and control its lifecycle (pause/resume/cancel):

  1. Execute — call mcp__plugin_ruflo-core_ruflo__workflow_execute or mcp__plugin_ruflo-core_ruflo__workflow_run with the workflow ID
  2. Monitor — call mcp__plugin_ruflo-core_ruflo__workflow_status to check progress and step outcomes
  3. Pause — call mcp__plugin_ruflo-core_ruflo__workflow_pause to halt at the current step
  4. Resume — call mcp__plugin_ruflo-core_ruflo__workflow_resume to continue from where paused
  5. Cancel — call mcp__plugin_ruflo-core_ruflo__workflow_cancel to abort the workflow

Execution modes: sequential, parallel (independent steps), conditional (branch on outcome), manual gate (pause for human approval).

B — Native .claude/workflows/*.js

When you need a deterministic subagent fan-out, run a named native workflow with the Workflow tool. The named workflows are the meta.name of each .claude/workflows/*.js file (list them with /workflow or ls .claude/workflows/).

Workflow({ name: 'plugin-contract-audit' })                    // run a named workflow
Workflow({ name: 'plugin-contract-audit', args: 'ruflo-agentdb' })  // pass args → the script's `args` global
Workflow({ scriptPath: '.claude/workflows/foo.js' })           // run a script by path
Workflow({ scriptPath, resumeFromRunId: 'wf_…' })              // resume — unchanged agent() calls return cached

Notes:

  • A native workflow runs in the background; you are notified on completion (don't poll). Watch live progress with /workflows.
  • Pause/resume here is journal-based (resumeFromRunId), not the MCP state machine. Stop a run first, then resume from its runId.
  • To author a new native workflow, use the workflow-create skill.

See ADR-0002.

Comments

Markdown supported