Desktop

Instalezi codai desktop, te autentifici, alegi un skin și un nivel de autonomie, folosești controlul computerului, servești ca host pentru telefon și aplicația web, actualizezi și dezinstalezi.

codai desktop îl lasă pe asistent să lucreze pe computerul tău: rulează comenzi, citește și editează fișiere în folderele pe care le aprobi, conduce un browser într-un profil separat și — pe Windows — dă click prin alte aplicații. Vine cu un mic workbench de cod (editoare Monaco, terminale, explorator de fișiere, vizualizare Git), ca să revizuiești fiecare schimbare înainte să fie aplicată. Apache-2.0, sursa la github.com/codai-ro/codai-desktop.

Instalare

Versiunile sunt publicate la github.com/codai-ro/codai-desktop/releases, etichetate desktop-v<versiune>. Versiunea curentă la momentul scrierii: 0.6.1.

Trei artefacte, toate x64:

Fișier	Ce este
`codai_<versiune>_x64-setup.exe`	Installer NSIS. Se instalează doar pentru utilizatorul curent — fără prompt de administrator. Este cel folosit de actualizatorul automat.
`codai_<versiune>_x64_en-US.msi`	Pachet MSI pentru instalări administrate / winget.
`codai_<versiune>_x64-portable.zip`	Build portabil — dezarhivezi și rulezi `codai-desktop.exe`. Fără installer, fără actualizator.

Rulezi .exe-ul, apoi pornești codai din meniul Start. Windows 10/11 cu WebView2 (prezent deja pe ambele).

Installerul nu este încă semnat Authenticode, așa că SmartScreen poate afișa „Windows protected your PC” la prima rulare. Apasă More info → Run anyway, sau verifică întâi descărcarea — vezi Verifică descărcările. Actualizatorul verifică deja o semnătură minisign la fiecare actualizare.

Prima rulare

Accepți termenii

Primul ecran este Before you start: Termenii și Politica de confidențialitate, plus comutatoare opționale (date de antrenare, referral-uri) care sunt consimțăminte separate și nu sunt necesare pentru a folosi aplicația. Când se schimbă o versiune, ești întrebat din nou.

Te autentifici

Două căi:

Continue in browser — deschide auth.codai.ro în browserul de sistem (Google sau e-mail). Când termini acolo, revii în aplicație: a primit o cheie codai_ pentru acest dispozitiv, păstrată în secret store-ul aplicației, doar pe această mașină.
I have an API key — lipești o cheie codai_… din hub.codai.ro → Keys. Aplicația o verifică pe gateway înainte să o salveze.

A treia opțiune, Use a local model instead, sare peste cont complet: Ollama sau LM Studio pe acest computer, gratuit și privat, dar fără sincronizarea sesiunilor, partajare sau portofel.

