Quick Start

Quick Start

1) Install

pipx install agentinit

2) Initialize in the current repo

agentinit init

3) Minimal setup

agentinit minimal

4) Create a new project

agentinit new todo-app \
  --purpose "Una semplice API REST per gestire todo list con FastAPI + SQLite" \
  --detect --translate-purpose --skeleton fastapi --yes

5) Translate non-English purpose (recommended)

agentinit init --detect --purpose "Una semplice API REST per gestire todo list con FastAPI + SQLite" --translate-purpose

6) Optional: scaffold FastAPI boilerplate

agentinit new demo-fastapi --detect --purpose "Modern FastAPI API with SQLite" --skeleton fastapi

7) Refresh AI index

agentinit refresh-llms

8) Validate context quality

agentinit status --check
agentinit sync --check
agentinit lint

For contributors (development install)

If you are working on agentinit itself (not using it as an end user):

python3 -m venv .venv
. .venv/bin/activate
pip install -e . --group dev
python3 -m ruff check agentinit tests cli
python3 -m ruff format --check agentinit tests cli
python3 -m pytest tests/ -v

On distro-managed Python installs that enforce PEP 668, use a virtual environment instead of the system interpreter for development commands.