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.

Project links

Data verified by PyPI on Aug 14, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for happy_ryo from gravatar.com happy_ryo

Credits

Author: suisya-systems

GitHub Statistics

Data verified by PyPI on Aug 14, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_org_runtime-0.1.42.tar.gz (427.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_org_runtime-0.1.42-py3-none-any.whl (377.6 kB view details)

Uploaded Python 3

File details

Details for the file claude_org_runtime-0.1.42.tar.gz.

File metadata

  • Download URL: claude_org_runtime-0.1.42.tar.gz
  • Upload date:
  • Size: 427.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for claude_org_runtime-0.1.42.tar.gz
Algorithm Hash digest
SHA256 f57d341d54cd8e4d22d22652fe5359e7debea676737aec2209d42368420423f2
MD5 b75a241d6d417ae2d7e8b8fac71b5cb3
BLAKE2b-256 36679fc1333132459baf5cd8e4b2e623e29f8d733a6bac15dd48ec08af36bf21

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_org_runtime-0.1.42.tar.gz:

Publisher: release.yml on suisya-systems/claude-org-runtime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file claude_org_runtime-0.1.42-py3-none-any.whl.

File metadata

File hashes

Hashes for claude_org_runtime-0.1.42-py3-none-any.whl
Algorithm Hash digest
SHA256 de2b0512e517706f5a7514852f25bfc121cf90d0cb5e8b44975893c098fc88ef
MD5 34effb7f51242fb010017a27c3603c0d
BLAKE2b-256 4719f101efe1812cbd094da94fa7f07edcc57d57a4584e79c43dbbc0a1364809

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_org_runtime-0.1.42-py3-none-any.whl:

Publisher: release.yml on suisya-systems/claude-org-runtime

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.42 This release

2 files

0.1.41

2 files

0.1.40

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.33

2 files

0.1.32

2 files

0.1.31

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page