Lasă Gateway URL la valoarea implicită (https://ai.codai.ro) dacă nu te auto-găzduiești.

Alegi un skin

How should codai look? — alegi Assistant (o coloană calmă de conversație, ca aplicația de telefon) sau Developer (editor, terminale, panouri — workbench-ul complet). Poți schimba oricând cu Ctrl+K M sau din Settings → Skins.

Skin-uri

Skin-ul este învelișul pe care îl randează fereastra principală. Schimbarea nu oprește nimic — terminalele, agenții, editoarele și tab-urile de browser continuă să ruleze dedesubt.

Skin	Ce vezi	Când
Assistant	O coloană de conversație, un composer, pașii agentului.	Sarcini de zi cu zi, foldere fără cod. Implicit.
Developer	Editor dockabil, revizuire de diff-uri, terminale, explorator de fișiere, Git, panou de supervizare.	Când lucrezi la un proiect.
Focus	Developer cu tot chrome-ul ascuns; `Esc` îl readuce.	Concentrare maximă.

Deschizi un folder fără cod și codai propune Assistant; deschizi un proiect de cod și propune Developer. Settings → Skins → Use for this workspace only fixează un skin pe un folder.

Niveluri de autonomie

Autonomia controlează ce poate face agentul pe computerul tău fără să întrebe. Se aplică controlului computerului (aplicații Windows) și apare în bara de stare — click pentru a comuta.

Nivel	Comportament
Strict	Întreabă înainte de fiecare acțiune în aplicații sensibile și înainte de orice combinație de taste care poate închide sau distruge lucru.
Assisted	Acționează liber în aplicații obișnuite; întreabă în cele sensibile (parole, banking, setări) și nu tastează niciodată secrete. Recomandat.
Autopilot	Fără porți de aprobare, cu excepția filtrului de credențiale. Folosește-l doar când privești.

Independent de autonomie, comenzile shell, scrierile de fișiere și acțiunile din browser cer aprobare prima dată per sesiune: Allow once, Always allow (this session) sau Deny. Citirea fișierelor și un snapshot de browser nu întreabă niciodată.

Controlul computerului și overlay-ul

Settings → Computer control îi permite agentului să vadă și să opereze aplicații Windows prin UI Automation: citește controalele unei ferestre, dă click, tastează, derulează, deschide programe. Acțiunile sunt filtrate de nivelul de autonomie de mai sus și oglindite pe overlay — un cursor fantomă, un inel de evidențiere pe țintă și o legendă care spune ce urmează să facă agentul. Dezactivezi overlay-ul cu Show the overlay while the agent acts dacă te distrage.

Buton de oprire: Ctrl+Alt+Space, sau Esc de două ori, oprește agentul instantaneu. Propriile tale mișcări de mouse sau taste îl pun pe pauză. Doar Windows.

Host-uri — servești telefonul și browserul

Settings → Executor → Serve as a remote host for my phone transformă acest desktop într-un host: o mașină pe care ceilalți clienți ai tăi pot rula operații de terminal și fișiere, în interiorul folderelor permise. Bara de stare arată Relay: online cât timp conexiunea la gateway este activă.

Cine îl folosește:

Aplicația Android — sarcini de tip „rulează asta pe PC-ul meu” și backend-ul de terminal hosts.
Aplicația web de la app.codai.ro — selectorul Run on listează desktopurile tale online; browserul conversează, această mașină execută. Vezi Web.

Doar dispozitivele autentificate cu același cont pot vedea sau folosi un host; un host dispare din listă 45 de secunde după ultimul heartbeat. Detaliile protocolului sunt pe pagina releu de host-uri.

Separat, Run tasks dispatched to this device (aceeași secțiune de setări) permite telefonului sau hub-ului să trimită o sarcină întreagă către acest desktop; acesta verifică la fiecare 30 de secunde și o rulează aici.

Ce poate atinge

Settings → Executor:

Approved folders — singurele locuri unde uneltele de fișiere pot citi sau scrie. Implicit: folderul tău home. Căile sunt canonicalizate, așa că .. și symlink-urile care ies în afară sunt refuzate.
Browser executable — detectează automat Edge sau Chrome; lansat mereu cu propriul folder de profil, așa că tab-urile, cookie-urile și parolele tale nu sunt implicate niciodată.
Budgets — timeout-uri pentru o comandă (implicit 30 s), un apel de unealtă și o tură întreagă (implicit 10 minute). Output-ul este limitat la 64 KB per stream.
Semantic search — model local opt-in (multilingual-e5-small, descărcare unică de ~205 MB) care indexează workspace-ul pe acest PC. Nimic nu îl părăsește.

Actualizări

Aplicația verifică https://codai.ro/api/desktop/latest.json. Dacă apare o versiune mai nouă, descarcă installerul, îi verifică semnătura minisign față de cheia publică compilată în aplicație și îl instalează. O actualizare a cărei semnătură nu se potrivește este refuzată; actualizatorul nu face niciodată downgrade. Verifici manual din About → Check for updates.

Actualizările sunt azi doar pe Windows (windows-x86_64 în latest.json; linux-x86_64 se adaugă când a fost construit un AppImage pentru acea versiune). .zip-ul portabil nu are actualizator.

Dezinstalare și locațiile datelor

Dezinstalezi din Settings → Apps (Windows) sau cu managerul de pachete (Linux). Dezinstalarea nu șterge datele tale:

Ce	Unde (Windows)
Setări, secrete (cheia ta), id-ul dispozitivului, registrul brokerului	`%APPDATA%\ro.codai.desktop\` (`settings.json`, `secrets.json`, `device.json`, `broker.json`)
Trace-uri, memorie (SQLite + FTS), checkpoint-uri de fișiere, stare per workspace, modele locale	`%LOCALAPPDATA%\codai\`
Profilul de browser folosit de unealta browser	în `%LOCALAPPDATA%\codai\`

Pe Linux aceleași foldere sunt sub ~/.config/ro.codai.desktop și ~/.local/share/codai.

Înainte de dezinstalare, Settings → Sign out revocă pe server cheia acestui dispozitiv. Dacă ai uitat, revoc-o din hub.codai.ro → Security → Devices.

Taste

Scurtătură	Acțiune
`Ctrl+Enter`	Trimite, sau răspunde la întrebarea în așteptare
`Esc`	Anulează tura în curs
`Ctrl+Alt+C`	Deschide sau ascunde chat-ul flotant (din orice aplicație)
`Ctrl+Alt+Space`	Buton de oprire — oprește controlul computerului (`Esc` ×2 la fel)
`Ctrl+Shift+P`	Paleta de comenzi
`Ctrl+K M`	Comută skin-urile
`Ctrl+Shift+G`	Vizualizarea Git
`Ctrl+,`	Setări

Fiecare combinație poate fi schimbată în Settings → Keybindings.