#Codex Quick Start

#A. Finish Your First Task In The Desktop App

#1. Prepare A Git Project

Open a real repository with a working test or build command. Commit or note any existing changes before asking Codex to edit files.

#2. Add The Project In The App And Choose A Preset

Add the project to Codex, choose a permission preset, and select a model and reasoning effort appropriate for the task.

#3. Start A Task

Use a narrow request:

Add a health-check endpoint, update the related test, and run the smallest relevant test command.

#4. Approve And Review

When Codex asks for approval, check the command and the reason. After edits, review the diff.

#5. Finish Up

Run the verification command, inspect the final summary, then commit if the change is correct.

#B. Finish Your First Task In The CLI

#Start An Interactive Session

codex

#Recommended Safe Preset

Use workspace-write with approval for risky commands for normal local development.

#Common TUI Slash Commands

Use /status, /model, /approvals, and /review to inspect or change session behavior.

#First Complete Mini Project: Add A Health Check Endpoint

Ask Codex to:

1. find the app entry point
2. add /health
3. add or update tests
4. run the smallest relevant test
5. summarize the diff

#Good Git Habits

Keep changes small, review diffs, and avoid mixing unrelated tasks in one thread.

#Non-Interactive One-Liner

codex exec "Add a health-check endpoint, update tests, and run the smallest relevant test command."

#Next Steps

Continue with Configuration & Customization.