Skip to content

pyproject.toml: [tool.quell] settings

The Python package reads its settings from a [tool.quell] table in pyproject.toml. Run quell init to add the defaults, then edit the keys below. Settings are optional: with no table, quell uses safe defaults (rule-based only, no LLM).

How is the configuration loaded?

The command reads pyproject.toml in the project root (--root), takes [tool.quell], and validates it with a Pydantic model. Keys the model does not define are ignored. If the table cannot be parsed or a value has the wrong type, quell silently falls back to the safe defaults, so check that a setting really takes effect after you change it.

Which keys exist?

The last column says where the key is read in the code tested for these docs (the repository at 2.0.1). Keys marked "defined only" are part of the model and written by quell init, but no command path read them, so changing them has no effect yet.

KeyTypeDefault in the modelRead by
llm_providerstring"anthropic" (quell init writes "groq"; with no table, "none")LLM client when --use-llm is passed: groq, anthropic, openai or ollama
llm_modelstring"claude-sonnet-4-5" (quell init writes "llama-3.3-70b-versatile")LLM providers
ollama_base_urlstring"http://localhost:11434"Ollama provider
verification_timeout_secondsint30Verifier: timeout for each pytest run
backup_dirpath".quell/backups"Verifier and fix suggester: temporary files and backups
audit_log_pathpath".quell/audit.jsonl"Writer: one log entry per write
scaffold_dirpath"tests/scaffold"Scaffold stubs for gaps that cannot be auto-tested
enable_pysparkboolfalsePython SDK and MCP tools: read PySpark schemas (needs the pyspark extra)
syncboolfalsequell sync status: opt in to cloud sync; never enabled automatically
sync_project_aliasstring""Cloud sync: project name in the dashboard and in Claude
use_llmboolfalsedefined only: use the --use-llm flag
max_verification_attemptsint3defined only
auto_writeboolfalsedefined only for quell find
enable_docstring, enable_typesbooltruedefined only
enable_mutationsboolfalsedefined only (mutmut integration is off by default and not required)
score_threshold, diff_onlyfloat, bool0.0, falsedefined only
prs_thresholdint60defined only: quell ci takes its threshold from --threshold
sync_include_scaffolded, sync_include_flagged_locationsbooltruedefined only

Keys that earlier documentation listed, such as paths, exclude, test_dir, threshold, enable_llm and min_confidence, do not exist in the model.

What is a minimal configuration?

[tool.quell]
llm_provider = "groq"
scaffold_dir = "tests/scaffold"

Where do I read more?

See LLM providers and the connector setup.

The npm package has no configuration file: it uses command-line flags and a .quellignore file. See the npm CLI reference.