Skip to content

ChatGPT CLI v1.10.2

Choose a tag to compare

@kardolus kardolus released this 11 Jan 15:08
· 57 commits to main since this release

New Features:

  • Web search (opt-in): Enable compatible models (gpt-5 family, non “-search” variants) to fetch live web data during a query.
    • How to enable: --web and --web-context-size [low|medium|high], or set web and web_context_size in config.
    • Implementation details: Automatically routes via the Responses API and injects a web_search tool with search_context_size.
    • Compatibility: Not supported by realtime models and blocked for non-gpt-5 or gpt-5-search models.
    • Code references: api/client/llm.go, api/responses.go, cmd/chatgpt/main.go, README.md, docs/chatgpt_api.md

Improvements:

  • Capability-driven request shaping:
    • Added capability flags: SupportsTopP, SupportsWebSearch, IsRealtime.
    • Temperature and top_p are now included conditionally based on model support (e.g., top_p omitted for gpt-5).
    • Forces Responses API when web search is enabled.
    • Code references: api/client/llm.go, api/client/llm_test.go
  • Model effort applicability: effort now documented as applicable to gpt-5 and o1-pro models.
    • Code reference: README.md
  • Documentation updates:
    • README config table now includes web and web_context_size options.
    • Fixed API endpoint docs and clarified capabilities.
    • Added a Web Search example to the API docs.
    • Code references: README.md, docs/chatgpt_api.md

Bug Fixes:

  • Corrected Audio API endpoint paths in documentation:
    • speech_path: /v1/audio/speech
    • transcriptions_path: /v1/audio/transcriptions
    • Code reference: README.md
  • CLI flag validation messages fixed to match actual flag names (mcp-param, mcp-params).
    • Code references: cmd/chatgpt/utils/utils.go, cmd/chatgpt/utils/utils_test.go

Other Changes:

  • Robust capability tests and web search tests added (including error cases for unsupported models and realtime).
    • Code reference: api/client/llm_test.go
  • New capabilities test suite for a range of models (gpt-4o, gpt-5, gpt-5-search, o1 variants, realtime).
    • Code reference: api/client/client_test.go, api/client/llm_test.go
  • API type additions for tools in Responses requests (web_search with search_context_size).
    • Code reference: api/responses.go

Upgrade Notes:

  • How to update:
    • Homebrew: brew upgrade chatgpt-cli
    • Direct download: Download the latest binaries for your OS from the releases page and replace your existing executable.
  • Enabling web search:
    • Use a gpt-5 family model (excluding -search and realtime variants), pass --web and optionally --web-context-size [low|medium|high], or set web and web_context_size in config.
    • The CLI will automatically use the Responses API and attach the web_search tool when web is enabled.
  • CLI flag changes:
    • If you previously used --param or --params with MCP, switch to --mcp-param and --mcp-params. Using these without --mcp will produce an error.
      • Endpoint clarifications:
    • Ensure any scripts or configs referencing audio endpoints use /v1/audio/speech and /v1/audio/transcriptions as documented.