Sign in
← AI PulseAug 20, 2026

Wire · news · Multi-source brief

xAI Introduces Grok Headless Mode and ACP Agent Mode for Scripting

xAI has released headless mode and ACP agent mode for Grok, enabling machine-friendly tasks, scripting, and integration with IDEs and other tools.

By Illumora Editorial

Source · Aug 20, 2026, 3:13 PM · On Illumora · Aug 20, 2026, 3:43 PM

Media from the primary source — shown here so you can stay on Illumora.

Synthesized from multiple allowlisted primaries on the same event. Lanes →

Brief drafted by Illumora’s editorial model from the linked primary source. Ops desk reviews flagged pieces. How we write →

Read the source →xAI Docs — Headless & Scripting | SpaceXAI Docs
Save

xAI has introduced a headless mode for Grok, designed for scripts, bots, and other automated tasks. This functionality allows users to interact with Grok from the command line, specifying prompts and output formats. Additionally, xAI provides an ACP agent mode for integration with development environments and tools.

Key Points

  • Headless mode in Grok is activated using the grok -p command for single prompts.
  • Users can select output formats including plain, json, or streaming-json using the --output-format flag.
  • Headless sessions can be managed with flags such as --session-id, --resume, and --continue, with session data stored in ~/.grok/sessions.
  • The --no-auto-update flag can suppress background update checks in headless mode or ACP agent mode for automated environments.
  • ACP agent mode is intended for integration with IDEs or other tools, offering an alternative to terminal sessions.
  • Grok 4.6 is xAI's frontier model, designed for coding, agentic tasks, and knowledge work.
  • The Responses API supports a WebSocket mode for lower-latency, tool-call-heavy workflows, suitable for agentic workloads with many sequential tool calls.

Context

According to xAI documentation, headless mode facilitates machine-friendly interactions with Grok, allowing for programmatic control and output formatting. The ACP agent mode is presented as a solution for deeper integration into development workflows. xAI also notes that Grok 4.6 is their latest model, optimized for complex tasks including coding and agentic operations. For advanced API usage, xAI offers a WebSocket mode for its Responses API, which maintains a persistent connection to reduce latency in workflows involving numerous tool calls.

Why It Matters

These features enhance Grok's utility for developers and engineers by providing flexible methods for automation and integration. The introduction of headless and ACP agent modes, alongside the Grok 4.6 model and WebSocket API capabilities, enables more efficient development of automated systems and agentic applications.

What To Do

  • Test Grok's headless mode by running grok -p "Your prompt here" in a script.
  • Experiment with different output formats using --output-format json or --output-format streaming-json to suit scripting needs.
  • Note the --no-auto-update flag for use in CI/CD pipelines or other automated environments to prevent interruptions.
  • Explore the Responses API's WebSocket mode for agentic workloads requiring low-latency, persistent connections.

Keep Exploring

/atlas/**grok**-family /techniques/system-user-separation /techniques/output-schema