Metadata-Version: 2.4
Name: meshagent-codex
Version: 0.28.0
Summary: Codex app-server adapter and chatbot for Meshagent
License-Expression: Apache-2.0
Project-URL: Documentation, https://docs.meshagent.com
Project-URL: Website, https://www.meshagent.com
Project-URL: Source, https://www.meshagent.com
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: meshagent-api~=0.28.0
Requires-Dist: meshagent-agents~=0.28.0
Requires-Dist: meshagent-tools~=0.28.0
Requires-Dist: pytest~=8.4
Requires-Dist: pytest-asyncio~=0.26

# meshagent-codex

`meshagent-codex` adds Codex app-server backed agents:
- `CodexChatBot`
- `CodexTaskRunner`

## Included

- `CodexChatBot`: chat agent backed by `codex app-server`
- `CodexTaskRunner`: task runner backed by `codex app-server`

## Example

```python
from meshagent.api.services import ServiceHost
from meshagent.codex import CodexChatBot

service = ServiceHost()


@service.path("/agent")
class MyCodexAgent(CodexChatBot):
    def __init__(self):
        super().__init__(
            name="meshagent.codex-chatbot",
            title="codex chatbot",
            description="chatbot powered by codex app-server",
            rules=["You are a concise assistant."],
            model="codex-mini-latest",
        )
```

By default, the backend launches Codex via `codex app-server`.

You can override transport with environment variables:

- `MESHAGENT_CODEX_COMMAND` to change the launch command.
- `MESHAGENT_CODEX_WS_URL` to connect to an existing Codex app-server websocket instead of launching a local process.
