claude-org-runtime
Python runtime extracted from claude-org-ja for Claude Code orchestrator setups using renga panes. Sibling of core-harness; provides a dispatcher runner, state schema, and reference role prompts (secretary / dispatcher / curator).
Not an AI agent framework — this is plumbing for human-driven Claude Code orchestrator workflows, not an autonomous-agent toolkit.
Status
0.1.0: dispatcher runner + settings generator + reference role
prompts + state schema + v1->v2 polymorphic migrate. This is the first
release that consumers (notably claude-org-ja) can pip install to
replace their in-tree tools/dispatcher_runner.py /
tools/generate_worker_settings.py / tools/role_configs_schema.json.
Install
pip install claude-org-runtime==0.1.0
For local development:
git clone https://github.com/suisya-systems/claude-org-runtime
cd claude-org-runtime
python -m pip install -e .[dev]
Quick start
The single-command front door brings up a whole orchestrator session:
# Start the broker daemon, mint a secretary token, write its mcp-config,
# and drop you into an interactive Claude Code TUI — one command:
claude-org-runtime org up
# Tear it back down: close residual broker panes, request a signal-free
# shutdown, verify it stopped, and clean up the sidecar:
claude-org-runtime org down
org up is reuse-or-start: a reachable daemon is reused, a stale sidecar
is replaced. The lower-level building blocks are still available directly:
# Render a per-role settings.local.json:
claude-org-runtime settings generate \
--role default \
--worker-dir /path/to/worker \
--claude-org-path /path/to/claude-org \
--out /path/to/worker/.claude/settings.local.json
# Compute a Dispatcher delegation action plan:
claude-org-runtime dispatcher delegate-plan \
--task-json .state/dispatcher/inbox/<task_id>.json \
--panes-json panes.json \
--state-dir .state
See docs/cli.md for the full CLI reference, the org up /
org down flags, and the migration recipe for claude-org-ja consumers.
Broker
The broker is a renga-free transport for orchestrator sessions: a localhost
MCP daemon plus a persisted queue and a terminal adapter (tmux / wezterm /
herdr backends; herdr is opt-in and POSIX / WSL-only, not supported on
native Windows). Agents talk to it over plain HTTP MCP instead of a renga tab, so
a session can run without the renga UI. It is billing-neutral by design —
it only ever launches the interactive Claude Code TUI through a builder
that rejects headless flags. org up / org down are a thin launcher over
this control plane (the daemon.json sidecar + admin RPC); see
docs/cli.md for details.
herdr version requirement: using herdr 0.7.5 or newer as the backend
requires claude-org-runtime 0.1.38 or newer. herdr 0.7.5 (wire protocol 17)
rewrote the agent.start API in a breaking way; earlier runtime releases only
speak the protocol 14 / 16 shape and fail to spawn against it. Runtime 0.1.38
keeps the legacy path, so herdr 0.7.1-0.7.4 (protocol 14 / 16) still work
unchanged. A permanently unsupported protocol is rejected at startup with
herdr_protocol_unsupported rather than failing silently.
Reference role prompts
The runtime ships English reference prompts for the three roles used in
the claude-org-ja reference organization (secretary, dispatcher,
curator):
from claude_org_runtime.prompts import load, load_meta
prompt = load("dispatcher") # raw markdown, frontmatter included
meta = load_meta("dispatcher") # {'role': 'dispatcher', 'source': ..., 'status': ...}
These are reference, not prescriptive. They capture one working
configuration from claude-org-ja, not an "agent framework" opinion.
Consumers are expected to load them as a starting point and then override
or rewrite sections from their own project-root CLAUDE.md (or skill
files) to match their organization's conventions, terminology, and slash
commands.
Related
- core-harness — sibling repo with reusable safety primitives for Claude Code harnesses.
- claude-org-ja#129 — tracking issue for the extraction effort that produced this runtime.
- Issues for this repo.
License
MIT — see LICENSE.
1 maintainer
Release files for claude-org-runtime 0.1.44
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| claude_org_runtime-0.1.44.tar.gz | 441.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_org_runtime-0.1.44-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 827.0 kB
Release files / claude_org_runtime-0.1.44.tar.gz
| Download URL | claude_org_runtime-0.1.44.tar.gz |
|---|---|
| Size | 441.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
046121f1187c7907d407581f7629c86d5589abc72a2f311d61d4a35ed035ede9
|
|
BLAKE2b-256 checksum How to use checksums |
c6aa2d207a200398dd2edd5b805ce6fa225670ecdd911aeca8d07dd0acea0d80
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / claude_org_runtime-0.1.44-py3-none-any.whl
| Download URL | claude_org_runtime-0.1.44-py3-none-any.whl |
|---|---|
| Size | 385.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0637c6d0120ec6f3a9351a52570b793a23e8b16568c3beb7db70d40f8b8cb846
|
|
BLAKE2b-256 checksum How to use checksums |
d93ff5caf7d5500b22373ab73f2b738af6c836879b20e8248b79e09f9d2ca355
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
