Metadata-Version: 2.4
Name: codex-sdk-unofficial
Version: 0.1.3
Summary: Unofficial Python SDK for the OpenAI Codex CLI.
Project-URL: Homepage, https://github.com/Goodbuilder34/codex-sdk-unofficial
Project-URL: Repository, https://github.com/Goodbuilder34/codex-sdk-unofficial
Project-URL: Issues, https://github.com/Goodbuilder34/codex-sdk-unofficial/issues
Author: Unofficial Community Maintainers
License: Apache-2.0
Keywords: codex,openai,python,sdk,unofficial
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# codex-sdk-unofficial

Unofficial, community-maintained Python SDK for the Codex CLI.

> This is **not an official OpenAI SDK**.

## Documentation

Full docs site (UV-first, beginner-first):
- https://goodbuilder34.github.io/codex-sdk-unofficial/

Local docs preview:

```bash
uv run --group docs mkdocs serve
```

## Quickstart (UV-First)

Assumes you are already inside an existing UV-managed project.

```bash
uv add codex-sdk-unofficial
uv run python -c "from codex_sdk import Codex; print('import-ok')"
```

```python
from codex_sdk import Codex

codex = Codex()
thread = codex.start_thread()
turn = thread.run("Diagnose the test failure and propose a fix", stream=True)

print(turn.final_response)
print(turn.items)
```

Run:

```bash
uv run python your_script.py
```

## Package Info

- Package name: `codex-sdk-unofficial`
- Import name: `codex_sdk`
- Current version: `0.1.3`

## Dev Commands

```bash
PYTHONPATH=src uv run pytest -q
uv run --group docs mkdocs build --strict
uv run --with build python -m build
```

## Publishing

Tag pushes (`v*`) trigger `.github/workflows/publish.yml`.

Manual upload fallback:

```bash
uv run --with twine twine upload dist/*
```
