Source: https://seerepo.com/docs/codex
Markdown source: https://seerepo.com/docs/codex.md
Description: See which commits OpenAI Codex wrote in your repo, and hand it SeeRepo's prompts.

# SeeRepo with Codex

Codex, OpenAI's coding agent, works on your repo and opens pull requests. SeeRepo shows you what it changed and how it connects.

## The signature it leaves

In the cloud, you connect GitHub when you create an environment, and you commit or open a pull request when you review a task ([Codex cloud](https://learn.chatgpt.com/docs/cloud)). OpenAI doesn't document the author name or the branch names of those commits.

## How SeeRepo recognizes it

A commit counts as Codex's when its author or its Co-Authored-By line says "codex", "chatgpt" or has an `openai.com` address. A merge of a branch that starts with `codex/` also counts.

On your computer, Codex signs its commits with "Co-authored-by: Codex <noreply@openai.com>" only when commit attribution is on in your Codex account, and it comes off ([Codex's code](https://github.com/openai/codex/blob/main/codex-rs/ext/git-attribution/src/policy.rs)). Without that line, SeeRepo counts those commits as yours. To have it sign anyway, ask for it in your repo's `AGENTS.md`.

## Where it shows in SeeRepo

- **Made by**, on a part's sheet: its logo next to the people. Click it and the map shows only what Codex touched.
- **Journey**: its posts tell, day by day, what it did, with its mark; **Who wrote it**, on the wall, what share it signed since the start. Tap it there to open its sheet: what it fixed, what it left and which modules it worked on this month, with the link to its posts. See [Journey](/docs/metrics).
- **Moments**: the day it starts writing most of the project, the moment \"**Codex took over from …**\" stays.
- **The filter**: under **Agent**, pick Codex to see only its work.

The full list of agents SeeRepo recognizes is in the [Agent directory](/agents).

## Hand it a prompt from SeeRepo

SeeRepo writes prompts for what's worth fixing, ready for Codex:

1. **Open Health** and tap a task: failing tests, errors in production, packages with security flaws, files nothing uses… Its sheet opens. See [Health](/docs/health).
2. **Click "Copy prompt"**. The prompt names your repo, lists the files, and says what to do.
3. **Paste it into Codex**: it will know which files to read.

If your project has no automatic tests, **Health** says so in **Tests** ("They don't run on their own") and offers "**Copy prompt to make them run on their own**": Codex can set them up in a few minutes.