cc-orchestrate 0.1.0__tar.gz

cc_orchestrate-0.1.0/LICENSE

@@ -0,0 +1,133 @@
+Required Notice: Copyright Yasyf Mohamedali (https://github.com/yasyf/cc-orchestrate)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

cc_orchestrate-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: cc-orchestrate
+Version: 0.1.0
+Summary: Orchestrate fleets of Claude Code agents across pluggable backends like cmux and superset.
+Keywords: 
+Author: Yasyf Mohamedali
+Author-email: Yasyf Mohamedali <yasyfm@gmail.com>
+License-Expression: PolyForm-Noncommercial-1.0.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Dist: click>=8
+Requires-Dist: loguru>=0.7
+Requires-Dist: anyio>=4 ; extra == 'dev'
+Requires-Dist: pytest>=8.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.8 ; extra == 'dev'
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/yasyf/cc-orchestrate
+Project-URL: Documentation, https://yasyf.github.io/cc-orchestrate/
+Project-URL: Repository, https://github.com/yasyf/cc-orchestrate
+Project-URL: Issues, https://github.com/yasyf/cc-orchestrate/issues
+Project-URL: Changelog, https://github.com/yasyf/cc-orchestrate/blob/main/CHANGELOG.md
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# cc-orchestrate
+
+![cc-orchestrate banner](https://github.com/yasyf/cc-orchestrate/raw/main/docs/assets/readme-banner.webp)
+
+[![PyPI](https://img.shields.io/pypi/v/cc-orchestrate.svg)](https://pypi.org/project/cc-orchestrate/)
+[![Python](https://img.shields.io/pypi/pyversions/cc-orchestrate.svg)](https://pypi.org/project/cc-orchestrate/)
+[![Docs](https://img.shields.io/github/actions/workflow/status/yasyf/cc-orchestrate/docs.yml?branch=main&label=docs)](https://yasyf.github.io/cc-orchestrate/)
+[![License: PolyForm-Noncommercial-1.0.0](https://img.shields.io/badge/License-PolyForm-Noncommercial-1.0.0-blue.svg)](https://github.com/yasyf/cc-orchestrate/blob/main/LICENSE)
+
+Orchestrate fleets of Claude Code agents across pluggable backends like cmux and superset.
+
+cc-orchestrate is a CLI for running fleets of Claude Code agents from one seat
+instead of a sprawl of terminal tabs. Backends are pluggable: the same
+orchestration drives agents living in cmux sessions, superset worktrees, or
+whatever runner you wire in next, so fleet logic never cares where an agent
+actually executes.
+
+## Install
+
+No install needed — run everything through [uvx](https://docs.astral.sh/uv/):
+
+```bash
+uvx cc-orchestrate --help
+```
+
+`uvx` fetches cc-orchestrate into a throwaway environment and runs it. To add it
+to a project instead:
+
+```bash
+uv add cc-orchestrate
+```
+
+## Quickstart
+
+Check which backends are installed on your machine:
+
+```bash
+uvx cc-orchestrate backends
+```
+
+```
+cmux	available
+superset	available
+```
+
+A backend reports `not found` when its CLI is missing from your `PATH`.
+Install the runner and re-run the check.
+
+## What problems does this solve?
+
+- Running more than a couple of Claude Code agents means babysitting a sprawl
+  of terminal tabs and tmux panes by hand. cc-orchestrate gives the whole
+  fleet one front door.
+- Every runner has its own invocation quirks — cmux sessions, superset
+  worktrees, plain terminals. Backends absorb those differences, so what you
+  dispatch stays portable across them.
+- Knowing what a machine can even run is guesswork. `cc-orchestrate backends`
+  reports which runners are installed before you dispatch anything.
+
+## Docs
+
+[Read the docs](https://yasyf.github.io/cc-orchestrate/) for the full guide and API reference.

cc_orchestrate-0.1.0/README.md

@@ -0,0 +1,62 @@
+# cc-orchestrate
+
+![cc-orchestrate banner](https://github.com/yasyf/cc-orchestrate/raw/main/docs/assets/readme-banner.webp)
+
+[![PyPI](https://img.shields.io/pypi/v/cc-orchestrate.svg)](https://pypi.org/project/cc-orchestrate/)
+[![Python](https://img.shields.io/pypi/pyversions/cc-orchestrate.svg)](https://pypi.org/project/cc-orchestrate/)
+[![Docs](https://img.shields.io/github/actions/workflow/status/yasyf/cc-orchestrate/docs.yml?branch=main&label=docs)](https://yasyf.github.io/cc-orchestrate/)
+[![License: PolyForm-Noncommercial-1.0.0](https://img.shields.io/badge/License-PolyForm-Noncommercial-1.0.0-blue.svg)](https://github.com/yasyf/cc-orchestrate/blob/main/LICENSE)
+
+Orchestrate fleets of Claude Code agents across pluggable backends like cmux and superset.
+
+cc-orchestrate is a CLI for running fleets of Claude Code agents from one seat
+instead of a sprawl of terminal tabs. Backends are pluggable: the same
+orchestration drives agents living in cmux sessions, superset worktrees, or
+whatever runner you wire in next, so fleet logic never cares where an agent
+actually executes.
+
+## Install
+
+No install needed — run everything through [uvx](https://docs.astral.sh/uv/):
+
+```bash
+uvx cc-orchestrate --help
+```
+
+`uvx` fetches cc-orchestrate into a throwaway environment and runs it. To add it
+to a project instead:
+
+```bash
+uv add cc-orchestrate
+```
+
+## Quickstart
+
+Check which backends are installed on your machine:
+
+```bash
+uvx cc-orchestrate backends
+```
+
+```
+cmux	available
+superset	available
+```
+
+A backend reports `not found` when its CLI is missing from your `PATH`.
+Install the runner and re-run the check.
+
+## What problems does this solve?
+
+- Running more than a couple of Claude Code agents means babysitting a sprawl
+  of terminal tabs and tmux panes by hand. cc-orchestrate gives the whole
+  fleet one front door.
+- Every runner has its own invocation quirks — cmux sessions, superset
+  worktrees, plain terminals. Backends absorb those differences, so what you
+  dispatch stays portable across them.
+- Knowing what a machine can even run is guesswork. `cc-orchestrate backends`
+  reports which runners are installed before you dispatch anything.
+
+## Docs
+
+[Read the docs](https://yasyf.github.io/cc-orchestrate/) for the full guide and API reference.

cc_orchestrate-0.1.0/cc_orchestrate/__init__.py

@@ -0,0 +1,3 @@
+"""Orchestrate fleets of Claude Code agents across pluggable backends like cmux and superset."""
+
+from __future__ import annotations

cc_orchestrate-0.1.0/cc_orchestrate/__main__.py

@@ -0,0 +1,6 @@
+from __future__ import annotations
+
+from cc_orchestrate.cli import main
+
+if __name__ == "__main__":
+    main()

cc_orchestrate-0.1.0/cc_orchestrate/cli.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import shutil
+
+import click
+
+BACKENDS = ("cmux", "superset")
+
+
+@click.group()
+@click.version_option(package_name="cc-orchestrate")
+def main() -> None:
+    """Orchestrate fleets of Claude Code agents across pluggable backends like cmux and superset."""
+
+
+@main.command()
+def backends() -> None:
+    """List supported backends and whether each is installed on this machine."""
+    for name in BACKENDS:
+        path = shutil.which(name)
+        click.echo(f"{name}\t{'available' if path else 'not found'}")

cc_orchestrate-0.1.0/pyproject.toml

@@ -0,0 +1,112 @@
+[project]
+name = "cc-orchestrate"
+version = "0.1.0"
+description = "Orchestrate fleets of Claude Code agents across pluggable backends like cmux and superset."
+readme = "README.md"
+license = "PolyForm-Noncommercial-1.0.0"
+license-files = ["LICENSE"]
+authors = [{ name = "Yasyf Mohamedali", email = "yasyfm@gmail.com" }]
+keywords = []
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Typing :: Typed",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "click>=8",
+    "loguru>=0.7",
+]
+
+[project.optional-dependencies]
+dev = [
+    "anyio>=4",
+    "pytest>=8.0",
+    "ruff>=0.8",
+]
+
+[project.scripts]
+cc-orchestrate = "cc_orchestrate.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/yasyf/cc-orchestrate"
+Documentation = "https://yasyf.github.io/cc-orchestrate/"
+Repository = "https://github.com/yasyf/cc-orchestrate"
+Issues = "https://github.com/yasyf/cc-orchestrate/issues"
+Changelog = "https://github.com/yasyf/cc-orchestrate/blob/main/CHANGELOG.md"
+
+[build-system]
+requires = ["uv_build>=0.11,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "cc_orchestrate"
+module-root = ""
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+anyio_mode = "auto"
+addopts = ["-ra", "--strict-markers", "--tb=short", "-q"]
+markers = [
+    "unit: Pure unit tests",
+    "integration: Integration tests",
+]
+
+# ty (Astral) is the default type checker. It runs on every commit via the prek
+# hook (astral-sh/ty-pre-commit — the hook rev pins the ty version) and in CI,
+# warnings only, never blocking. Ad hoc: `uvx prek run ty --all-files`.
+# It is fast, understands modern syntax, and avoids the strict-pyright false
+# positives on pydantic/attrs-style dynamic defaults and PK-type overrides.
+[tool.ty.rules]
+# Every diagnostic surfaces as a warning: ty exits 0 and never blocks a commit or CI.
+all = "warn"
+# Keep cross-checker `# type: ignore` / `# pyright: ignore` comments from tripping ty.
+unused-type-ignore-comment = "ignore"
+unresolved-import = "ignore"
+
+# pyright is kept as a secondary checker (editors / `uvx pyright`). Basic mode plus
+# a few disables covers the noise; ty is the default checker, surfaced as warnings
+# at commit time and in CI.
+[tool.pyright]
+pythonVersion = "3.13"
+typeCheckingMode = "basic"
+include = ["cc_orchestrate"]
+venvPath = "."
+venv = ".venv"
+reportImplicitOverride = "none"
+reportIncompatibleVariableOverride = "none"
+reportUnknownVariableType = "none"
+reportUnknownMemberType = "none"
+reportUnknownArgumentType = "none"
+reportUnknownParameterType = "none"
+reportUnknownLambdaType = "none"
+reportMissingTypeArgument = "none"
+reportPrivateImportUsage = "none"
+reportUnusedCallResult = "none"
+
+[tool.ruff]
+line-length = 120
+target-version = "py313"
+src = [".", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+
+[tool.ruff.lint.per-file-ignores]
+# __init__.py re-exports the public API via plain imports (`from .foo import
+# Bar`; no `as` alias, no __all__). F401 stays active in every other module.
+"__init__.py" = ["F401"]
+
+[dependency-groups]
+docs = [
+    # great-docs imports griffe's 2.x module layout; griffelib is the modern
+    # griffe (2.x) distribution, overriding the legacy griffe<2 pin great-docs
+    # itself still declares.
+    "griffelib>=2.0",
+    # 0.13.1+ carries build-time GitHub widget stats (embedded via the CI
+    # GITHUB_TOKEN), so the navbar widget makes no client-side API calls.
+    "great-docs>=0.13.1",
+]