workstate-codex-bridge

Optional bridge module that satisfies the workstate_codex_bridge.run_subagent(...) contract used by the orchestration layer.

It launches codex app-server --listen stdio://, drives one structured turn, and returns the final payload as a Python dict.

Installation

From the package root:

python -m pip install -e ".[dev]"

Current monorepo checkout:

cd /path/to/workstate/packages/workstate-codex-bridge
python -m pip install -e ".[dev]"

If you do not want to install it, add src to PYTHONPATH or inject workstate_codex_bridge into sys.modules from the host process.

Run package-local commands from the package root:

make lint-bridge
make fix-lint-bridge
make format-bridge
make mypy-bridge
make test-bridge
make check-bridge

Direct commands also work:

PYTHONPATH=src python -m ruff check src tests
PYTHONPATH=src python -m mypy src
PYTHONPATH=src python -m pytest tests -q

The bridge keeps the existing seam: prompt + schema + cwd + optional env -> dict
env values are treated as local runtime hints only and become subprocess or session context for codex app-server
CODEX_REASONING_EFFORT or REASONING_EFFORT map to turn/start.effort when set to low, medium, high, or xhigh
MCP endpoints and credentials are not forwarded through the bridge
Build and test commands must still come from the worktree instruction surface or the rendered prompt
run_subagent() is concurrency-safe because each default call launches and tears down its own app-server process
CODEX_SUBAGENT_BRIDGE_SESSION_MODE=shared opts into a reusable app-server process for compatible calls in the same cwd

This package is intentionally small. It provides the bridge seam only; higher-level orchestration policy belongs in the caller.

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Uploaded Jun 12, 2026 Source

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

Uploaded Jun 12, 2026 Python 3

Details for the file workstate_codex_bridge-0.2.0.tar.gz.

Hashes for workstate_codex_bridge-0.2.0.tar.gz
Algorithm	Hash digest
SHA256	`233e5c10483f69b9d91c5914327cc8aa24e7e60329b0b30e3c7c60c4a64dc6d6`
MD5	`23d34c7bdca1469146ff38a7dd43e737`
BLAKE2b-256	`3e8fd5cd66eaa7af26da6d157a1acb676cd916d70428e2d968bf7797806170ed`

The following attestation bundles were made for workstate_codex_bridge-0.2.0.tar.gz:

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Details for the file workstate_codex_bridge-0.2.0-py3-none-any.whl.

Hashes for workstate_codex_bridge-0.2.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`dba4111ff6f84a31617df51bd34feebabf946d1ec7051c0a14cf0ebdf3a277c2`
MD5	`0943aa15ce6fec4ae65d767c32ec672b`
BLAKE2b-256	`44546f84cbc1cd64b7a51d7032de517f989621282fbb19fd8538f240d97c8593`

The following attestation bundles were made for workstate_codex_bridge-0.2.0-py3-none-any.whl:

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.