Splay
Evidence-led local execution control plane for coding agents.
Install:
pip install splay-router
splay --version
splay smoke
The PyPI distribution name is splay-router. The CLI executable is splay.
Status
| Item | State |
|---|---|
| Product brand | Splay |
| Spec | Splay_Technical_Specification_v0.2-draft.pdf |
| Phase −1 … 3 | Complete — see docs/phase-*/ |
| Phase 4 (Codex ExecutionProfile) | Complete — docs/phase-4/ |
| Phase 5 (offline routing eval) | Complete — docs/phase-5/ |
| Phase 6 (ACP worker family) | Complete — docs/phase-6/ |
| Phase 7 (terms / economy) | Complete — docs/phase-7/ |
| Phase 8 (strict-v1 routing) | Complete — docs/phase-8/ |
| Phase 9 (MCP northbound stub) | Complete — docs/phase-9/ |
| Phase 10 (ContextPack experiment) | Complete — docs/phase-10/ |
| Phase 11 (strategy research) | Complete — docs/phase-11/ |
| Phase 12 (public alpha) | Complete — docs/phase-12/ |
| Post-alpha (E0/E1, CRB replay, MCP Tasks, live paths) | Complete — docs/post-alpha/ |
| v1 evidence plan | docs/v1/RELEASE_PLAN.md |
| Distribution | splay-router 0.14.0 (public alpha + subscription-first evidence tooling) |
| Implementation | Local control plane + Codex/ACP stubs + strict-v1 routing + MCP stub + diary/delta |
Public alpha
Splay 0.14.0 is a local, stub-qualified public alpha with subscription-first evidence tooling:
- Worker families: Codex App Server stub + ACP breadth stub (
splay task run --worker codex|acp|fake). - VerificationSpec:
splay verify list|run(Phase 2 foundation). - Ceilings / spend:
ResourceCeilingson MCP delegate; defaultNO_MARGINAL_SPEND. - Routing eval (reproducible):
splay eval routing compare --seed 42 --tasks 64 - Onboarding:
splay setup, aggregatesplay doctor,splay uninstall --yes - MCP:
splay mcp serve(JSON-RPC shaped stub — seedocs/alpha/LIMITATIONS.md) - Terms matrix:
docs/alpha/TERMS_SUPPORT_MATRIX.md
Quick start (development)
uv sync
STATE=$(mktemp -d)
uv run splay session create "fix a bug" --foreground --state-dir "$STATE"
# note metasession id, then:
uv run splay task create --session ms-... "apply fix" --foreground --state-dir "$STATE"
uv run splay task run task-... --worker codex --foreground --state-dir "$STATE"
uv run splay profile probe
uv run splay status --foreground --state-dir "$STATE"
uv run pytest
CLI
| Command | Purpose |
|---|---|
splay session create |
Create MetaSession |
splay task create/run/cancel |
Task lifecycle via control plane |
splay task run --worker codex |
Execute via Codex App Server stub profile |
splay profile probe / list |
Observe ExecutionProfile capabilities |
splay eval routing |
Offline baseline policy comparison (synthetic matrix) |
splay route plan --prompt ... |
Strict-v1 RouteDecision (stub profiles) |
splay doctor / terms / resources |
Alpha diagnostics |
splay mcp serve |
MCP-shaped northbound stub |
splay setup / uninstall --yes |
Local state onboarding / teardown |
splay status |
Inspect sessions/tasks/runs |
splay reconcile |
Crash/process reconciliation |
splay daemon serve |
Local Unix-socket control daemon |
splay fake / splay verify |
Phase 1–2 diagnostics |
Compliance note
Provider-channel eligibility can change. Users remain responsible for compliance with their provider terms. Splay does not broker credentials or silently enable paid fallback.
License
Apache-2.0 — see LICENSE.
1 maintainer
Release files for splay-router 0.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| splay_router-0.14.0.tar.gz | 109.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| splay_router-0.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 217.8 kB
Release files / splay_router-0.14.0.tar.gz
| Download URL | splay_router-0.14.0.tar.gz |
|---|---|
| Size | 109.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f0bcecd25f8103e07e8957cf3f150869387a0b6a80fdac1d5de2249bfa3cb1ee
|
|
BLAKE2b-256 checksum How to use checksums |
4805c71745847bfb3a0584ec06fd077440564a05c2115c39825938b35c87ef51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / splay_router-0.14.0-py3-none-any.whl
| Download URL | splay_router-0.14.0-py3-none-any.whl |
|---|---|
| Size | 107.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
02a3d5dfb68d118867d72fa4cf9a7901ff7c3da2f1125009e2965990bec00281
|
|
BLAKE2b-256 checksum How to use checksums |
c0dc2ee147b4a2b2dff2ea3778f0c5f2c84c9796aa56b89d8481695c27a52532
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
