Skip to main content

8. Use the Autoheal CLI

The autoheal CLI (short name ah) does the same work as the editor, from a terminal. When you install its skills into Claude Code, Cursor, Codex or GitHub Copilot, your coding agent can build and run Autoheal agents for you.

Step 1: Install the CLI​

BASH
curl -fsSL https://raw.githubusercontent.com/accelos/autoheal-cli/main/install.sh | sh

Or use Homebrew: brew install accelos/tap/autoheal.

If your computer blocks the download, ask your IT team to allow raw.githubusercontent.com, github.com and your Autoheal address. You can do all of this tutorial in the web app while you wait.

Step 2: Sign in and select a project​

BASH
autoheal login
autoheal project list
autoheal project use <project-id>

autoheal login opens a browser, where you confirm a code. Press Enter to sign in to autoheal.ai, or give --domain for your company's own Autoheal installation.

Step 3: Build and run an agent​

BASH
autoheal agents create deploy-check --name "Deploy Check" --model claude-sonnet-5

This command creates the agent in your project and writes its files to ./agents/deploy-check/. Edit agent.yaml and instructions.md, then:

BASH
autoheal agents validate agents/deploy-check
autoheal agents push agents/deploy-check -m "First version"
autoheal run deploy-check "Did the last deploy of web raise the error rate?" --follow

--follow prints the transcript while the run continues.

Step 4: Give the CLI to your coding agent​

BASH
autoheal skill install

This command finds Claude Code, Codex, Cursor and GitHub Copilot on your computer. It adds four small skills to each: build an agent, run an agent, Context Graph and on-call. It does not change anything else in your coding agent. If you installed the CLI with the install script, the script already asked you to do this step.

Then ask your coding agent in plain words, for example:

Make the pr-review agent check for missing database migrations, test it on
https://github.com/autohealai/astronomy-shop-template/pull/1, and push it.

What to know​

  • autoheal agents schema prints the full agent format. Your coding agent reads it, so you seldom write YAML yourself.
  • In CI, AUTOHEAL_TOKEN and AUTOHEAL_DOMAIN sign in without a browser. An API credential cannot reach projects, agents, runs or triggers yet, so pushing and running agents needs autoheal login. See Log in.
  • Add --json to a command to get output that a script can read.

See CLI for every command.