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
- macOS / Linux
- Windows
curl -fsSL https://raw.githubusercontent.com/accelos/autoheal-cli/main/install.sh | sh
Or use Homebrew: brew install accelos/tap/autoheal.
Use Scoop or the PowerShell installer. See CLI for the commands.
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
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
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:
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
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 schemaprints the full agent format. Your coding agent reads it, so you seldom write YAML yourself.- In CI,
AUTOHEAL_TOKENandAUTOHEAL_DOMAINsign in without a browser. An API credential cannot reach projects, agents, runs or triggers yet, so pushing and running agents needsautoheal login. See Log in. - Add
--jsonto a command to get output that a script can read.
See CLI for every command.