Metadata-Version: 2.4
Name: codex-local-sdk-python
Version: 0.1.1
Summary: Python SDK wrapper around codex exec with bundled skill/docs scaffolding CLI.
Author: Codex Local SDK Maintainers
License-Expression: MIT
Project-URL: Homepage, https://github.com/maestromaximo/codex-local-sdk-python
Project-URL: Repository, https://github.com/maestromaximo/codex-local-sdk-python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# codex-local-sdk-python

[![PyPI Version](https://img.shields.io/pypi/v/codex-local-sdk-python.svg)](https://pypi.org/project/codex-local-sdk-python/)
[![Python Versions](https://img.shields.io/pypi/pyversions/codex-local-sdk-python.svg)](https://pypi.org/project/codex-local-sdk-python/)
[![Unit Tests](https://img.shields.io/github/actions/workflow/status/maestromaximo/codex-local-sdk-python/unit.yml?label=unit%20tests)](https://github.com/maestromaximo/codex-local-sdk-python/actions/workflows/unit.yml)
[![License](https://img.shields.io/github/license/maestromaximo/codex-local-sdk-python)](https://github.com/maestromaximo/codex-local-sdk-python/blob/main/LICENSE)

`codex-local-sdk-python` packages this repository's local `codex_local_sdk` module as an installable
PyPI distribution and adds a companion CLI:

- `codex-sdk skill` copies the bundled `codex-local-sdk-usage` skill to `.agents/skills/`.
- `codex-sdk docs` copies bundled documentation to `codex-sdk-documentation/`.

Project policies:

- Contributing: `CONTRIBUTING.md`
- Security: `SECURITY.md`
- License: `LICENSE` (MIT)

## Install

```bash
pip install codex-local-sdk-python
```

## Python usage

```python
from codex_local_sdk import CodexExecRequest, CodexLocalClient

client = CodexLocalClient()
result = client.run(CodexExecRequest(prompt="Summarize this repo"), timeout_seconds=120)
print(result.final_message)
```

## CLI

```bash
codex-sdk --help
codex-sdk skill
codex-sdk docs
```

Command details:

- `codex-sdk skill` copies `codex-local-sdk-usage` to `.agents/skills/`
- `codex-sdk docs` copies docs to `codex-sdk-documentation/`
- use `--output <dir>` to choose destination root
- use `--force` to overwrite existing files

Examples:

```bash
codex-sdk skill --output .
codex-sdk docs --output .
codex-sdk skill --output /path/to/project --force
```
