Install modes and release assets

Choose your V2 install mode

Workflow Skill Router has one policy core and several runtime boundaries. Choose by the authority your Host can actually provide—not by the largest feature list.

Primary install

Bundled Plugin + MCP

Use the Codex Plugin when you want durable local R0 planning, runtime readiness, typed MCP results, and fail-closed handoff to stronger Host capabilities.

Local-ready: plan_work, propose_support_consent, transition_support_consent, and get_router_status
Runtime label: bundled-local-r0
Requirements: Codex Plugin/MCP support, Python 3.11+, Node.js 24+

Install Plugin + MCP

Host integration

Verified-host integration

Add scheduler, compare-and-swap state, protected route validation, gates, and Goal progression only through Host-verified ports and receipts.

Best for: Codex or platform integrators
Authority: Host-owned; never inferred from local files
Fallback: Typed capability-unavailable

Inspect the Host boundary

Authorized evaluation

Configured evaluation adapter

Run fresh Behavior or Outcome attempts through a server-configured executable. Model input cannot choose the executable, quota, or publication status.

Best for: Maintainers running reviewed benchmarks
Requires: Trusted adapter configuration and explicit quota authorization
Publication: Remains review-required until attested

Read the evidence contract

Instruction-only fallback

Skill-only

Load the V2 routing instructions when the Host cannot run Plugins or MCP. Explicit Skill Lock and usage disclosure remain; durable runtime guarantees do not.

Runtime label: skill-only-fallback
Current source includes: SKILL.md, assets/personal-routing-profile.example.json, assets/workspace-routing-profile.example.json, references/evaluation-boundary.md, references/goal-protocol.md, references/personal-routing-profiles.md, and references/routing-protocol.md
Excludes: Durable resume, cross-process CAS, sealed instrumentation

Use Skill only

Contributors and integrators

Source checkout

Use source when changing the policy core, transport, deterministic builders, documentation, or a Host adapter. Generated release files are never edited by hand.

Primary source: Git repository and pinned dependency locks
Build output: Ignored dist/release/
Verification: Core, MCP, docs, site, install, SBOM, provenance

View source on GitHub

The v2.0.2 Plugin and Skill-only packages both include the strict Personal and Workspace Routing Profile examples. Skill-only can read fixed local Profile paths only when the Host grants filesystem access.

Marketplace install

For normal installations, pin the published immutable marketplace snapshot:

codex plugin marketplace add eric861129/Workflow-skill-router --ref v2.0.2
codex plugin add workflow-skill-router@workflow-skill-router
codex plugin list

Contributors who are changing the Router can install from a checkout instead:

git clone https://github.com/eric861129/Workflow-skill-router.git
Set-Location Workflow-skill-router
codex plugin marketplace add .
codex plugin add workflow-skill-router@workflow-skill-router

Offline inspection assets

Use the immutable v2.0.2 GitHub Release assets instead of mutable raw/main/downloads files.

The ZIPs are for offline inspection and fallback installation. Verify published checksums, SBOM, and provenance before use. Do not treat a local prerelease build as a published asset.

Verify after installation

For a marketplace installation, verify that Codex sees the Plugin, restart Codex, then open a new task and ask it to show the Workflow Skill Router status:

codex plugin list

For an extracted Plugin package, run from the extracted Plugin root:

python runtime/workflow_skill_router.pyz doctor

Repository contributors run the same check from the repository root:

python plugins/workflow-skill-router/runtime/workflow_skill_router.pyz doctor

Expected bundled result: runtime_profile is bundled-local-r0, telemetry is disabled, and plan_work, propose_support_consent, transition_support_consent, and get_router_status are local-ready. Continue with the V2 Quickstart.