Error: Manual response is missing x-content-sha256.

Resolved 💬 1 comment Opened Jul 12, 2026 by ammachado Closed Jul 12, 2026

What version of Codex CLI is running?

codex-cli 0.144.1

What subscription do you have?

Pro

Which model were you using?

got-5.6-sol high

What platform is your computer?

Darwin 25.5.0 arm64 arm

What terminal emulator and version are you using (if applicable)?

Ghostty

Codex doctor report

{
  "schemaVersion": 1,
  "generatedAt": "1783876300s since unix epoch",
  "overallStatus": "ok",
  "codexVersion": "0.144.1",
  "checks": {
    "app_server.status": {
      "id": "app_server.status",
      "category": "app-server",
      "status": "ok",
      "summary": "background server is not running",
      "details": {
        "control socket": "/Users/ammachado/.codex/app-server-control/app-server-control.sock",
        "daemon state dir": "/Users/ammachado/.codex/app-server-daemon",
        "mode": "ephemeral",
        "pid file": "/Users/ammachado/.codex/app-server-daemon/app-server.pid (missing)",
        "settings": "/Users/ammachado/.codex/app-server-daemon/settings.json (missing)",
        "status": "not running",
        "update-loop pid file": "/Users/ammachado/.codex/app-server-daemon/app-server-updater.pid (missing)"
      },
      "remediation": null,
      "durationMs": 0
    },
    "auth.credentials": {
      "id": "auth.credentials",
      "category": "auth",
      "status": "ok",
      "summary": "auth is configured",
      "details": {
        "auth file": "/Users/ammachado/.codex/auth.json",
        "auth storage mode": "File",
        "stored API key": "false",
        "stored ChatGPT tokens": "true",
        "stored agent identity": "false",
        "stored auth mode": "chatgpt"
      },
      "remediation": null,
      "durationMs": 0
    },
    "config.load": {
      "id": "config.load",
      "category": "config",
      "status": "ok",
      "summary": "config loaded",
      "details": {
        "CODEX_HOME": "/Users/ammachado/.codex",
        "config.toml": "/Users/ammachado/.codex/config.toml",
        "config.toml parse": "ok",
        "cwd": "/Users/ammachado/Projects/Opensource/camel/main",
        "enabled feature flags": "shell_tool, unified_exec, shell_snapshot, code_mode_host, terminal_resize_reflow, sqlite, memories, hooks, enable_request_compression, network_proxy, multi_agent, apps, tool_search_always_defer_mcp_tools, tool_suggest, plugins, in_app_browser, browser_use, browser_use_full_cdp_access, browser_use_external, computer_use, remote_plugin, plugin_sharing, image_generation, resize_all_images, skill_mcp_dependency_install, mentions_v2, steer, guardian_approval, goals, collaboration_modes, tool_call_mcp_elicitation, auth_elicitation, personality, fast_mode, tui_app_server, prevent_idle_sleep, remote_compaction_v2, workspace_dependencies",
        "feature flag overrides": "memories=true, network_proxy=true, prevent_idle_sleep=true",
        "feature flags enabled": "38",
        "log dir": "/Users/ammachado/.codex/log",
        "mcp servers": "1",
        "model": "gpt-5.6-sol",
        "model provider": "openai",
        "sqlite home": "/Users/ammachado/.codex"
      },
      "remediation": null,
      "durationMs": 0
    },
    "git.environment": {
      "id": "git.environment",
      "category": "git",
      "status": "ok",
      "summary": "git version 2.50.1 (Apple Git-155)",
      "details": {
        ".git entry": "file -> /Users/ammachado/Projects/Opensource/camel/.git/worktrees/main",
        "PATH git #1": "/usr/bin/git",
        "PATH git entries": "1",
        "git branch": "CAMEL-24007",
        "git build options": "git version 2.50.1 (Apple Git-155); cpu: arm64; no commit associated with this build; sizeof-long: 8; sizeof-size_t: 8; shell-path: /bin/sh; feature: fsmonitor--daemon; libcurl: 8.7.1; zlib: 1.2.12; SHA-1: SHA1_DC; SHA-256: SHA256_BLK",
        "git exec path": "/Applications/Xcode.app/Contents/Developer/usr/libexec/git-core",
        "git version": "git version 2.50.1 (Apple Git-155)",
        "repo detected": "true",
        "repo root": "/Users/ammachado/Projects/Opensource/camel/main",
        "selected git": "/usr/bin/git"
      },
      "remediation": null,
      "durationMs": 94
    },
    "installation": {
      "id": "installation",
      "category": "install",
      "status": "ok",
      "summary": "installation looks consistent",
      "details": {
        "PATH codex #1": "/opt/homebrew/bin/codex",
        "current executable": "/opt/homebrew/bin/codex",
        "install context": "brew",
        "managed by bun": "false",
        "managed by npm": "false",
        "managed by pnpm": "false",
        "managed package root": "not set"
      },
      "remediation": null,
      "durationMs": 2
    },
    "mcp.config": {
      "id": "mcp.config",
      "category": "mcp",
      "status": "ok",
      "summary": "MCP configuration is locally consistent",
      "details": {
        "configured servers": "1",
        "disabled servers": "0",
        "stdio servers": "1"
      },
      "remediation": null,
      "durationMs": 0
    },
    "network.env": {
      "id": "network.env",
      "category": "network",
      "status": "ok",
      "summary": "network-related environment looks readable",
      "details": {
        "proxy env vars": "none"
      },
      "remediation": null,
      "durationMs": 0
    },
    "network.provider_reachability": {
      "id": "network.provider_reachability",
      "category": "reachability",
      "status": "ok",
      "summary": "active provider endpoints are reachable over HTTP",
      "details": {
        "ChatGPT base URL": "https://chatgpt.com/backend-api/ reachable (HTTP 404)",
        "reachability mode": "ChatGPT auth"
      },
      "remediation": null,
      "durationMs": 273
    },
    "network.websocket_reachability": {
      "id": "network.websocket_reachability",
      "category": "websocket",
      "status": "ok",
      "summary": "Responses WebSocket handshake succeeded",
      "details": {
        "DNS": "2 IPv4, 0 IPv6, first IPv4",
        "auth mode": "chatgpt",
        "connect timeout": "15000 ms",
        "endpoint": "wss://chatgpt.com/backend-api/<redacted>",
        "handshake result": "HTTP 101 Switching Protocols",
        "model provider": "openai",
        "models etag present": "true",
        "provider name": "OpenAI",
        "proxy env vars": "none",
        "reasoning header": "false",
        "server model present": "false",
        "supports websockets": "true",
        "wire API": "responses"
      },
      "remediation": null,
      "durationMs": 1245
    },
    "runtime.provenance": {
      "id": "runtime.provenance",
      "category": "runtime",
      "status": "ok",
      "summary": "running brew on macos-aarch64",
      "details": {
        "commit": "unknown",
        "current executable": "/opt/homebrew/bin/codex",
        "install method": "brew",
        "platform": "macos-aarch64",
        "version": "0.144.1"
      },
      "remediation": null,
      "durationMs": 0
    },
    "runtime.search": {
      "id": "runtime.search",
      "category": "search",
      "status": "ok",
      "summary": "search is OK (system)",
      "details": {
        "search command": "rg",
        "search command readiness": "ripgrep 15.1.0",
        "search provider": "system"
      },
      "remediation": null,
      "durationMs": 2
    },
    "sandbox.helpers": {
      "id": "sandbox.helpers",
      "category": "sandbox",
      "status": "ok",
      "summary": "sandbox configuration is readable",
      "details": {
        "approval policy": "OnRequest",
        "codex-linux-sandbox helper": "none",
        "execve wrapper helper": "/Users/ammachado/.codex/tmp/arg0/codex-arg0gt9h29/codex-execve-wrapper",
        "filesystem sandbox": "restricted",
        "network sandbox": "restricted"
      },
      "remediation": null,
      "durationMs": 0
    },
    "state.paths": {
      "id": "state.paths",
      "category": "state",
      "status": "ok",
      "summary": "state paths and databases are inspectable",
      "details": {
        "CODEX_HOME": "/Users/ammachado/.codex (dir)",
        "active rollout files": "16 files, 6876121 total bytes, 429757 average bytes",
        "archived rollout files": "0 files, 0 total bytes, 0 average bytes",
        "goals DB": "/Users/ammachado/.codex/goals_1.sqlite (file)",
        "goals DB integrity": "ok",
        "log DB": "/Users/ammachado/.codex/logs_2.sqlite (file)",
        "log DB integrity": "ok",
        "log dir": "/Users/ammachado/.codex/log (missing)",
        "memories DB": "/Users/ammachado/.codex/memories_1.sqlite (file)",
        "memories DB integrity": "ok",
        "sqlite home": "/Users/ammachado/.codex (dir)",
        "state DB": "/Users/ammachado/.codex/state_5.sqlite (file)",
        "state DB integrity": "ok"
      },
      "remediation": null,
      "durationMs": 119
    },
    "state.rollout_db_parity": {
      "id": "state.rollout_db_parity",
      "category": "threads",
      "status": "ok",
      "summary": "rollout files and state DB thread inventory agree",
      "details": {
        "default model provider": "openai",
        "rollout DB active files": "16",
        "rollout DB active rows": "16",
        "rollout DB archive mismatches": "0",
        "rollout DB archived files": "0",
        "rollout DB archived rows": "0",
        "rollout DB duplicate DB paths": "0",
        "rollout DB duplicate rollout thread ids": "0",
        "rollout DB malformed file names": "0",
        "rollout DB missing active rows": "0",
        "rollout DB missing archived rows": "0",
        "rollout DB model providers": "openai=16",
        "rollout DB rows": "16",
        "rollout DB scan cap reached": "false",
        "rollout DB scan errors": "0",
        "rollout DB sources": "cli=12, exec=3, subagent:thread_spawn=1",
        "rollout DB stale rows": "0"
      },
      "remediation": null,
      "durationMs": 119
    },
    "system.environment": {
      "id": "system.environment",
      "category": "system",
      "status": "ok",
      "summary": "OS language en-US",
      "details": {
        "EDITOR": "set",
        "LANG": "en_US.UTF-8",
        "LESS": "set",
        "PAGER": "set",
        "VISUAL": "not set",
        "os": "Mac OS 26.5.2 [64-bit]",
        "os language": "en-US",
        "os type": "Mac OS",
        "os version": "26.5.2"
      },
      "remediation": null,
      "durationMs": 1
    },
    "terminal.env": {
      "id": "terminal.env",
      "category": "terminal",
      "status": "ok",
      "summary": "terminal metadata was detected",
      "details": {
        "COLORTERM": "truecolor",
        "TERMINFO": "/usr/share/terminfo/ (dir)",
        "TERM_PROGRAM": "ghostty",
        "color output": "disabled (stdout is not a terminal)",
        "effective locale": "en_US.UTF-8",
        "stderr is terminal": "true",
        "stdin is terminal": "true",
        "stdout is terminal": "false",
        "terminal": "Ghostty",
        "terminal size": "188x59",
        "terminal version": "1.3.1"
      },
      "remediation": null,
      "durationMs": 0
    },
    "terminal.title": {
      "id": "terminal.title",
      "category": "title",
      "status": "ok",
      "summary": "terminal title default",
      "details": {
        "terminal title activity": "true",
        "terminal title items": "activity, project-name",
        "terminal title project source": "git repo root",
        "terminal title project value": "main",
        "terminal title source": "default"
      },
      "remediation": null,
      "durationMs": 0
    },
    "updates.status": {
      "id": "updates.status",
      "category": "updates",
      "status": "ok",
      "summary": "update configuration is locally consistent",
      "details": {
        "cached latest version": "0.144.1",
        "check for update on startup": "true",
        "last checked at": "2026-07-12T16:46:16.031683Z",
        "latest version": "0.144.1",
        "latest version status": "current version is not older",
        "update action": "brew upgrade --cask codex",
        "version cache": "/Users/ammachado/.codex/version.json"
      },
      "remediation": null,
      "durationMs": 102
    }
  }
}

