ChatGPT CLI v1.10.2
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.
- If you previously used --param or --params with MCP, switch to --mcp-param and --mcp-params. Using these without --mcp will produce an error.