# Codex Tool Mapping

This document maps Claude Code tool names used in MaxFrame skills to Codex equivalents.

## Core Tools

| Claude Code Tool | Codex Tool | Notes |
|------------------|------------|-------|
| `Read` | `read_file` | Read file contents |
| `Write` | `write_file` | Write new file |
| `Edit` | `edit_file` | Edit existing file |
| `Bash` | `execute_command` | Execute shell commands |
| `Glob` | `find_files` | Find files by pattern |
| `Grep` | `search_in_files` | Search file contents |

## Task Management

| Claude Code Tool | Codex Tool | Notes |
|------------------|------------|-------|
| `TodoWrite` | `update_plan` | Update implementation plan |
| `TaskCreate` | `add_plan_item` | Add item to plan |
| `TaskUpdate` | `update_plan_item` | Update plan item status |
| `TaskList` | `get_plan` | Get current plan |
| `TaskGet` | `get_plan_item` | Get specific plan item |

## Agent & Skill Tools

| Claude Code Tool | Codex Tool | Notes |
|------------------|------------|-------|
| `Skill` | `load_skill` | Load skill content |
| `Agent` | `spawn_agent` | Spawn specialized agent |
| `TaskOutput` | `get_agent_result` | Get output from spawned agent |

## Interaction Tools

| Claude Code Tool | Codex Tool | Notes |
|------------------|------------|-------|
| `AskUserQuestion` | `ask_user` | Request user input |
| `EnterPlanMode` | `start_planning` | Begin planning phase |
| `ExitPlanMode` | `finalize_plan` | Complete planning phase |

## Web Tools

| Claude Code Tool | Codex Tool | Notes |
|------------------|------------|-------|
| `WebFetch` | `fetch_url` | Fetch web content |
| `WebSearch` | `search_web` | Web search |

## Notebook Tools

| Claude Code Tool | Codex Tool | Notes |
|------------------|------------|-------|
| `NotebookEdit` | `edit_notebook` | Edit notebook cells |

## Tool Availability

Codex provides a planning-centric workflow where `update_plan` and related tools manage implementation progress. Skills are discovered from configured skill directories.

## Platform-Specific Behavior

- **Planning Workflow**: Codex emphasizes explicit planning with `start_planning`/`finalize_plan` cycle
- **Agent Spawning**: Use `spawn_agent` for parallel task execution
- **Skill Loading**: Use `load_skill` instead of Claude Code's `Skill` tool
- **Plan Updates**: Replace TodoWrite with `update_plan` for tracking progress

## Usage Example

If a MaxFrame skill says:
```
Use TodoWrite to track the following tasks...
```

In Codex, use:
```
update_plan items=[...] to track tasks
```

## Configuration

Codex skills are configured in `.codex/config.yml`:
```yaml
skills:
  - path: ~/.config/codex/skills/maxframe
```