What issue are you seeing?

I'm getting an error trying to use Codex to provide information on how to configure permissions.

...

• I’m using the openai-docs skill because this is a Codex configuration task; I’ll prefer the local Codex configuration/manual sources and only use official docs if the local material
  doesn’t define the import behavior.

...

$ node /Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs
Error: HEAD https://developers.openai.com/codex/codex-manual.md could not be fetched.

Details:
ManualFetchError: HEAD https://developers.openai.com/codex/codex-manual.md could not be fetched.
    at requestManual (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:211:9)
    at async fetchCodexManual (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:421:24)
    at async main (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:534:35) {
  [cause]: ManualFetchError: HEAD https://developers.openai.com/codex/codex-manual.md could not be fetched.
      at requestManualWithCurl (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:161:9)
      at async requestManual (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:199:24)
      at async fetchCodexManual (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:421:24)
      at async main (file:///Users/ammachado/.codex/skills/.system/openai-docs/scripts/fetch-codex-manual.mjs:534:35) {
    [cause]: Error: Command failed: curl --silent --show-error --location --dump-header
/var/folders/gc/krzznsld25s78f1lvl6jdz0h0000gn/T/openai-docs-cache/.fetch-codex-manual-81380-1783876722314-2b14fa44dbd58.headers --output
/var/folders/gc/krzznsld25s78f1lvl6jdz0h0000gn/T/openai-docs-cache/.fetch-codex-manual-81380-1783876722314-9c2558321b9cf.body --user-agent codex-openai-docs --max-time 30 --head
https://developers.openai.com/codex/codex-manual.md
    curl: (6) Could not resolve host: developers.openai.com

        at genericNodeError (node:internal/errors:999:15)
        at wrappedFn (node:internal/errors:544:14)
        at ChildProcess.exithandler (node:child_process:417:12)
        at ChildProcess.emit (node:events:509:20)
        at maybeClose (node:internal/child_process:1125:16)
        at Socket.<anonymous> (node:internal/child_process:497:11)
        at Socket.emit (node:events:509:20)
        at Pipe.<anonymous> (node:net:355:12) {
      code: 6,
      killed: false,
      signal: null,
      cmd: 'curl --silent --show-error --location --dump-header
/var/folders/gc/krzznsld25s78f1lvl6jdz0h0000gn/T/openai-docs-cache/.fetch-codex-manual-81380-1783876722314-2b14fa44dbd58.headers --output
/var/folders/gc/krzznsld25s78f1lvl6jdz0h0000gn/T/openai-docs-cache/.fetch-codex-manual-81380-1783876722314-9c2558321b9cf.body --user-agent codex-openai-docs --max-time 30 --head
https://developers.openai.com/codex/codex-manual.md',
      stdout: '',
      stderr: 'curl: (6) Could not resolve host: developers.openai.com\n'
    }
  }
}

What steps can reproduce the bug?

Uploaded thread: 019f573c-51f2-7cb1-91f4-df1c4c3fc1c5

What is the expected behavior?

_No response_

Additional information

_No response_

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