Getting Started

Prerequisites

• Python 3.11+ — check with python3 --version
• Git — check with git --version
• Any AI coding agent — Claude Code, GitHub Copilot, Cursor, Windsurf, or any of the 15+ supported agents

Installation

uv tool install auro-cli

If you do not have uv:

curl -LsSf https://astral.sh/uv/install.sh | sh

Verify: auro --version

Initialize a Project

auro init my-project
cd my-project

This creates:

my-project/
  .auro/
    templates/       # Charter, plan, and task templates
    scripts/         # Slash command definitions
    memory/          # Persistent context for AI agents
    constitution.md  # Governing principles

The .auro/ directory is the source of truth. Everything else is derived from it.

Agent Setup

Auro auto-detects your AI agent. Verify with:

auro doctor

The Quick Workflow

Four commands, run inside your AI agent’s chat:

1. Set Your Constitution

/auro.constitution

Define the rules that every charter, plan, and task must follow. Once per project.

2. Write a Charter

/auro.charter

Describe what you want to build. The agent produces structured charters with user stories, requirements, and acceptance criteria.

3. Generate a Plan

/auro.plan

The agent reads your charter and produces a technical plan with architecture decisions and phase gates.

4. Create Tasks

/auro.tasks

The agent breaks the plan into phased, parallel-ready task lists. Then /auro.implement to execute them.

The Feedback Loop

A

Constitution

B

Charter

C

Plan

D

Tasks

E

Implement

Loop: completed implementation informs the next Charter pass.

After implementation, update charters based on what you learned and run through the cycle again.

Next Steps

Before framing anything, you need a constitution. Continue to Your Constitution.