This has been quite the month for “agentic” products. I had a good experience with
Claude Code in one post and then compared it to
Google Jules. Meanwhile, you can read elsewhere about the new
Gemini CLI, and I’ll cover Warp’s “Agentic Development Environment” shortly.
But with this post I’ll look at
OpenAI Codex, released last month, which OpenAI describes as a “cloud-based software engineering agent.” As with the other products I’ve mentioned, Codex works in the Command Line, not in an editor.
Codex doesn’t have the bells and whistles that a “vibe coder” might desire; and indeed, it is very likely to have been conceived purely as a tool for experienced developers.
Starting With OpenAI Codex CLI
Let’s start up this “experimental” project — still only a GitHub page — with a very straightforward npm package.
npm i -g @openai/codex
In some respects, Codex is a bit more ”down home,” as it asks you to tie your API key straight into an environment variable:
export OPENAI_API_KEY="your-api-key-here"
You can find your OpenAI keys
here. It will be quite long. You can also use a settings file.
To start an interactive session, just use the command
codex:
👁 Image
It actually has a better starting summary than its agentic competition, like Claude Code, because it immediately states that it makes suggestions and seeks approval before doing anything
destructive. We can also see the model, and the working directory — it doesn’t appear to want or need a context file. Typing “Exit” will let you leave.
Updating JSON Content
My task is simply updating the contents of one JSON file compared to another. This is based on a recent issue I had with a colleague because we weren’t sharing a JSON file on git, so we suddenly got a little out of sync.
A JSON file is just a set of key/value pairs. Some people refer to the key as the name field. In the example below, the file just holds city information (some text and an image) and there is an ‘id’ key that allows for direct comparison. Think of the entries as data for a website.
The interesting nuance is that the “image” key is probably pointing to a real resource, so instead of updating it with a new image reference directly (that may not exist yet), I asked my colleague to create a “imageintended” key to hold image updates.
Of course, navigating indistinct human descriptions is one of the challenges for LLMs. If the LLM always needs exact input, then the dreams of development democracy will evaporate as an experienced developer will always need to be on hand. JSON data isn’t explicitly designed to be compared in this fashion, so a little care must be taken.
OK, now to set up out the JSON files. I created the first poorly written
original_cities.json file in the working directory:
{
"cities": [
{
"id": "London",
"text": "London is the capital of the UK",
"image": "BigBen"
},
{
"id": "Berlin",
"text": "Great night club scene",
"image": "Brandonburg Gate",
"imageintended": "Reichstag"
},
{
"id": "Paris",
"text": "Held the Olympics of 2024",
"image": "EifelTower",
}
]
}
Note the trailing comma in the Paris entry, as well as the misspelling of “EifelTower” — even though it is just an image name. Also note the spelling and poor format of the Berlin image name.
Here is the
updated_cities.json file:
{
"cities": [
{
"id": "London",
"text": "London is the capital and largest city in Great Britain",
"image": "BigBen"
},
{
"id": "Berlin",
"text": "Great night club scene but a small population",
"image": "BrandenburgGate",
"imageintended": "Reichstag"
},
{
"id": "Paris",
"text": "Held the Olympics of 2024",
"image": "NotreDame"
},
{
"id": "Rome",
"text": "The Eternal City",
"image": "TheColleseum"
}
]
}
Note that the image name is corrected, but that means it can no longer reference the original.
Now here is my roughly put request to Codex:
“please update the JSON file original_cities.json with the contents of the file updated_cities.json but if the “image” field is different, please update or write a new “imageintended” field with the new value instead”
In other words, updated contents is fine, but preserve the image name as updating this could cause issues.
While thinking about this problem, I got back plenty of permission requests, mainly for
sed commands:
👁 Image
Of course, this assumes I know what the
sed command will do! Finally, it produced a patch:
👁 Image
And then it finished:
👁 Image
It had indeed modified the original_cities.json file correctly:
{
"cities": [
{
"id": "London",
"text": "London is the capital and largest city in Great Britain",
"image": "BigBen"
},
{
"id": "Berlin",
"text": "Great night club scene but a small population",
"image": "Brandonburg Gate",
"imageintended": "BrandenburgGate"
},
{
"id": "Paris",
"text": "Held the Olympics of 2024",
"image": "EifelTower",
"imageintended": "NotreDame"
},
{
"id": "Rome",
"text": "The Eternal City",
"image": "TheColleseum"
}
]
}
Conclusion
Claude Code actually made a bit of a mess of this, but Codex not only does the merge well, it also provided a very good set of notes about why it did what it did.
It fixed up the minor format error, but didn’t get confused by English spelling errors and understood the need to preserve the image reference. However, it clearly did understand the changes it was making — the notes make subtle reference to the purpose.
During the thinking process, it asked for permission plenty of times, as we knew it would.
Unlike Claude Code, it did not exactly create a transparent plan to follow. It just outputs a heap of
sed commands, but these clearly proved good enough when executed. This makes it much less controllable from a vibe coding point of view, because someone inexperienced with code needs to know what will be happening.
I wonder whether this is the prototype for a bigger product, or whether OpenAI will cede ground for the moment to Anthropic, Google and Warp — honing its experiment before coming out with its own view of the perfect agentic experience.
