Skip to main content
Install Autter once on each developer machine. You do not need per-repository setup.

​
Requirements

  • Git
  • A supported macOS, Linux, WSL, or Windows environment
  • At least one supported coding agent for automatic attribution

​
Install

Run the installer:
Do not run Autter as root or with sudo. Elevated installation can create files your normal user cannot update.
The installer places Autter in ~/.autter/bin, adds it to your user PATH, configures supported coding agents and editors, and starts the background service. On macOS, Linux, and WSL, make autter available in the terminal you already have open (the installer prints this command at the end too):
For fish, use source "$HOME/.autter/env.fish". New terminals pick up the PATH automatically. Restart your IDE — not just its terminal tab — so IDE terminals and coding agents see it too. Interactive macOS, Linux, and WSL installs start onboarding automatically. If the installer runs without an interactive terminal, complete onboarding later with autter onboard.

​
Complete onboarding

The installer asks whether you want local-only or connected mode.
Placeholder for the Autter CLI onboarding choices

Replace this placeholder with the final onboarding terminal screenshot.

Choose local-only mode to keep prompts on the machine and use Git notes for attribution.You can select it again later:

​
Verify the installation

  • autter --version prints the installed version.
  • autter doctor validates the installation end-to-end, including a test checkpoint, and prints a fix for every failed check.
  • autter whoami shows whether the CLI is connected.

​
Verify an agent integration

Start a fresh coding-agent session after installation. Ask the agent to edit a tracked file, then run:
Commit the change and inspect its attribution:
If you installed a new coding agent after Autter, run autter install-hooks to refresh integrations.

​
Update Autter

Use autter upgrade --force to reinstall the latest release. This works for every install method, including npm: the npm package is only a bootstrapper, and autter upgrade (or the background service’s automatic update) replaces the binary in ~/.autter/bin directly. Running npm update -g @autter/cli is not required.

​
Next step

Connect to the platform

Learn what connection enables and how repository data is routed to your organization.