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:
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:
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):
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:
Verify your config:

​
3. Launch the Dashboard

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.