Explain this project
las explain ~/code/shop
las explain ~/code/shop --no-llm # facts only
las explain ~/code/shop --model qwen3:8blas explain answers a fixed set of questions, always from facts:
- What does this project do?
- How does it start?
- Where is the interface?
- Where is the backend?
- Where is the data?
- Which external APIs does it use?
- Which files matter most?
- How do the components talk to each other?
- What changed recently?
- Does the documentation match the code?
- What could not be determined?
For each question it selects the relevant claims deterministically. If there are no facts, the answer is ? and the model is not even asked — an empty project produces mostly ?, not invented text. "What does it do?" also shows the first paragraph of the README, marked as its source.
With a local model
If Ollama is running on localhost:11434 with the configured model (default qwen2.5-coder:7b), each answer also gets one to three sentences written by the model, marked ≈:
Where is the data?
≈ The data is stored in an SQLite database. [db.sqlite]
✓ Database: SQLite ← package.json:13The rules that keep it honest:
- The model receives claims only — id, label, value, status, note. Never your code.
- Every sentence must end with the ids of the claims it is based on.
- A validator removes every sentence without a citation, or citing an id that doesn't exist (or that belongs to another question). The count of removed sentences is shown.
- Everything the model writes is marked ≈ redigido pela IA a partir de factos.
las explain also writes .localalibi/overview.md: a short AI summary (same rules) followed by every question with its facts and citations.
Without Ollama, everything works and the header says the AI drafting is off.