Skip to main content
This guide walks you through initializing a new project, configuring an LLM provider, and launching the web dashboard.

​
1. Initialize

Navigate to your project directory (or create a new one) and run: 
cd my-project
skaro init
The init wizard will ask you to:
  1. Choose a language — English or Russian (affects UI and prompts)
  2. Accept the license — AGPL-3.0
  3. Enter the project name — defaults to the current directory name
After this, Skaro creates a .skaro/ directory with starter templates: 
.skaro/
├── constitution.md              # Your project principles (fill this in)
├── architecture/
│   └── architecture.md          # Architecture document (fill this in)
├── config.yaml                  # LLM and project settings
├── templates/                   # Bundled templates for all artifacts
└── ...
It also creates a .skaroignore file in the project root (similar to .gitignore) that controls which files are excluded from LLM analysis.
If Skaro detects an existing project (a .git directory or 3+ source files), it will offer two options: A) fill artifacts manually, or B) analyze the repository with an LLM automatically. See the Import Existing Project guide for details.

​
2. Configure LLM

Skaro needs an LLM provider to power its phases. The fastest way to get started is with Groq (free tier available): 
skaro config --provider groq --api-key gsk_your_key_here
This saves your provider and model to .skaro/config.yaml and the API key to .skaro/secrets.yaml (which is automatically added to .gitignore). Other providers work the same way: 
# Anthropic
skaro config --provider anthropic --api-key sk-ant-...

# OpenAI
skaro config --provider openai --api-key sk-...

# Ollama (local, no key needed)
skaro config --provider ollama --model qwen3:32b
Verify your config: 
skaro config --show

​
3. Launch the Dashboard

skaro ui
This starts the web dashboard at http://localhost:4700 and opens your browser automatically. The dashboard is where you run all development phases: edit the constitution, review architecture, create tasks, and step through clarify → plan → implement → tests.
Use --port 8080 to specify a custom port, or --no-browser to prevent the browser from opening automatically.

​
4. What’s Next

From the dashboard you can:
  • Edit the constitution — fill in your stack, coding standards, testing requirements, and security policies
  • Define architecture — describe your system and get an LLM-powered review
  • Generate a dev plan — the LLM creates milestones and tasks from your constitution and architecture
  • Work on tasks — each task goes through Clarify → Plan → Implement → Tests

Core Concepts

Understand phases, artifacts, roles, and Definition of Done.

New Project Guide

Step-by-step walkthrough from init to your first completed task.