{
  "name": "codex",
  "description": "Codex CLI — OpenAI's coding agent",
  "options": [
    {
      "names": [
        "-c",
        "--config"
      ],
      "description": "Override a configuration value (dotted path, TOML-parsed value)",
      "isPersistent": true,
      "isRepeatable": -1,
      "args": [
        {
          "name": "key=value"
        }
      ]
    },
    {
      "names": [
        "--enable"
      ],
      "description": "Enable a feature (repeatable). Equivalent to `-c features.<name>=true`",
      "isPersistent": true,
      "isRepeatable": -1,
      "args": [
        {
          "name": "feature"
        }
      ]
    },
    {
      "names": [
        "--disable"
      ],
      "description": "Disable a feature (repeatable). Equivalent to `-c features.<name>=false`",
      "isPersistent": true,
      "isRepeatable": -1,
      "args": [
        {
          "name": "feature"
        }
      ]
    },
    {
      "names": [
        "-i",
        "--image"
      ],
      "description": "Optional image(s) to attach to the initial prompt",
      "args": [
        {
          "name": "file",
          "isVariadic": true,
          "template": "filepaths"
        }
      ]
    },
    {
      "names": [
        "-m",
        "--model"
      ],
      "description": "Model the agent should use",
      "args": [
        {
          "name": "model"
        }
      ]
    },
    {
      "names": [
        "--oss"
      ],
      "description": "Use open-source provider"
    },
    {
      "names": [
        "--local-provider"
      ],
      "description": "Specify which local provider to use (with --oss)",
      "args": [
        {
          "name": "provider",
          "suggestions": [
            "lmstudio",
            "ollama"
          ]
        }
      ]
    },
    {
      "names": [
        "-p",
        "--profile"
      ],
      "description": "Configuration profile from config.toml",
      "args": [
        {
          "name": "profile"
        }
      ]
    },
    {
      "names": [
        "-s",
        "--sandbox"
      ],
      "description": "Sandbox policy for model-generated shell commands",
      "args": [
        {
          "name": "mode",
          "suggestions": [
            "read-only",
            "workspace-write",
            "danger-full-access"
          ]
        }
      ]
    },
    {
      "names": [
        "--dangerously-bypass-approvals-and-sandbox"
      ],
      "description": "Skip all confirmation prompts and run without sandboxing (EXTREMELY DANGEROUS)",
      "isDangerous": true
    },
    {
      "names": [
        "-C",
        "--cd"
      ],
      "description": "Agent working root",
      "args": [
        {
          "name": "dir",
          "template": "folders"
        }
      ]
    },
    {
      "names": [
        "--add-dir"
      ],
      "description": "Additional directories writable alongside primary workspace",
      "isRepeatable": -1,
      "args": [
        {
          "name": "dir",
          "template": "folders"
        }
      ]
    },
    {
      "names": [
        "-a",
        "--ask-for-approval"
      ],
      "description": "When the model requires human approval",
      "args": [
        {
          "name": "policy",
          "suggestions": [
            "untrusted",
            "on-failure",
            "on-request",
            "never"
          ]
        }
      ]
    },
    {
      "names": [
        "--search"
      ],
      "description": "Enable live web search (Responses `web_search` tool)"
    },
    {
      "names": [
        "--remote"
      ],
      "description": "Connect the TUI to a remote app server websocket endpoint (ws:// or wss://)",
      "args": [
        {
          "name": "addr"
        }
      ]
    },
    {
      "names": [
        "--remote-auth-token-env"
      ],
      "description": "Env var containing the bearer token for remote app server",
      "args": [
        {
          "name": "env_var"
        }
      ]
    },
    {
      "names": [
        "--no-alt-screen"
      ],
      "description": "Disable alternate screen mode (inline TUI)"
    },
    {
      "names": [
        "-h",
        "--help"
      ],
      "description": "Print help"
    },
    {
      "names": [
        "-V",
        "--version"
      ],
      "description": "Print version"
    }
  ],
  "args": [
    {
      "name": "prompt",
      "description": "Initial instructions for the agent",
      "isOptional": true
    }
  ],
  "subcommands": [
    {
      "name": "exec",
      "aliases": [
        "e"
      ],
      "description": "Run Codex non-interactively",
      "options": [
        {
          "names": [
            "-c",
            "--config"
          ],
          "description": "Override a configuration value (dotted path, TOML-parsed value)",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "key=value"
            }
          ]
        },
        {
          "names": [
            "--enable"
          ],
          "description": "Enable a feature (repeatable). Equivalent to `-c features.<name>=true`",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "feature"
            }
          ]
        },
        {
          "names": [
            "--disable"
          ],
          "description": "Disable a feature (repeatable). Equivalent to `-c features.<name>=false`",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "feature"
            }
          ]
        },
        {
          "names": [
            "-i",
            "--image"
          ],
          "description": "Optional image(s) to attach to the initial prompt",
          "args": [
            {
              "name": "file",
              "isVariadic": true,
              "template": "filepaths"
            }
          ]
        },
        {
          "names": [
            "-m",
            "--model"
          ],
          "description": "Model the agent should use",
          "args": [
            {
              "name": "model"
            }
          ]
        },
        {
          "names": [
            "--oss"
          ],
          "description": "Use open-source provider"
        },
        {
          "names": [
            "--local-provider"
          ],
          "description": "Specify which local provider to use (with --oss)",
          "args": [
            {
              "name": "provider",
              "suggestions": [
                "lmstudio",
                "ollama"
              ]
            }
          ]
        },
        {
          "names": [
            "-p",
            "--profile"
          ],
          "description": "Configuration profile from config.toml",
          "args": [
            {
              "name": "profile"
            }
          ]
        },
        {
          "names": [
            "-s",
            "--sandbox"
          ],
          "description": "Sandbox policy for model-generated shell commands",
          "args": [
            {
              "name": "mode",
              "suggestions": [
                "read-only",
                "workspace-write",
                "danger-full-access"
              ]
            }
          ]
        },
        {
          "names": [
            "--dangerously-bypass-approvals-and-sandbox"
          ],
          "description": "Skip all confirmation prompts and run without sandboxing (EXTREMELY DANGEROUS)",
          "isDangerous": true
        },
        {
          "names": [
            "-C",
            "--cd"
          ],
          "description": "Agent working root",
          "args": [
            {
              "name": "dir",
              "template": "folders"
            }
          ]
        },
        {
          "names": [
            "--add-dir"
          ],
          "description": "Additional directories writable alongside primary workspace",
          "isRepeatable": -1,
          "args": [
            {
              "name": "dir",
              "template": "folders"
            }
          ]
        },
        {
          "names": [
            "-a",
            "--ask-for-approval"
          ],
          "description": "When the model requires human approval",
          "args": [
            {
              "name": "policy",
              "suggestions": [
                "untrusted",
                "on-failure",
                "on-request",
                "never"
              ]
            }
          ]
        },
        {
          "names": [
            "--search"
          ],
          "description": "Enable live web search (Responses `web_search` tool)"
        }
      ],
      "args": [
        {
          "name": "prompt",
          "isOptional": true
        }
      ],
      "subcommands": [
        {
          "name": "resume",
          "description": "Resume a previous session by id or pick the most recent with --last",
          "options": [
            {
              "names": [
                "--last"
              ],
              "description": "Resume the most recent session"
            }
          ],
          "args": [
            {
              "name": "session_id",
              "isOptional": true
            }
          ]
        },
        {
          "name": "review",
          "description": "Run a code review against the current repository",
          "args": [
            {
              "name": "prompt",
              "isOptional": true
            }
          ]
        },
        {
          "name": "help",
          "description": "Print help",
          "args": [
            {
              "name": "command",
              "isOptional": true
            }
          ]
        }
      ]
    },
    {
      "name": "review",
      "description": "Run a code review non-interactively",
      "options": [
        {
          "names": [
            "-c",
            "--config"
          ],
          "description": "Override a configuration value (dotted path, TOML-parsed value)",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "key=value"
            }
          ]
        },
        {
          "names": [
            "--enable"
          ],
          "description": "Enable a feature (repeatable). Equivalent to `-c features.<name>=true`",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "feature"
            }
          ]
        },
        {
          "names": [
            "--disable"
          ],
          "description": "Disable a feature (repeatable). Equivalent to `-c features.<name>=false`",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "feature"
            }
          ]
        },
        {
          "names": [
            "--uncommitted"
          ],
          "description": "Review staged, unstaged, and untracked changes"
        },
        {
          "names": [
            "--base"
          ],
          "description": "Review changes against the given base branch",
          "args": [
            {
              "name": "branch"
            }
          ]
        },
        {
          "names": [
            "--commit"
          ],
          "description": "Review the changes introduced by a commit",
          "args": [
            {
              "name": "sha"
            }
          ]
        }
      ],
      "args": [
        {
          "name": "prompt",
          "isOptional": true
        }
      ]
    },
    {
      "name": "login",
      "description": "Manage login"
    },
    {
      "name": "logout",
      "description": "Remove stored authentication credentials"
    },
    {
      "name": "mcp",
      "description": "Manage external MCP servers for Codex",
      "subcommands": [
        {
          "name": "list",
          "description": "List configured MCP servers"
        },
        {
          "name": "get",
          "description": "Get details about an MCP server",
          "args": [
            {
              "name": "name"
            }
          ]
        },
        {
          "name": "add",
          "description": "Add an MCP server",
          "args": [
            {
              "name": "name"
            },
            {
              "name": "commandOrUrl"
            },
            {
              "name": "args",
              "isOptional": true,
              "isVariadic": true
            }
          ]
        },
        {
          "name": "remove",
          "description": "Remove an MCP server",
          "args": [
            {
              "name": "name"
            }
          ]
        },
        {
          "name": "login",
          "description": "Log in to an OAuth-enabled MCP server",
          "args": [
            {
              "name": "name",
              "isOptional": true
            }
          ]
        },
        {
          "name": "logout",
          "description": "Remove OAuth credentials for an MCP server",
          "args": [
            {
              "name": "name",
              "isOptional": true
            }
          ]
        },
        {
          "name": "help",
          "description": "Print help",
          "args": [
            {
              "name": "command",
              "isOptional": true
            }
          ]
        }
      ]
    },
    {
      "name": "plugin",
      "description": "Manage Codex plugins"
    },
    {
      "name": "mcp-server",
      "description": "Start Codex as an MCP server (stdio)"
    },
    {
      "name": "app-server",
      "description": "[experimental] Run the app server or related tooling"
    },
    {
      "name": "app",
      "description": "Launch the Codex desktop app (opens installer if missing)"
    },
    {
      "name": "completion",
      "description": "Generate shell completion scripts",
      "args": [
        {
          "name": "shell",
          "suggestions": [
            "bash",
            "zsh",
            "fish",
            "elvish",
            "powershell"
          ]
        }
      ]
    },
    {
      "name": "update",
      "description": "Update Codex to the latest version"
    },
    {
      "name": "sandbox",
      "description": "Run commands within a Codex-provided sandbox",
      "subcommands": [
        {
          "name": "macos",
          "aliases": [
            "seatbelt"
          ],
          "description": "Run a command under Seatbelt (macOS only)"
        },
        {
          "name": "linux",
          "aliases": [
            "landlock"
          ],
          "description": "Run a command under the Linux sandbox (bubblewrap by default)"
        },
        {
          "name": "windows",
          "description": "Run a command under Windows restricted token (Windows only)"
        },
        {
          "name": "help",
          "description": "Print help",
          "args": [
            {
              "name": "command",
              "isOptional": true
            }
          ]
        }
      ]
    },
    {
      "name": "debug",
      "description": "Debugging tools"
    },
    {
      "name": "apply",
      "aliases": [
        "a"
      ],
      "description": "Apply the latest diff produced by Codex as a `git apply` to local working tree"
    },
    {
      "name": "resume",
      "description": "Resume a previous interactive session (picker by default; --last for most recent)",
      "options": [
        {
          "names": [
            "-c",
            "--config"
          ],
          "description": "Override a configuration value (dotted path, TOML-parsed value)",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "key=value"
            }
          ]
        },
        {
          "names": [
            "--enable"
          ],
          "description": "Enable a feature (repeatable). Equivalent to `-c features.<name>=true`",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "feature"
            }
          ]
        },
        {
          "names": [
            "--disable"
          ],
          "description": "Disable a feature (repeatable). Equivalent to `-c features.<name>=false`",
          "isPersistent": true,
          "isRepeatable": -1,
          "args": [
            {
              "name": "feature"
            }
          ]
        },
        {
          "names": [
            "-i",
            "--image"
          ],
          "description": "Optional image(s) to attach to the initial prompt",
          "args": [
            {
              "name": "file",
              "isVariadic": true,
              "template": "filepaths"
            }
          ]
        },
        {
          "names": [
            "-m",
            "--model"
          ],
          "description": "Model the agent should use",
          "args": [
            {
              "name": "model"
            }
          ]
        },
        {
          "names": [
            "--oss"
          ],
          "description": "Use open-source provider"
        },
        {
          "names": [
            "--local-provider"
          ],
          "description": "Specify which local provider to use (with --oss)",
          "args": [
            {
              "name": "provider",
              "suggestions": [
                "lmstudio",
                "ollama"
              ]
            }
          ]
        },
        {
          "names": [
            "-p",
            "--profile"
          ],
          "description": "Configuration profile from config.toml",
          "args": [
            {
              "name": "profile"
            }
          ]
        },
        {
          "names": [
            "-s",
            "--sandbox"
          ],
          "description": "Sandbox policy for model-generated shell commands",
          "args": [
            {
              "name": "mode",
              "suggestions": [
                "read-only",
                "workspace-write",
                "danger-full-access"
              ]
            }
          ]
        },
        {
          "names": [
            "--dangerously-bypass-approvals-and-sandbox"
          ],
          "description": "Skip all confirmation prompts and run without sandboxing (EXTREMELY DANGEROUS)",
          "isDangerous": true
        },
        {
          "names": [
            "-C",
            "--cd"
          ],
          "description": "Agent working root",
          "args": [
            {
              "name": "dir",
              "template": "folders"
            }
          ]
        },
        {
          "names": [
            "--add-dir"
          ],
          "description": "Additional directories writable alongside primary workspace",
          "isRepeatable": -1,
          "args": [
            {
              "name": "dir",
              "template": "folders"
            }
          ]
        },
        {
          "names": [
            "-a",
            "--ask-for-approval"
          ],
          "description": "When the model requires human approval",
          "args": [
            {
              "name": "policy",
              "suggestions": [
                "untrusted",
                "on-failure",
                "on-request",
                "never"
              ]
            }
          ]
        },
        {
          "names": [
            "--search"
          ],
          "description": "Enable live web search (Responses `web_search` tool)"
        },
        {
          "names": [
            "--last"
          ],
          "description": "Resume the most recent recorded session"
        }
      ],
      "args": [
        {
          "name": "session_id",
          "description": "UUID or thread name",
          "isOptional": true
        },
        {
          "name": "prompt",
          "isOptional": true
        }
      ]
    },
    {
      "name": "fork",
      "description": "Fork a previous interactive session (picker by default; --last for most recent)",
      "options": [
        {
          "names": [
            "--last"
          ],
          "description": "Fork the most recent recorded session"
        }
      ],
      "args": [
        {
          "name": "session_id",
          "isOptional": true
        },
        {
          "name": "prompt",
          "isOptional": true
        }
      ]
    },
    {
      "name": "cloud",
      "description": "[EXPERIMENTAL] Browse tasks from Codex Cloud and apply changes locally"
    },
    {
      "name": "exec-server",
      "description": "[EXPERIMENTAL] Run the standalone exec-server service"
    },
    {
      "name": "features",
      "description": "Inspect feature flags"
    },
    {
      "name": "help",
      "description": "Print help",
      "args": [
        {
          "name": "command",
          "isOptional": true
        }
      ]
    }
  ]
}