Skip to content

docs: document --message with --auto-test for headless runs - #5610

Open
aniruddhaadak80 wants to merge 1 commit into
Aider-AI:mainfrom
aniruddhaadak80:docs/headless-auto-test
Open

docs: document --message with --auto-test for headless runs#5610
aniruddhaadak80 wants to merge 1 commit into
Aider-AI:mainfrom
aniruddhaadak80:docs/headless-auto-test

Conversation

@aniruddhaadak80

Copy link
Copy Markdown

Summary

Documents how to combine --auto-test / --test-cmd with --message for headless (CI, scripting, benchmark) runs, as requested in #4923.

The problem

The scripting docs show how to run aider one-shot with --message, and the linting and testing docs explain --auto-test/--test-cmd - but only in an interactive context. Nothing tells headless users that a scripted --message run by default applies edits and exits without any compile/test verification, or that adding --yes-always --auto-test --test-cmd "..." gives them the same automatic fix-the-failing-tests loop in CI. As #4923 describes, this leads to benchmark/CI results full of unverified, broken edits.

Changes

In aider/website/docs/scripting.md:

  • Add --auto-test and --test-cmd to the list of command-line options useful for scripting (help text copied verbatim from aider --help)
  • New subsection "Verifying headless changes with tests" with a concrete example combining --message, --yes-always, --no-auto-commits, --auto-test, and --test-cmd
  • Explain the contract (print errors to stdout/stderr, non-zero exit code on failure), the automatic retry behavior (up to three reflection rounds, matching max_reflections = 3 in base_coder.py), and link to the linting/testing docs for per-language configuration

Docs-only change; no code affected.

Fixes #4923

@CLAassistant

CLAassistant commented Aug 22, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

A scripted --message run applies edits and exits without verifying
them. Document how to combine --auto-test and --test-cmd with
--message/--yes-always so headless (CI, benchmark) runs automatically
fix compile/test failures before exiting.

Fixes Aider-AI#4923
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document --message + --auto-test for headless CI/benchmark usage

2 participants