Installation

Prerequisites

• Node.js 20+
• git
• At least one configured agent CLI on PATH (Codex, Claude, Cursor, OpenCode, Gemini, or Copilot)
• Bitbucket credentials with clone, push, and pull request access
• Provider tokens for your issue source (Sentry, Jira Cloud, or Discord)
• Discord or Telegram credentials for run notifications

Install the CLI

Install the latest release with the script below.

curl -fsSL https://cli.getautohealer.com/install.sh | bash
export PATH="$HOME/.autohealer/bin:$PATH"   # add to ~/.zshrc if needed

Pin a version by passing --version v0.1.0 to the install script.

First-time setup

autohealer login
autohealer init
autohealer config validate
autohealer doctor
autohealer run backend --issue 123456789

• autohealer login: link this machine to your account.
• autohealer init: create autohealer.yml, ~/.autohealer/.env, and a project .env.example.
• autohealer config validate: check workflow config before your first run.
• autohealer doctor: verify tokens, agents, and provider access.

Init

autohealer init
autohealer init --force

Scaffolds starter files in the current repository. Use --force to overwrite existing generated files. You can also create only the global env file with autohealer config env init.

Updates

autohealer update
autohealer update --check

When a newer release is available, the CLI prints a one-line hint on startup. Disable with AUTOHEALER_SKIP_UPDATE_CHECK=1.