Documentation / Getting started
Getting started, end to end
The whole path, in order: request the installer, check its fingerprint, open Yuli, open a project, connect your agent and ask for your first task. No account needed.
On this page
This page is the map of the journey. Each step links to the page that explains it in detail. Tick off what you finish: your progress is remembered only in this browser.
1. Get Yuli
Yuli is free for everyone, forever, and you don't need an account to use it.
| Step | What happens |
|---|---|
| Request the link | Write to the project maintainer on GitHub. You receive the installer link. |
| Check the fingerprint | Compare the file's SHA-256 fingerprint with the one on Get Yuli. |
| Later on | Yuli will arrive signed on Microsoft Store for Windows and as a compiled binary for Linux. |
The website account is optional: it's for supporting Yuli, requesting an enterprise edition or copying your key if your version asks for it. Details in Your account and supporting Yuli.
2. Check and open Yuli
Today the BETA is published for 64-bit Windows 10/11, as a portable executable: it needs no installation and no administrator rights. The Get Yuli page shows the current version and its fingerprint.
Before opening the file, compare its SHA-256 fingerprint with the one on the Get Yuli page. In PowerShell:
Get-FileHash .\Yuli-Code-Portable-<version>-win-x64.exe -Algorithm SHA256Then open Yuli. If your BETA build asks for a key, copy it for free from Your account and paste it into Activate license, from the first-run wizard or from Help → About. The key is checked on your computer, offline.
Details in Install Yuli and First run, license and updates.
3. Open a project
Open a folder, decide whether you trust the project and let Yuli index it. You can keep working in the meantime.
| Decision | When |
|---|---|
| Trust | Your own projects or your team's. |
| Restricted mode | Code you don't know: Yuli runs nothing from the repository. |
Details in Your first project.
4. Choose your agent
Yuli doesn't ship an AI of its own: you work with the agent you choose. Pick what you already have and you'll see where to start.
Help me choose: which agent do I connect?
Pick an option to see which agent to start with.
Details in Connect an AI.
5. Ask for your first task
A good first test changes nothing in your project:
“Explain this project's architecture to me and where the main business logic lives.”
When you ask for a change, remember three rules:
- The agent proposes, the IDE controls, and you approve. Every change goes through the AI changes window before it reaches the disk.
- You can undo an entire task with
Ctrl+Alt+Shift+Z. - Git, CI and DevOps are used only if you ask, and each action waits for your approval.
Details in Ask for a task and Review changes.
Questions along the way
Do I need an account?
Not to use Yuli. The account is optional: it's for supporting Yuli, requesting an enterprise edition or copying your key if an older BETA build asks for it.
My account's verification code doesn't arrive
Check your spam folder. Each code is valid for 15 minutes and allows 5 attempts. Resend code is available every 60 seconds, up to 5 times per hour; the previous code stops working.
I can't see my license key
You only need it if your BETA build asks for it. It appears in Your account as soon as you confirm your email. If you already confirmed it and it still isn't there, reload the page in a few seconds.
Windows shows “Windows protected your PC”
That is the SmartScreen notice. Check the file's SHA-256 fingerprint and click More info → Run anyway.
I use macOS or Linux
A compiled binary is coming for Linux; macOS, later on. Meanwhile, from Windows Yuli works on Linux over SSH, WSL or containers. See Containers and remote development.
More help
- Problems opening Yuli or with the agent: Troubleshooting.
- Questions about the account, how to support Yuli, the AI or privacy: Frequently asked questions.
- A term you don't know: Glossary.
- A bug in Yuli: Help → Report a problem…