Metadata-Version: 2.4
Name: gpt5-codex-cli
Version: 0.1.0
Summary: Task-oriented GPT-5 Codex command line interface with streaming and web search
Author: OpenAI Codex CLI Contributors
License: MIT
Project-URL: Homepage, https://github.com/PDFSage/openai_cli
Project-URL: Repository, https://github.com/PDFSage/openai_cli
Keywords: openai,codex,cli,assistant,gpt-5
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Dynamic: license-file

# GPT-5 Codex CLI

A lightweight terminal client that mirrors the experience of products like OpenAI's Codex CLI, Claude Code, and Gemini Code. The tool focuses on high-level task execution (not just code generation) by defaulting to the `gpt-5-codex` model with both streaming output and the web search tool enabled.

## Features

- Autodetects `OPENAI_API_KEY` and guides you to create one if it is missing.
- Streaming responses that closely resemble established AI coding assistants.
- Web search tool enabled by default so the model can pull in fresh information as needed.
- Clean interactive loop for multi-turn task planning and execution, plus one-shot mode via CLI arguments.

## Installation

```bash
pip install -e .
```

This project depends on the [official OpenAI Python SDK](https://pypi.org/project/openai/). Install it automatically through the editable install above or explicitly with `pip install openai`.

## Usage

Interactive session:

```bash
export OPENAI_API_KEY="sk-..."
gpt5-codex
```

Single task run:

```bash
gpt5-codex "Plan a two-day itinerary for Tokyo that balances food, art, and tech"
```

Optional flags:

- `--model MODEL_NAME` – override the default `gpt-5-codex` model.
- `--temperature FLOAT` – tune the generation temperature (default `0.2`).
- `--no-search` – disable the built-in web search tool.
- `--no-stream` – disable streaming output.

## Testing

```bash
pip install -e .[dev]
pytest
```

## Publishing to PyPI

The repository includes a standard `pyproject.toml`. To publish:

```bash
python -m build
python -m twine upload dist/*
```

> **Note:** Uploading requires a PyPI account and network access, which may not be available in every environment.
