---
title: Quick Start
description: Get started quickly with heretic-cli to set up and run your first AI-powered workflow
canonical: https://giglabo.com/heretic/docs/getting-started/quick-start
locale: en
---

# Quick Start

> Markdown twin of https://giglabo.com/heretic/docs/getting-started/quick-start
> Fetch this instead of the HTML page: same content, a fraction of the bytes.
> Site structure and the full page list for agents: https://giglabo.com/llms.txt

Get started quickly with heretic-cli to set up and run your first AI-powered workflow

## heretic-cli

The **heretic-cli** is the primary tool for setting up and managing your Heretic environment. It handles installation, configuration, Docker image management, and running workflows locally.

Install and initialize with a single command:

```bash
npx heretic-cli init
```

This will scaffold the configuration files, pull Docker images, and prepare your environment.

For detailed CLI documentation, see:

- [heretic-cli Overview](https://giglabo.com/heretic/docs/heretic-cli) - Full CLI reference
- [Installation](https://giglabo.com/heretic/docs/heretic-cli/installation) - Setup and system requirements
- [Commands](https://giglabo.com/heretic/docs/heretic-cli/commands) - All available commands
- [Configuration](https://giglabo.com/heretic/docs/heretic-cli/configuration) - Workflow and agent configuration

## Heretic Orchestration

The **Heretic** orchestration system is the engine that runs your AI-powered workflows. It connects your Kanban board, orchestrator service, and AI agent containers into a unified pipeline.

Key concepts:

- **Workflows** define how tasks flow through your development pipeline
- **Docker Images** package AI agents with all their tools and dependencies
- **Kanban Integration** provides the interface between humans and AI agents

For a deeper dive into the orchestration system:

- [Heretic Overview](https://giglabo.com/heretic/docs/heretic) - System architecture and concepts
- [Docker Images](https://giglabo.com/heretic/docs/heretic/docker-images) - Building and running agent containers
- [FAQ](https://giglabo.com/heretic/docs/heretic/faq) - Common questions and answers

> **Success: Ready to Go**
>
> With heretic-cli installed, you can start automating your development workflow. Create a task card on your Kanban board and watch the AI agent process it automatically.

## Related

- HTML version of this page: https://giglabo.com/heretic/docs/getting-started/quick-start
- Site map for agents: https://giglabo.com/llms.txt