- name
- orgx
- description
- Use when managing work with OrgX — reporting progress, requesting decisions, registering artifacts, syncing memory, checking quality gates, or viewing org status. Activates for phrases like "report progress", "request approval", "create initiative", "check orgx", "sync with orgx", "register artifact".
- version
- 2.1.0
- user-invocable
- true
- tags
OrgX Integration
Connect to OrgX for multi-agent orchestration, decision workflows, initiative tracking, model routing, quality gates, and structured work reporting.
Quick Start
# Install the plugin
openclaw plugins install @useorgx/openclaw-plugin
# Or via npx
npx @useorgx/openclaw-pluginAfter 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.
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.
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.).
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.
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.
orgx_spawn_check({ domain: "engineering", taskId: "..." })
// Returns: { allowed: true, modelTier: "sonnet", checks: {...} }orgx_quality_score — Record quality score (1-5) for completed work.
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
- Call
orgx_report_progresswithphase: "reviewing"andprogress_pct: 100 - Call
orgx_quality_scoreto self-assess your work (1-5 scale) - Call
orgx_update_entityto 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 Type | Tier | Model |
|---|---|---|
| Architecture, strategy, decisions, RFCs | opus | anthropic/claude-opus-4-6 |
| Implementation, code, features, docs | sonnet | anthropic/claude-sonnet-4 |
| Status checks, formatting, templates | local | ollama/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:
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.