ohkit

A unified Python programming interface for agent harnesses.

Status

ohkit is a pre-alpha Python library. This checkout implements typed asynchronous Thread/Run execution and a concrete Codex app-server control backend: streaming, result-only execution, active steering, cancellation, native history resume/fork, and typed approvals/questions. It also supplies typed Workspace I/O and an application-hosted Codex executor for new Threads in explicitly unsandboxed mode. Stable ACP execution includes negotiated history continuation, native permission choices, and optional Workspace text/terminal callbacks. Ordinary Claude execution uses the official SDK, with history continuation and approval handling but no Workspace bridge. Neither new adapter advertises steering or fork. Earlier published bootstrap releases expose metadata only; these source capabilities are not a claim of a new release.

The repository, Python distribution, and import package are all named ohkit. Python 3.13 or newer is required. Both owned stdio control and connections to caller-owned WebSocket services are available in the default installation. Codex must be installed separately and configured for its native model provider.

The architecture specifications own the execution model and Workspace boundary. The getting-started guide and Codex guide describe runnable source APIs and the tested native version, rather than promising compatibility with every upstream release.

Quick start

Install this checkout with python -m pip install ., then use a configured Codex executable on PATH:

import asyncio

from ohkit.backends.codex import Codex


async def main() -> None:
    async with Codex() as backend:
        thread = await backend.new_thread(cwd="/path/to/project")
        result = await thread.run("Explain the project without changing files.")
        print(result.outcome, result.output)


asyncio.run(main())

The native harness owns tools, filesystem access, sandbox policy, and credentials. Entering Codex() owns one stdio app-server process; it is not a portable Workspace or application sandbox.

For application-supplied file/process I/O, see Workspace and the authenticated hosting example. The bridge borrows the provider; your application owns routing, authorization, and the listener. External executor history resume/fork is not supported by the pinned native protocol.

Development

git clone https://github.com/Wh1isper/ohkit.git
cd ohkit
make install
make check-all

See CONTRIBUTING.md for contribution and validation rules, DEVELOPMENT.md for engineering standards, and spec/README.md for accepted contracts.

Documentation

• Documentation index
• Documentation build and deployment
• Canonical site: ohkit.wh1isper.top
• Release procedure
• Security policy

License

Original ohkit code is under the MIT License. Generated Codex protocol code also carries Apache-2.0 terms; see third-party notices. The distribution's license expression is MIT AND Apache-2.0.