Skip to main content

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.

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.40.tar.gz (406.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.40-py3-none-any.whl (356.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claude_org_runtime-0.1.40.tar.gz
  • Upload date:
  • Size: 406.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.40.tar.gz
Algorithm Hash digest
SHA256 f8f8c1e9e6ed99550228163f7c49d9f764e37af5b384555743554f1029bb2e72
MD5 52556668b7755d16a3668627a48832e8
BLAKE2b-256 d85c41503dd001d222198cd999c9524f4ca4478487d9334f7cf71aa1b8408f52

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_org_runtime-0.1.40.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.40-py3-none-any.whl.

File metadata

File hashes

Hashes for claude_org_runtime-0.1.40-py3-none-any.whl
Algorithm Hash digest
SHA256 4e41f48c69dea875f8cca9737117b172fdbf6e291d068fbfb83168cfbf7ded70
MD5 ddad89a6d4c0c7202b1629556d4b7a54
BLAKE2b-256 64fa36c55e42e5615c77412e0129a948bb43f78779fc235a8fa62752bcaf609c

See more details on using hashes here.

Provenance

The following attestation bundles were made for claude_org_runtime-0.1.40-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.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page