spartito 0.1.0__tar.gz

spartito-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spartito contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

spartito-0.1.0/PKG-INFO

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: spartito
+Version: 0.1.0
+Summary: Run Claude Code and Codex agents in parallel, each in its own git worktree, steered through one orchestrator agent
+Keywords: agents,ai,claude-code,codex,coding-agents,git-worktree,mcp,orchestration
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Dist: anyio>=4.16.0
+Requires-Dist: mcp>=2.3.0
+Requires-Dist: starlette>=1.10.0
+Requires-Dist: typer>=0.29.0
+Requires-Dist: uvicorn>=0.54.0
+Requires-Dist: pywebview>=6.2 ; sys_platform == 'darwin' and extra == 'app'
+Requires-Dist: pyobjc-framework-usernotifications>=13.0 ; sys_platform == 'darwin' and extra == 'app'
+Requires-Dist: pywebview[qt]>=6.2 ; sys_platform == 'linux' and extra == 'app'
+Requires-Dist: pyobjc-framework-cocoa>=13.0 ; sys_platform == 'darwin' and extra == 'menubar'
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/foszto/spartito
+Project-URL: Repository, https://github.com/foszto/spartito
+Project-URL: Issues, https://github.com/foszto/spartito/issues
+Project-URL: Documentation, https://github.com/foszto/spartito/tree/master/docs
+Provides-Extra: app
+Provides-Extra: menubar
+Description-Content-Type: text/markdown
+
+# Spartito
+
+Spartito runs Claude Code and Codex agents headless and in parallel, each in its own git
+worktree and branch. You steer them through one orchestrator agent (shown as *Maestro*) from a
+web dashboard or the command line, instead of managing many terminal sessions by hand. It is
+for developers who already use Claude Code or Codex and want several agents working on their
+repositories at once.
+
+```
+you ── orchestrator (Maestro)
+        └─ project ── project lead (in the project's main checkout)
+                        ├─ worker    (own git worktree, branch orch/<agent-id>)
+                        ├─ reviewer  (reads the worker's worktree after it finishes)
+                        └─ ...
+```
+
+The command is `spartito`; the Python package is `orchestrator`. The internal names stay as they
+were: the `orch` MCP server and its tools, the `ORCH_*` variables, `orch.db` and the agents'
+`orch/` branches.
+
+## Features
+
+- One conversation with an orchestrator agent that briefs a project lead per project; leads
+  start and coordinate their own agents.
+- Agents run headless (`claude -p`, `codex exec`) in parallel, each in its own git worktree and
+  branch, or in a worktree shared with another agent (review, test, fix).
+- Packaged roles: orchestrator, lead, planner, worker, reviewer, tester; custom roles are
+  Markdown files.
+- Results travel up automatically: a parent is woken with its agents' answers when they are
+  done; tasks can depend on each other and embed another agent's answer.
+- Web dashboard: conversations, tool calls, queued messages, model and effort per agent,
+  context size, tokens and cost.
+- Model and effort per tier (orchestrator, lead, worker), per provider, globally or per
+  project; per-agent overrides.
+- Persistent task board per project, and a list of decisions that wait for you.
+- Automatic compaction of long conversations, automatic archiving of finished agents, keeping
+  the machine awake while agents work, desktop notifications.
+- The dashboard as a desktop application: a background service, an installable page,
+  notifications whose click opens the agent or decision, and its own window (`spartito app`).
+- No daemon: every turn is its own process; all state is in one SQLite database.
+
+## Requirements
+
+- macOS or Linux (see [Platform support](https://github.com/foszto/spartito#platform-support)).
+- Python 3.14 and [uv](https://docs.astral.sh/uv/).
+- `git`.
+- The `claude` (Claude Code) CLI, installed and logged in, and optionally the `codex` CLI.
+  The defaults use Claude Code: the orchestrator agent, `spartito chat`, and every project
+  registered without `--provider`, so the quick start below needs `claude`. A Codex-only or
+  mixed setup is configured per project and per agent:
+  [docs/configuration.md](https://github.com/foszto/spartito/blob/master/docs/configuration.md#providers-and-permissions).
+
+## Installation
+
+From a checkout of this repository, the recommended install:
+
+```sh
+uv tool install --editable '.[app,menubar]'    # puts `spartito` on the PATH
+spartito --help
+```
+
+The extras bring the native window of `spartito app` (`app`) and the macOS menu-bar item
+(`menubar`; nothing on Linux). On Linux, `app` pulls in PyQt6, which is GPL-3.0-only: see
+[docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md#optional-dependencies).
+
+Alternatives: `uv tool install --editable .` without the extras (`spartito app` then opens a
+browser window, and on macOS notifications do not come from Spartito itself), or no install
+at all, prefixing every command with `uv run` inside the checkout (`uv run spartito …`).
+Installed before the command was renamed? See
+[Upgrading from `orch`](https://github.com/foszto/spartito/blob/master/docs/usage.md#upgrading-from-orch). Installed from a checkout before the distribution was renamed
+to `spartito`? See
+[Upgrading to the distribution name `spartito`](https://github.com/foszto/spartito/blob/master/docs/usage.md#upgrading-to-the-distribution-name-spartito).
+
+Spartito keeps its state in `~/.orchestrator/`. Set `ORCH_HOME` to use another directory.
+
+## Quick start
+
+Register a git repository as a project. Its currently checked-out branch becomes the
+project's base branch, from which agent branches start:
+
+```sh
+spartito project add ~/src/my-app
+# added my-app  /home/dev/src/my-app  (base branch: main)
+```
+
+**Through the orchestrator.** The recommended way: the dashboard as a background service, and
+Spartito as an application:
+
+```sh
+spartito service install   # dashboard at http://127.0.0.1:8787, in the background and at login
+spartito app install       # a launcher with Spartito's own name and icon
+spartito app               # or open Spartito like any application
+```
+
+The service is a launchd agent on macOS and a systemd user unit on Linux, restarted when it
+fails. The launcher is `~/Applications/Spartito.app` on macOS and a desktop entry on Linux;
+notifications come from Spartito, and a click opens the agent or decision (macOS: once
+Spartito is allowed to notify; Linux: with libnotify 0.7.10 or later). Both are undone with
+`spartito service uninstall` and `spartito app uninstall`. The dashboard has no login: keep it
+on the loopback address (the default), as anyone who can reach it controls agents that run
+code ([docs/usage.md](https://github.com/foszto/spartito/blob/master/docs/usage.md#dashboard)). Details per platform:
+[docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md).
+
+Without the service or the window (or where no window is available): `spartito web` serves
+the dashboard at `http://127.0.0.1:8787` until Ctrl-C; open it in a browser.
+
+Select **Maestro** and describe the goal, for example: *"In my-app, fix the login redirect
+loop. Have a worker implement it with Claude and a reviewer check it with Codex."* The
+orchestrator passes the brief to the project lead, which starts the agents. They appear in the
+left-hand list as they start; click one to follow its conversation. When the lead's agents are
+done, the lead reports to the orchestrator, which reports to you. Alternatively, `spartito chat`
+opens the orchestrator as an interactive Claude Code session in the terminal: a separate
+conversation with the same tools and the same state.
+
+**Directly from the command line.**
+
+```sh
+spartito spawn -p my-app -n fix-login "Fix the redirect loop after login. Add a regression test."
+# fix-login-3f2a  run 1  /home/dev/.orchestrator/worktrees/my-app/fix-login-3f2a
+
+spartito logs fix-login-3f2a -f     # follow what it does
+spartito wait fix-login-3f2a        # block until it is done
+spartito status fix-login-3f2a      # result, commits and changes in its worktree
+```
+
+The worker commits on branch `orch/fix-login-3f2a`. Review and merge it yourself; agents do
+not merge:
+
+```sh
+cd ~/src/my-app
+git log --oneline main..orch/fix-login-3f2a
+git merge orch/fix-login-3f2a
+spartito archive fix-login-3f2a     # hide it from the lists; everything is kept
+```
+
+## How it fits together
+
+Every agent is a headless Claude Code or Codex session with a role. A message to an agent
+starts a *turn*: `spartito`, the dashboard or the MCP server records it in a SQLite database
+under `~/.orchestrator/` and starts one detached runner process, which runs the CLI in the
+agent's worktree and records its output as events. The orchestrator and the project leads
+get the `orch` MCP tools to start agents, wait for them, keep the task board and ask you for
+decisions; when an agent and its sub-agents are done, their parent receives their answers in
+an automatic notification turn. The command line, the dashboard, the desktop window and the
+MCP tools are views on the same database. More: [docs/concepts.md](https://github.com/foszto/spartito/blob/master/docs/concepts.md),
+[docs/architecture.md](https://github.com/foszto/spartito/blob/master/docs/architecture.md).
+
+## Documentation
+
+- [docs/concepts.md](https://github.com/foszto/spartito/blob/master/docs/concepts.md): orchestrator, leads, roles, worktrees, turns, results.
+- [docs/usage.md](https://github.com/foszto/spartito/blob/master/docs/usage.md): every command and option, and the dashboard.
+- [docs/agents.md](https://github.com/foszto/spartito/blob/master/docs/agents.md): MCP tools, queue, dependencies, notifications, decisions, archiving, compaction, cost.
+- [docs/configuration.md](https://github.com/foszto/spartito/blob/master/docs/configuration.md): model and effort, settings, loadout, roles, providers, files.
+- [docs/board.md](https://github.com/foszto/spartito/blob/master/docs/board.md): the task board across projects.
+- [docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md): background service, installable page, notifications, `spartito app`, menu bar.
+- [docs/desktop-checklist.md](https://github.com/foszto/spartito/blob/master/docs/desktop-checklist.md): manual checks of the desktop app.
+- [docs/architecture.md](https://github.com/foszto/spartito/blob/master/docs/architecture.md): how it works at run time, limitations, code layout.
+- [docs/releasing.md](https://github.com/foszto/spartito/blob/master/docs/releasing.md): the version, publishing to PyPI, the release workflow.
+- [CONTRIBUTING.md](https://github.com/foszto/spartito/blob/master/CONTRIBUTING.md): setup, checks, conventions, pull requests, bug reports.
+- [ROADMAP.md](https://github.com/foszto/spartito/blob/master/ROADMAP.md): where Spartito is heading, in phases, with the open questions.
+
+## Platform support
+
+Developed and used on macOS; Linux is supported, with parts not yet tested on a real machine;
+Windows is not supported (process handling relies on POSIX process groups and sessions).
+Details and other limitations:
+[docs/architecture.md](https://github.com/foszto/spartito/blob/master/docs/architecture.md#platform-support-and-limitations); the desktop
+features per platform: [docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md#platform-support).
+
+## Development
+
+```sh
+uv sync
+uv run pytest                  # uses a fake provider and real git worktrees; no claude/codex calls
+uv run pytest -n auto          # the same in parallel (pytest-xdist): about 6x faster, the usual way
+uv run ruff check . && uv run ruff format --check .
+node --check src/orchestrator/web/static/app.js
+```
+
+How to contribute, the checks a change must pass and how to report a bug:
+[CONTRIBUTING.md](https://github.com/foszto/spartito/blob/master/CONTRIBUTING.md).
+
+## License
+
+MIT, see [LICENSE](https://github.com/foszto/spartito/blob/master/LICENSE).

spartito-0.1.0/README.md

@@ -0,0 +1,185 @@
+# Spartito
+
+Spartito runs Claude Code and Codex agents headless and in parallel, each in its own git
+worktree and branch. You steer them through one orchestrator agent (shown as *Maestro*) from a
+web dashboard or the command line, instead of managing many terminal sessions by hand. It is
+for developers who already use Claude Code or Codex and want several agents working on their
+repositories at once.
+
+```
+you ── orchestrator (Maestro)
+        └─ project ── project lead (in the project's main checkout)
+                        ├─ worker    (own git worktree, branch orch/<agent-id>)
+                        ├─ reviewer  (reads the worker's worktree after it finishes)
+                        └─ ...
+```
+
+The command is `spartito`; the Python package is `orchestrator`. The internal names stay as they
+were: the `orch` MCP server and its tools, the `ORCH_*` variables, `orch.db` and the agents'
+`orch/` branches.
+
+## Features
+
+- One conversation with an orchestrator agent that briefs a project lead per project; leads
+  start and coordinate their own agents.
+- Agents run headless (`claude -p`, `codex exec`) in parallel, each in its own git worktree and
+  branch, or in a worktree shared with another agent (review, test, fix).
+- Packaged roles: orchestrator, lead, planner, worker, reviewer, tester; custom roles are
+  Markdown files.
+- Results travel up automatically: a parent is woken with its agents' answers when they are
+  done; tasks can depend on each other and embed another agent's answer.
+- Web dashboard: conversations, tool calls, queued messages, model and effort per agent,
+  context size, tokens and cost.
+- Model and effort per tier (orchestrator, lead, worker), per provider, globally or per
+  project; per-agent overrides.
+- Persistent task board per project, and a list of decisions that wait for you.
+- Automatic compaction of long conversations, automatic archiving of finished agents, keeping
+  the machine awake while agents work, desktop notifications.
+- The dashboard as a desktop application: a background service, an installable page,
+  notifications whose click opens the agent or decision, and its own window (`spartito app`).
+- No daemon: every turn is its own process; all state is in one SQLite database.
+
+## Requirements
+
+- macOS or Linux (see [Platform support](https://github.com/foszto/spartito#platform-support)).
+- Python 3.14 and [uv](https://docs.astral.sh/uv/).
+- `git`.
+- The `claude` (Claude Code) CLI, installed and logged in, and optionally the `codex` CLI.
+  The defaults use Claude Code: the orchestrator agent, `spartito chat`, and every project
+  registered without `--provider`, so the quick start below needs `claude`. A Codex-only or
+  mixed setup is configured per project and per agent:
+  [docs/configuration.md](https://github.com/foszto/spartito/blob/master/docs/configuration.md#providers-and-permissions).
+
+## Installation
+
+From a checkout of this repository, the recommended install:
+
+```sh
+uv tool install --editable '.[app,menubar]'    # puts `spartito` on the PATH
+spartito --help
+```
+
+The extras bring the native window of `spartito app` (`app`) and the macOS menu-bar item
+(`menubar`; nothing on Linux). On Linux, `app` pulls in PyQt6, which is GPL-3.0-only: see
+[docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md#optional-dependencies).
+
+Alternatives: `uv tool install --editable .` without the extras (`spartito app` then opens a
+browser window, and on macOS notifications do not come from Spartito itself), or no install
+at all, prefixing every command with `uv run` inside the checkout (`uv run spartito …`).
+Installed before the command was renamed? See
+[Upgrading from `orch`](https://github.com/foszto/spartito/blob/master/docs/usage.md#upgrading-from-orch). Installed from a checkout before the distribution was renamed
+to `spartito`? See
+[Upgrading to the distribution name `spartito`](https://github.com/foszto/spartito/blob/master/docs/usage.md#upgrading-to-the-distribution-name-spartito).
+
+Spartito keeps its state in `~/.orchestrator/`. Set `ORCH_HOME` to use another directory.
+
+## Quick start
+
+Register a git repository as a project. Its currently checked-out branch becomes the
+project's base branch, from which agent branches start:
+
+```sh
+spartito project add ~/src/my-app
+# added my-app  /home/dev/src/my-app  (base branch: main)
+```
+
+**Through the orchestrator.** The recommended way: the dashboard as a background service, and
+Spartito as an application:
+
+```sh
+spartito service install   # dashboard at http://127.0.0.1:8787, in the background and at login
+spartito app install       # a launcher with Spartito's own name and icon
+spartito app               # or open Spartito like any application
+```
+
+The service is a launchd agent on macOS and a systemd user unit on Linux, restarted when it
+fails. The launcher is `~/Applications/Spartito.app` on macOS and a desktop entry on Linux;
+notifications come from Spartito, and a click opens the agent or decision (macOS: once
+Spartito is allowed to notify; Linux: with libnotify 0.7.10 or later). Both are undone with
+`spartito service uninstall` and `spartito app uninstall`. The dashboard has no login: keep it
+on the loopback address (the default), as anyone who can reach it controls agents that run
+code ([docs/usage.md](https://github.com/foszto/spartito/blob/master/docs/usage.md#dashboard)). Details per platform:
+[docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md).
+
+Without the service or the window (or where no window is available): `spartito web` serves
+the dashboard at `http://127.0.0.1:8787` until Ctrl-C; open it in a browser.
+
+Select **Maestro** and describe the goal, for example: *"In my-app, fix the login redirect
+loop. Have a worker implement it with Claude and a reviewer check it with Codex."* The
+orchestrator passes the brief to the project lead, which starts the agents. They appear in the
+left-hand list as they start; click one to follow its conversation. When the lead's agents are
+done, the lead reports to the orchestrator, which reports to you. Alternatively, `spartito chat`
+opens the orchestrator as an interactive Claude Code session in the terminal: a separate
+conversation with the same tools and the same state.
+
+**Directly from the command line.**
+
+```sh
+spartito spawn -p my-app -n fix-login "Fix the redirect loop after login. Add a regression test."
+# fix-login-3f2a  run 1  /home/dev/.orchestrator/worktrees/my-app/fix-login-3f2a
+
+spartito logs fix-login-3f2a -f     # follow what it does
+spartito wait fix-login-3f2a        # block until it is done
+spartito status fix-login-3f2a      # result, commits and changes in its worktree
+```
+
+The worker commits on branch `orch/fix-login-3f2a`. Review and merge it yourself; agents do
+not merge:
+
+```sh
+cd ~/src/my-app
+git log --oneline main..orch/fix-login-3f2a
+git merge orch/fix-login-3f2a
+spartito archive fix-login-3f2a     # hide it from the lists; everything is kept
+```
+
+## How it fits together
+
+Every agent is a headless Claude Code or Codex session with a role. A message to an agent
+starts a *turn*: `spartito`, the dashboard or the MCP server records it in a SQLite database
+under `~/.orchestrator/` and starts one detached runner process, which runs the CLI in the
+agent's worktree and records its output as events. The orchestrator and the project leads
+get the `orch` MCP tools to start agents, wait for them, keep the task board and ask you for
+decisions; when an agent and its sub-agents are done, their parent receives their answers in
+an automatic notification turn. The command line, the dashboard, the desktop window and the
+MCP tools are views on the same database. More: [docs/concepts.md](https://github.com/foszto/spartito/blob/master/docs/concepts.md),
+[docs/architecture.md](https://github.com/foszto/spartito/blob/master/docs/architecture.md).
+
+## Documentation
+
+- [docs/concepts.md](https://github.com/foszto/spartito/blob/master/docs/concepts.md): orchestrator, leads, roles, worktrees, turns, results.
+- [docs/usage.md](https://github.com/foszto/spartito/blob/master/docs/usage.md): every command and option, and the dashboard.
+- [docs/agents.md](https://github.com/foszto/spartito/blob/master/docs/agents.md): MCP tools, queue, dependencies, notifications, decisions, archiving, compaction, cost.
+- [docs/configuration.md](https://github.com/foszto/spartito/blob/master/docs/configuration.md): model and effort, settings, loadout, roles, providers, files.
+- [docs/board.md](https://github.com/foszto/spartito/blob/master/docs/board.md): the task board across projects.
+- [docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md): background service, installable page, notifications, `spartito app`, menu bar.
+- [docs/desktop-checklist.md](https://github.com/foszto/spartito/blob/master/docs/desktop-checklist.md): manual checks of the desktop app.
+- [docs/architecture.md](https://github.com/foszto/spartito/blob/master/docs/architecture.md): how it works at run time, limitations, code layout.
+- [docs/releasing.md](https://github.com/foszto/spartito/blob/master/docs/releasing.md): the version, publishing to PyPI, the release workflow.
+- [CONTRIBUTING.md](https://github.com/foszto/spartito/blob/master/CONTRIBUTING.md): setup, checks, conventions, pull requests, bug reports.
+- [ROADMAP.md](https://github.com/foszto/spartito/blob/master/ROADMAP.md): where Spartito is heading, in phases, with the open questions.
+
+## Platform support
+
+Developed and used on macOS; Linux is supported, with parts not yet tested on a real machine;
+Windows is not supported (process handling relies on POSIX process groups and sessions).
+Details and other limitations:
+[docs/architecture.md](https://github.com/foszto/spartito/blob/master/docs/architecture.md#platform-support-and-limitations); the desktop
+features per platform: [docs/desktop.md](https://github.com/foszto/spartito/blob/master/docs/desktop.md#platform-support).
+
+## Development
+
+```sh
+uv sync
+uv run pytest                  # uses a fake provider and real git worktrees; no claude/codex calls
+uv run pytest -n auto          # the same in parallel (pytest-xdist): about 6x faster, the usual way
+uv run ruff check . && uv run ruff format --check .
+node --check src/orchestrator/web/static/app.js
+```
+
+How to contribute, the checks a change must pass and how to report a bug:
+[CONTRIBUTING.md](https://github.com/foszto/spartito/blob/master/CONTRIBUTING.md).
+
+## License
+
+MIT, see [LICENSE](https://github.com/foszto/spartito/blob/master/LICENSE).

spartito-0.1.0/pyproject.toml

@@ -0,0 +1,86 @@
+[project]
+name = "spartito"
+version = "0.1.0"
+description = "Run Claude Code and Codex agents in parallel, each in its own git worktree, steered through one orchestrator agent"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.14"
+keywords = [
+    "agents",
+    "ai",
+    "claude-code",
+    "codex",
+    "coding-agents",
+    "git-worktree",
+    "mcp",
+    "orchestration",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "anyio>=4.16.0",
+    "mcp>=2.3.0",
+    "starlette>=1.10.0",
+    "typer>=0.29.0",
+    "uvicorn>=0.54.0",
+]
+
+[project.optional-dependencies]
+app = [
+    "pywebview>=6.2; sys_platform == 'darwin'",
+    "pyobjc-framework-UserNotifications>=13.0; sys_platform == 'darwin'",
+    "pywebview[qt]>=6.2; sys_platform == 'linux'",
+]
+menubar = ["pyobjc-framework-Cocoa>=13.0; sys_platform == 'darwin'"]
+
+[project.urls]
+Homepage = "https://github.com/foszto/spartito"
+Repository = "https://github.com/foszto/spartito"
+Issues = "https://github.com/foszto/spartito/issues"
+Documentation = "https://github.com/foszto/spartito/tree/master/docs"
+
+[project.scripts]
+spartito = "orchestrator.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.11.29,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "orchestrator"
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "B",
+    "UP",
+    "SIM",
+]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "pytest-xdist>=3.8.0",
+    "ruff>=0.17.4",
+]

spartito-0.1.0/pyproject.toml.orig

@@ -0,0 +1,86 @@
+[project]
+name = "spartito"
+# The one place of the version: `uv version <new>` bumps it; the package reads it from the
+# installed metadata (orchestrator.__version__). A release tag is `v<version>` (docs/releasing.md).
+version = "0.1.0"
+description = "Run Claude Code and Codex agents in parallel, each in its own git worktree, steered through one orchestrator agent"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.14"
+keywords = [
+    "agents",
+    "ai",
+    "claude-code",
+    "codex",
+    "coding-agents",
+    "git-worktree",
+    "mcp",
+    "orchestration",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "anyio>=4.16.0",
+    "mcp>=2.3.0",
+    "starlette>=1.10.0",
+    "typer>=0.29.0",
+    "uvicorn>=0.54.0",
+]
+
+[project.optional-dependencies]
+# The native window of `spartito app`: Cocoa on macOS (pyobjc); Qt on Linux (pywebview's own `qt`
+# extra: PyQt6 and PyQt6-WebEngine, GPL-3.0, installed only with this extra and only there).
+# On macOS also the notifications Spartito posts itself (UserNotifications, MIT).
+app = [
+    "pywebview>=6.2; sys_platform == 'darwin'",
+    "pyobjc-framework-UserNotifications>=13.0; sys_platform == 'darwin'",
+    "pywebview[qt]>=6.2; sys_platform == 'linux'",
+]
+# The menu-bar status item of `spartito menubar` (macOS only): Cocoa through pyobjc.
+menubar = ["pyobjc-framework-Cocoa>=13.0; sys_platform == 'darwin'"]
+
+[project.urls]
+Homepage = "https://github.com/foszto/spartito"
+Repository = "https://github.com/foszto/spartito"
+Issues = "https://github.com/foszto/spartito/issues"
+Documentation = "https://github.com/foszto/spartito/tree/master/docs"
+
+[project.scripts]
+spartito = "orchestrator.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.11.29,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+# The distribution is `spartito`; the import package keeps its name `orchestrator`.
+module-name = "orchestrator"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.2.0",
+    "pytest-xdist>=3.8.0",
+    "ruff>=0.17.4",
+]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "SIM"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

spartito-0.1.0/src/orchestrator/__init__.py

@@ -0,0 +1,11 @@
+"""A small orchestrator for fleets of coding agents (Claude Code, Codex)."""
+
+from importlib import metadata
+
+# The version lives in pyproject.toml only; this reads the installed distribution's metadata.
+# Without it (an environment that installed this checkout under another distribution name,
+# before it is reinstalled: docs/releasing.md) the version is unknown, nothing else changes.
+try:
+    __version__ = metadata.version("spartito")
+except metadata.PackageNotFoundError:
+    __version__ = "0+unknown"

spartito-0.1.0/src/orchestrator/__main__.py

@@ -0,0 +1,6 @@
+"""`python -m orchestrator`: the command line (what the background service runs)."""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()