OrgX Integration

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

Quick Start

CODEBLOCK0

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

orgx_request_decision — Ask the user to decide something before continuing.
CODEBLOCK2

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

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

Quality & Spawning

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

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

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. 1. Call orgx_report_progress with phase: "reviewing" and INLINECODE26
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 Type	Tier	Model
Architecture, strategy, decisions, RFCs	opus	INLINECODE32
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:
CODEBLOCK7

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

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.