Your first project with Codex
Give Codex a clear task, inspect its changes, and verify your first result.
What you will make
The empty state explains the next action, its link works, and you know which files Codex changed.
Before you start
A local project and access to Codex through your chosen interface. Use the official setup for your operating system and account.
1. Choose your workspace
Follow the official quickstart for the CLI or editor integration. Select the local project you intend to change. For the terminal path, verify codex --version after installation, then open Codex from the project folder.
2. Read the project
Ask Codex to find the repository instructions, scripts, and current working changes. Record the dev and verification commands. Keep the task inside the selected workspace and preserve existing changes.
3. Give a bounded task
Describe one visible outcome, constraints, and how to verify it. Start with a homepage improvement or a small failing test. Let the agent inspect relevant files before choosing an implementation.
4. Review the evidence
Inspect the diff and the running result. Ask which checks actually ran and which were blocked. Keep a small checkpoint you can return to before moving to a larger task.
Give your agent a clear task
Read this project's instructions and inspect the existing changes. Improve the empty state on the main list: explain what belongs here and add a link to create the first item. Follow existing components. Verify the empty state and show the diff.Check the result
The empty state explains the next action, its link works, and you know which files Codex changed.
Vibes for this guide
Use the materials that help with your next step.