This release adds a new user guide on permissions and safety controls, introduces --device-code as an alias for device authentication, and expands headless-mode documentation with additional flags, project root handling, file locations, and session behavior details.
Added
- New documentation covering permissions and safety controls, including permission modes (
dontAsk,bypassPermissions, etc.), PreToolUse hooks, safe shell command allow-lists, and configuration examples for CI and restricted environments. --device-codeflag for device-code authentication flow (usable interchangeably with--device-auth).
Changed
- Bash and zsh shell completions updated to surface the new
--device-codeflag. - Authentication guide updated to document
--device-codeas an alternative for headless environments. - Headless mode guide expanded with new sections on additional flags (
--prompt-json,--prompt-file,--sandbox, etc.), project root discovery,~/.grokfile locations, update check suppression methods, SIGINT/SIGTERM exit codes, and session resumption.
Fixed
None.
Removed
None.
Upgrade notes
None.