Codex: البدء مع Codex

# Create a test project
mkdir my-first-codex && cd my-first-codex

# Initialize a simple Python project
echo 'def greet(name):\n    return f"Hello, {name}!"' > app.py

codex

Add unit tests to app.py using the pytest framework

1. Reading app.py...
2. Creating test_app.py with pytest test cases
3. Running: pytest test_app.py
4. All tests passed ✓

cd bob-flask-api
codex

# Bob enters:
# "Add input validation to all API endpoints using marshmallow"

# Codex output:
# → Scanning 15 API endpoint files...
# → Installing marshmallow...
# → Creating schemas/ directory...
# → Adding validation to 15 endpoints...
# → Running tests: 34/34 passed ✓

# Good task descriptions
codex "Fix the login bug in user.py, ensure tests pass"
codex "Refactor utils.js to TypeScript, keep functionality consistent"
codex "Add pagination to orders API, 20 items per page"

# Bad task descriptions
codex "Help me write code"
codex "Fix bug"
codex "Optimize something"

# First task
> Add logging to app.py

# Append
> Change log level to DEBUG

# Continue appending
> Output logs to file instead of console

# Alice gradually refines features
> Create a FastAPI project skeleton
  ✓ Created main.py, routers/, models/

> Add user registration API
  ✓ Created /api/register endpoint

> Add email verification to registration API
  ✓ Added email verification flow

> Write integration tests
  ✓ Created test_register.py, 5 tests passed

- def greet(name):
-     return f"Hello, {name}!"
+ def greet(name: str) -> str:
+     """Greet a person by name."""
+     if not name:
+         raise ValueError("Name cannot be empty")
+     return f"Hello, {name}!"

# Codex auto-runs tests and displays results
Running pytest test_app.py...
✓ test_greet_normal - PASSED
✓ test_greet_empty - PASSED
✓ test_greet_type_hint - PASSED

3 passed, 0 failed

> Migrate Express project to Fastify, replace all route definitions, ensure tests pass

# Codex execution process:
# → Scanning 45 files for Express patterns
# → Converting route definitions (32 routes)
# → Updating middleware (8 files)
# → Running test suite: 89/89 passed ✓
# → Updating package.json
# → Final test run: 89/89 passed ✓