CLI configuration

Autter stores machine-level configuration in ~/.autter/config.json. Use autter config instead of editing the file directly.

Manage configuration

# Show effective configuration
autter config

# Read one value
autter config prompt_storage

# Set a value
autter config set prompt_storage local

# Add an item to an array
autter config --add exclude_repositories "https://github.com/acme/sandbox-*"

# Remove a value and return to its default
autter config unset prompt_storage

Storage and privacy options

Key	Values	Purpose
`prompt_storage`	`default`, `notes`, `local`	Choose where prompt records are stored
`telemetry_oss`	`off`	Disable open source error and exception telemetry
`allow_repositories`	Repository patterns	Run Autter only for matching repositories
`exclude_repositories`	Repository patterns	Disable Autter for matching repositories
`notes_backend.kind`	`git_notes`, `http`	Select local-only or connected backend behavior; connected mode still writes local Git notes
`notes_backend.backend_url`	URL	Set the notes backend gate for hosted or self-hosted use

prompt_storage: notes places prompt content in Git notes. Anyone with access to those notes can read it. Prefer local or your organization’s prompt store for sensitive repositories.

Repository patterns

Repository filters accept remote URL patterns or local paths. Exclusion wins when a repository matches both lists.

# Disable Autter for the current repository
autter config --add exclude_repositories .

# Allow only repositories in one organization
autter config set allow_repositories "https://github.com/acme/*"

# Add another allowed repository
autter config --add allow_repositories ~/code/customer-portal

Updates

autter config set disable_auto_updates true
autter config set disable_version_checks true

Set update_channel to latest for stable releases or next for prereleases.

Identity override

Autter normally uses your Git identity. Set an explicit identity when your environment does not provide one:

autter config set author.name "Alice Example"
autter config set author.email alice@example.com

Environment overrides

Use environment variables for CI or self-hosted deployments:

Variable	Purpose
`AUTTER_API_BASE_URL`	Authentication and token-exchange API
`AUTTER_WEB_URL`	Browser dashboard URL
`AUTTER_NOTES_BACKEND_KIND`	Notes backend selection
`AUTTER_NOTES_BACKEND_URL`	Notes backend gate URL
`AUTTER_API_KEY`	Non-interactive CI authentication

Do not commit AUTTER_API_KEY or access tokens. Store them in your CI secret manager.

Get started

Context

Use attribution

Reference

Supported agents

CLI configuration

Manage configuration

Storage and privacy options

Repository patterns

Updates

Identity override

Environment overrides

​Manage configuration

​Storage and privacy options

​Repository patterns

​Updates

​Identity override

​Environment overrides

Manage configuration

Storage and privacy options

Repository patterns

Updates

Identity override

Environment overrides