https://github.com/automa/codex

OpenAI's Codex bot for Automa
https://github.com/automa/codex

automa automa-bot bot codex coding-agent openai

Last synced: 7 months ago
JSON representation

OpenAI's Codex bot for Automa

• Host: GitHub
• URL: https://github.com/automa/codex
• Owner: automa
• License: mit
• Created: 2025-06-05T17:32:27.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2025-06-27T02:23:07.000Z (7 months ago)
• Last Synced: 2025-06-27T03:35:41.018Z (7 months ago)
• Topics: automa, automa-bot, bot, codex, coding-agent, openai
• Language: TypeScript
• Homepage:
• Size: 223 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# codex

This is an [AI](https://docs.automa.app/agents/types#ai) & [manual](https://docs.automa.app/agents/types#manual) bot for [**Automa**](https://automa.app) that uses [OpenAI's Codex](https://github.com/openai/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

[![Install on Automa](https://automa.app/install.svg)](https://console.automa.app/$/bots/new/openai/codex)

### Self-Hosting

This bot can be self-hosted. You can follow these steps to get it running.

#### Prerequisites

- Have [`docker`](https://docker.com/) installed.

#### Needed services

- Have [`redis`](https://github.com/redis/redis) or any redis compatible memory store running.

#### Automa agent

[Create an agent](https://docs.automa.app/agent-development/create-agent) of [manual](https://docs.automa.app/agents/types#manual) type on [Automa](https://automa.app) (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

```sh

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`](https://github.com/openai/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](CONTRIBUTING.md) for more details. Here is a list of [Contributors](https://github.com/automa/codex/contributors).

## LICENSE

MIT

## Bug Reports

Report [here](https://github.com/automa/codex/issues).