Skip to content

Add option to suppress non-fatal startup warnings #24070

Open

Description

@dhruv-anand-aintech

Summary

Please add a CLI/config option to disable or hide non-fatal yellow startup warnings in the Codex CLI.

Motivation

Some warnings are useful during setup, but can become persistent noise when they are known, non-blocking, or intentionally deferred. For example, on startup Codex currently prints warnings like:

⚠ Skipped loading 2 skill(s) due to invalid SKILL.md files.

⚠ /Users/dhruvanand/.codex/skills/canvas/SKILL.md: missing field `description`

⚠ /Users/dhruvanand/.agents/skills/canvas/SKILL.md: missing field `description`

⚠ MCP client for `html-portal` failed to start: MCP startup failed: handshaking
  with MCP server failed: connection closed: initialize response

⚠ MCP startup incomplete (failed: html-portal)

These are visible every time even when the CLI can otherwise continue normally.

Requested behavior

Add a supported way to suppress these non-fatal warnings, for example one of:

  • a config setting in ~/.codex/config.toml, such as hide_startup_warnings = true
  • a CLI flag, such as --quiet-startup-warnings
  • a more granular setting to disable specific warning categories, such as invalid skills vs MCP startup failures

Ideally errors that prevent Codex from running would still be shown; the request is specifically about warnings that do not block startup.

Environment

  • Codex CLI version: 0.133.0
  • Install source: Homebrew cask
  • OS: macOS

Activity

  1. added
    enhancementNew feature or request
    CLIIssues related to the Codex CLI
    configIssues involving config.toml, config keys, config merging, or config updates
    on May 22, 2026
  2. github-actions commented on May 22, 2026

    @github-actions
    Contributor

    Potential duplicates detected. Please review them and close your issue if it is a duplicate.

    Powered by Codex Action

  3. dhruv-anand-aintech commented on May 22, 2026

    @dhruv-anand-aintech
    Author

    not duplicates of those

  4. lamka02sk commented on Aug 10, 2026

    @lamka02sk

    Guys, it is august. AI can probably implement this in a blink of an eye.

  5. skibitskiy commented on Sep 2, 2026

    @skibitskiy

    This is annoying

    Image
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    CLIIssues related to the Codex CLIconfigIssues involving config.toml, config keys, config merging, or config updatesenhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions