Your first project

Before you begin

Install Virillio Code and choose a small project you can safely experiment with. Have your provider account or API key ready. A provider may charge for requests even during the Virillio beta.

1. Open your project

Click Open project in the sidebar and select the project’s root folder. Confirm the project name or directory shown under the prompt composer. Choose New session beside the project to start a separate conversation.

For a first run, use a demonstration project without secrets or customer information. If it uses Git, begin from a known commit so you can compare the result.

2. Connect a model

Open Settings → Providers, select a supported provider, and complete the connection method offered. Return to the session and use the model selector beneath the prompt to choose an available model. See provider setup for more detail.

3. Start with understanding

Send a bounded request before asking for edits:

Explain how this project is organized and how to run its tests.
Read the relevant files, but do not change anything yet.

The agent should inspect relevant context and explain its findings. If it reports a missing dependency or access issue, resolve that before giving it a larger task.

4. Make one small change

Try a concrete request with a clear finish line:

Improve the empty-state message on the task list.
Keep the existing layout and dependencies.
Show me what changed and run the relevant checks.

Read any approval request before allowing it. If the work needs discussion, use Plan mode first.

5. Review the result

Inspect changed files, look at the diff, and read the actual check output. Ask for a correction if the result misses the goal. Save or commit only after you are satisfied; an agent’s completion message is not a substitute for review.