OrgX Integration#

Connect to OrgX for multi-agent orchestration, decision workflows, initiative tracking, model routing, quality gates, and structured work reporting.

Quick Start#

bash

# Install the plugin
openclaw plugins install @useorgx/openclaw-plugin

# Or via npx
npx @useorgx/openclaw-plugin

After installing, pair with OrgX via the live dashboard at http://127.0.0.1:18789/orgx/live or set ORGX_API_KEY in your environment.

MCP Tools Reference#

Work Reporting (use these regularly)#

orgx_report_progress — Report what you've accomplished.

text

orgx_report_progress({
  summary: "Fixed the authentication bug and added tests",
  phase: "testing",           // researching | implementing | testing | reviewing | blocked
  progress_pct: 75,           // 0-100 (optional)
  next_step: "Run full CI suite"  // (optional)
})

orgx_request_decision — Ask the user to decide something before continuing.

text

orgx_request_decision({
  question: "Deploy to production now or wait for load testing?",
  context: "All unit tests pass. Load testing would take ~2 hours.",
  options: ["Deploy now", "Wait for load testing", "Deploy to staging first"],
  urgency: "medium",          // low | medium | high | urgent
  blocking: true              // pause work until decided (default: true)
})

orgx_register_artifact — Register a deliverable (PR, document, config, etc.).

text

orgx_register_artifact({
  name: "PR #107: Fix Vercel build size",
  artifact_type: "pr",        // pr | commit | document | config | report | design | other
  description: "Reduced function size by pruning recursive assets",
  url: "https://github.com/org/repo/pull/107"  // (optional)
})

Org Status & Sync#

orgx_status — View active initiatives, agent states, pending decisions, tasks.

orgx_sync — Push local memory/daily log to OrgX, receive org context back.

text

orgx_sync({
  memory: "Contents of MEMORY.md",
  dailyLog: "Today's session summary"
})

Quality & Spawning#

orgx_spawn_check — Check quality gate + get model routing before spawning a sub-agent.

text

orgx_spawn_check({ domain: "engineering", taskId: "..." })
// Returns: { allowed: true, modelTier: "sonnet", checks: {...} }

orgx_quality_score — Record quality score (1-5) for completed work.

text

orgx_quality_score({
  taskId: "...",
  domain: "engineering",
  score: 4,
  notes: "Clean implementation, good test coverage"
})

Entity Management#

orgx_create_entity — Create an initiative, workstream, task, decision, milestone, artifact, or blocker.

orgx_update_entity — Update status/fields on any entity.

orgx_list_entities — Query entities by type and status.

Run Control#

orgx_delegation_preflight — Score scope quality and estimate ETA/cost before execution.

orgx_run_action — Pause, resume, cancel, or rollback a run.

orgx_checkpoints_list / orgx_checkpoint_restore — List and restore run checkpoints.

Reporting Protocol#

When working on a task or initiative, report your progress to OrgX at key moments. This keeps the dashboard accurate and helps the team track your work.

On task start#

Call orgx_report_progress with phase: "researching" or "implementing" and a brief summary of what you're about to do.

At meaningful progress points#

Call orgx_report_progress at natural checkpoints: after finishing research, after a first implementation pass, after tests pass, etc. Include progress_pct when you can estimate it.

When you need a human decision#

Call orgx_request_decision with a clear question, context, and options. Set blocking: true if you should wait for the answer before continuing. Set urgency appropriately:

• low — Can wait hours/days
• medium — Should be decided today
• high — Blocking progress, needs attention soon
• urgent — Critical path, needs immediate attention

When you produce a deliverable#

Call orgx_register_artifact for anything the team should see: PRs, documents, config changes, reports, design files. Include a URL when available.

On task completion#

1. Call orgx_report_progress with phase: "reviewing" and progress_pct: 100
2. Call orgx_quality_score to self-assess your work (1-5 scale)
3. Call orgx_update_entity to mark the task as completed

On blockers#

Call orgx_report_progress with phase: "blocked" and describe the blocker in the summary. If you need human help, also call orgx_request_decision.

Model Routing#

OrgX classifies tasks for model selection:

Task TypeTierModelArchitecture, strategy, decisions, RFCsopusanthropic/claude-opus-4-6Implementation, code, features, docssonnetanthropic/claude-sonnet-4Status checks, formatting, templateslocalollama/qwen2.5-coder:32b

Always call orgx_spawn_check before spawning sub-agents to get the right model tier.

Live Dashboard#

The plugin serves a live dashboard at http://127.0.0.1:18789/orgx/live showing:

• Activity Timeline — Real-time feed of agent work with threaded session views
• Agents/Chats — Active sessions grouped by agent
• Decisions — Pending approvals with inline approve/reject
• Initiatives — Active workstreams and progress

Entity API#

For direct API access:

text

GET  /api/entities?type={type}&status={status}&limit={n}
POST /api/entities
PATCH /api/entities
POST /api/entities/{type}/{id}/{action}

Entity types: initiative, workstream, task, decision, milestone, artifact, agent, blocker

MCP Server (mcp.useorgx.com)#

For environments that support MCP servers directly (Claude Desktop, Cursor, etc.), connect to mcp.useorgx.com for the full suite of 26+ OrgX tools including initiative management, decision workflows, and agent orchestration.