Getting Started

Getting Started

Welcome to AutoCI! AutoCI is your CI copilot that tells you why your build failed and gives you the fix — in seconds.

Installation

To install the AutoCI CLI, run the following command in your terminal:

curl -fsSL https://autoci.ai/install.sh | sh

This will download and install the latest version of the AutoCI CLI to your system.

Quick Start

Once installed, follow these steps to start using AutoCI:

1. Log in to your AutoCI account

autoci login

This will open a browser window for authentication. If you don’t have an account, you’ll be prompted to create one.

Working with multiple accounts? You can use profiles to manage multiple AutoCI accounts:

# Login to your primary account
autoci login --profile account-1
 
# Login to a secondary account
autoci login --profile account-2

This allows you to easily switch between personal, team, or client accounts. Learn more about profile management.

2. Analyze CI failures

AutoCI can analyze CI failures from any source - pull requests, direct commits, or scheduled workflows:

# Analyze a pull request
autoci failure-cause https://github.com/owner/repo/pull/123
 
# Analyze latest commit on main branch
autoci failure-cause --repo owner/repo --branch main
 
# Analyze from within your repository
cd /path/to/repo
autoci failure-cause
 
# Interactive mode - select from recent CI runs
autoci failure-cause --repo owner/repo --interactive

AutoCI will analyze the CI logs and provide a clear explanation of what failed and why.

Free Tier

The free tier includes:

  • 20 PR analyses per month
  • Root cause analysis for CI failures

Next Steps

IntroductionHow It Works