codex

This is an AI & manual agent for Automa that uses OpenAI's Codex tool to work on tasks.

Features

• Runs tasks via job schedule with retry and backoff support.
• Generates pull request titles and bodies using GPT-4.1-mini.

Getting Started

Self-Hosting

This agent can be self-hosted. You can either follow our more detailed guide or follow these steps to get it running.

Prerequisites

• Have docker installed.

Needed services

• Have redis or any redis compatible memory store running.

Automa bot

Register a bot of manual type on Automa (Cloud or Self-hosted) and point its webhook to your planned server (e.g., http://your-server-ip:8000/hooks/automa). Copy the webhook secret after it is created.

Starting the server

docker run -it --rm -p 8000:8000 \
  -e REDIS_URL=your_url_here \
  -e AUTOMA_WEBHOOK_SECRET=your_secret_here \
  -e OPENAI_API_KEY=your_key_here \
  ghcr.io/automa/codex

How It Works

It runs codex in full approval mode.

Contributing

Contributions and feedback are welcome! Feel free to open an issue or submit a pull request. See CONTRIBUTING.md for more details. Here is a list of Contributors.

LICENSE

MIT

Bug Reports

Report here.