codex-ipc 0.1.0

Add your description here

codex-ipc

Python facade for running Codex app-server sessions and sharing their live conversation state over the Codex IPC owner/follower protocol.

Library usage

from pathlib import Path

from codex_ipc import CodexIpcConfig, CodexIpcSession


async def main() -> None:
    config = CodexIpcConfig(
        codex_bin=Path("/opt/homebrew/bin/codex"),
        host_id="local",
        model="gpt-5.4",
        reasoning_effort="high",
    )

    async with CodexIpcSession(config) as session:
        thread = await session.start_new_thread()
        print(f"started {thread.id}")

        async for state in session.watch_state():
            # Forward this raw conversation state to a browser over WebSocket.
            print(state)


async def resume_existing(thread_id: str) -> None:
    async with CodexIpcSession(CodexIpcConfig(thread_id=thread_id)) as session:
        await session.hydrate_initial_state()
        await session.run_prompt("Summarize the current repo", wait_for_completion=True)

If codex_bin is omitted, the vendored app-server SDK uses its normal runtime resolver. Pass a codex_app_server.AppServerConfig as app_server_config when you need full control over app-server launch arguments.

TUI demo

The TUI is a development tool and is kept out of the core dependency set:

uv run --extra tui codex-ipc-demo --codex-bin /opt/homebrew/bin/codex

Core imports such as import codex_ipc do not require textual, rich, or pillow.