Headless and CI runs

A step of the Claude Code development environment tree on Gradus, in the Tools & reach area: MCP, IDE, headless runs.

Run the assistant non-interactively from scripts and CI, with a fixed prompt, a fixed set of allowed tools and JSON output.

Usually comes after: MCP servers.

Prompt for your AI assistant

Add a script that runs Claude Code in non-interactive mode with a fixed prompt (for example summarising the changes in a pull request), restricted to read-only tools, with JSON output. Wire it into the CI workflow as an optional job and document the required API key secret.

This is https://gradus.kazet.blog/tree/claude-dev-environment/step/headless-runs as plain HTML. In a browser the page also lets you mark the step forged and copy a message for your AI assistant.