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.39.tar.gz (388.6 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.39-py3-none-any.whl (338.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claude_org_runtime-0.1.39.tar.gz
  • Upload date:
  • Size: 388.6 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.39.tar.gz
Algorithm Hash digest
SHA256 f0fb973f92c3cb6b7292d175431f529a5b3dd8a8355a63d90add88587612c7a4
MD5 8774fe95aed917af3363ef9695f1cbf3
BLAKE2b-256 f05fa373d193211fbdeb58e8a5be15d74e7cab0e3f7a74f839743ccdedf0ab79

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for claude_org_runtime-0.1.39-py3-none-any.whl
Algorithm Hash digest
SHA256 7f8380dc24629241d57d7a375c78c175c21d258873648d7aa99810fecebca08c
MD5 6c4927a9781b68a17ca0586eaa011f96
BLAKE2b-256 2fca0e5c5f64a99af5d51ef1b72296a0bccf50bd1ca80646e23a8950d9bb8e6c

See more details on using hashes here.

Provenance

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