Shared Executor
Run Pi, Claude Code, OpenCode, Cursor, and OMX with one Statewright workflow and delivery owner
Shared Executor
statewright-exec gives supported terminal agents the same workflow ownership contract. It owns the Statewright API credential, remote MCP session, isolated delivery worktrees, and telemetry. The child TUI receives an authenticated loopback bridge and native host integration instead of a copy of the remote credential.
node plugins/executor/statewright-exec.mjs \
--host pi \
--workflow agentic-delivery \
--cwd /path/to/project \
-- "Implement and validate the change"Supported host names are pi, claude, opencode, cursor, and omx. Use --plugins-root or STATEWRIGHT_PLUGINS_ROOT if the adapter directories are not siblings of plugins/executor.
Capability Matrix
| Host | Tool enforcement | Continuation | Model and effort route |
|---|---|---|---|
| Pi | Native extension | Same session | Live |
| OpenCode | Native plugin | Same session | Live per message |
| Claude Code | Native hooks | Resume same session | Restart on route change |
| Cursor Agent | Native hooks | Resume executor-created chat | Restart on route change |
| OMX | Codex-native hooks | Host-managed | Startup |
Codex uses its app-server adapter and the same delivery core. OMX has hard tool enforcement and executor-owned transport, but no proven same-session route-change API; Statewright does not claim live routing there.
Isolated Delivery
Add .statewright/delivery.json to enable clean worktrees and project-owned Taskfile hooks for preview setup, deployment, validation, promotion, and cleanup. The executor pins the hook bundle, restricts the hook environment, journals promotion, and refuses workflows that require isolated delivery when no verified executor owns it.
The configuration file is the feature switch. Set "enabled": false to keep the executor active without isolated delivery.