VS Code

Extensia codai (dragoscv.codai-vscode) partajează cu contul tău codai sesiunile GitHub Copilot Chat în care lucrezi. Ele apar pe ceasul Wear OS, în aplicația Android și în aplicația desktop ca orice altă sesiune partajată. Când agentul Copilot te așteaptă — „Permiți run_in_terminal?” sau o întrebare cu variante — cererea ajunge pe toate dispozitivele, iar răspunsul tău se aplică în VS Code.

Funcționează pe VS Code 1.95+ (stable și Insiders), pe Windows, macOS și Linux. Cursor, Windsurf, VSCodium și Trae rulează o parte din ea — vezi Compatibilitate. Extensia urmează limba de afișare a VS Code (engleză sau română).

InstalareCopiază linkul secțiunii

• Marketplace: caută codai (id extensie dragoscv.codai-vscode) în panoul Extensions sau rulează code --install-extension dragoscv.codai-vscode (code-insiders pentru Insiders).
• VSIX: descarcă cel mai nou pachet de la linkul de descărcare din Marketplace și folosește Extensions → … → Install from VSIX.
• Open VSX: nepublicat încă. Fluxul de lansare e pregătit și publică același pachet, cu același id, imediat ce spațiul de nume Open VSX e configurat. Până atunci, folosește VSIX-ul în editoarele care citesc din Open VSX.

Alte editoare (Cursor, Windsurf, VSCodium, Trae)Copiază linkul secțiunii

Aceste editoare instalează extensii din Open VSX, așa că deocamdată codai nu apare în căutarea lor. Instalează-l manual:

1. Descarcă fișierul .vsix de la linkul din Marketplace de mai sus. Salvează-l cu extensia .vsix.
2. În editor, deschide Command Palette și rulează Extensions: Install from VSIX…, apoi alege fișierul. Din terminal: cursor --install-extension codai-vscode.vsix, windsurf --install-extension codai-vscode.vsix sau codium --install-extension codai-vscode.vsix.
3. Rulează codai: Sign in.

Ce e diferit în afara VS Code:

• Editorul trebuie să fie bazat pe VS Code 1.95 sau mai nou; versiunile mai vechi refuză pachetul.
• Extensia oglindește sesiunile GitHub Copilot Chat. Editoarele fără Copilot Chat nu au ce oglindi de acolo. În Cursor, extensia îți poate arăta pe dispozitive chiar conversațiile din Cursor, doar pentru citire: le poți urmări, dar nu le poți răspunde de pe alt dispozitiv.
• Continue with GitHub are nevoie de autentificarea GitHub integrată a editorului. Dacă nu merge, folosește Sign in in the browser sau o cheie API.
• Actualizările nu vin singure: instalează noul .vsix în același fel.

ConectareCopiază linkul secțiunii

Rulează codai: Sign in din Command Palette și alege Continue with GitHub, Sign in in the browser sau Use an API key…. Cu varianta din browser se deschide auth.codai.ro/device cu codul deja completat (e copiat și în clipboard); aprobă-l. VS Code nu vede niciodată parola — primește propria cheie codai_, păstrată în secret storage-ul VS Code și listată ca dispozitiv în hub.codai.ro → Securitate → Dispozitive.

Continue with GitHub (și codai: Sign in with GitHub) folosește contul GitHub cu care VS Code e deja conectat: fără browser, și ajungi în același cont codai ca atunci când te conectezi cu GitHub pe web. Un cont complet nou trece totuși o dată prin browser, ca să accepte Termenii.

Use an API key… acceptă o cheie creată de tine. Probleme la conectare: vezi depanarea.

Modele codai în Copilot ChatCopiază linkul secțiunii

codai: Add codai models to Copilot Chat (în interfața în română: codai: Adaugă modelele codai în Copilot Chat) pune codai în selectorul de modele din Copilot Chat. Comanda descarcă intrarea furnizorului codai de la https://ai.codai.ro/vscode/chatLanguageModels.json și o adaugă în fișierul tău de utilizator chatLanguageModels.json (sau o actualizează dacă există deja), fără să atingă ceilalți furnizori. Înainte de prima modificare, fișierul existent e copiat în chatLanguageModels.json.bak-codai.

Cheia ta nu e scrisă niciodată în acel fișier: prima dată când alegi un model codai, VS Code îți cere o singură dată cheia codai și o păstrează în keychain-ul sistemului de operare. După conectarea în VS Code sau Insiders, extensia îți oferă comanda o singură dată; o poți rula oricând din Command Palette.

Ce văd dispozitivele taleCopiază linkul secțiunii

Bara de stare arată codai N (sesiuni partajate) și un clopoțel cu numărul cererilor care te așteaptă. Click pe ea pentru listă, Sync now, jurnal și Sign out.

Răspunsul de pe alt dispozitivCopiază linkul secțiunii

• Allow / Deny pe o cerere de tool confirmă sau sare peste tool în chat-ul respectiv. VS Code aplică o confirmare doar unui chat deschis într-o fereastră, așa că, cu codai.remote.revealSessions (activ implicit), extensia deschide întâi chat-ul.
• Răspunde la o întrebare cu una dintre variante, cu numărul ei sau cu text liber (dictat pe ceas). Fiecare întrebare dintr-un set e partajată și primește propriul răspuns; (skip) lasă o întrebare pe care Copilot o tratează ca sărită.
• Trimite un prompt nou în sesiune și el e trimis în acel chat.
• Stop anulează cererea în curs.

Răspunsurile ajung în VS Code în câteva secunde (codai.sessions.pollSeconds).

Prompturi în așteptareCopiază linkul secțiunii

Vederea Pending prompts din bara de activități listează prompturile salvate pentru mai târziu de pe oricare dintre dispozitivele tale și se actualizează imediat când unul se schimbă în altă parte.

• Open in chat, Copy, Snooze, Mark done, Dismiss, Delete, plus Save selection as pending prompt pentru unele noi.
• Detectare automată. Lipește un prompt în așteptare în Copilot Chat, în orice fereastră VS Code, și e marcat sent, apoi answered când răspunsul se termină. Nu trebuie să apeși nimic.
• Verify prompt / Verify all prompts îl întreabă pe codai dacă chatul chiar a făcut treaba, pe baza chatului și a diff-ului din repository de când a fost trimis promptul. Primești un raport scurt (ce s-a schimbat, ce lipsește încă); o treabă completă e marcată verified.

@codai în chatCopiază linkul secțiunii

Scrie @codai în Copilot Chat ca să vorbești direct cu modelul codai (în streaming, facturat pe contul tău codai).

• @codai /sessions — sesiunile tale partajate de pe toate dispozitivele și ce te așteaptă.
• @codai /asks — doar întrebările și aprobările deschise.

Căutare web și cercetare aprofundată în agent modeCopiază linkul secțiunii

Începând cu versiunea 0.7.0, extensia adaugă trei unelte în Copilot agent mode, disponibile pentru orice model (inclusiv endpoint-uri custom și modele BYOK care nu au căutare web proprie):

• codai_web_search (#codaiWebSearch) — căutare web verificată: fiecare rezultat a fost descărcat de codai, iar fragmentul a fost găsit în pagină, citat ca [S1]..[Sn]. Agentul poate restrânge site-urile (include_domains / exclude_domains), poate cere pagini recente (freshness day/week/month/year, published_after / published_before), poate merge în deep pentru întrebări grele sau poate primi un extras verificat mai lung per rezultat (content_chars). Limba și piața se deduc din interogare, dacă agentul nu setează lang / country.
• codai_web_fetch (#codaiWebFetch) — citește un URL public ca markdown curat (până la 40.000 de caractere, implicit 8.000); focus întoarce doar paragrafele relevante. Textul paginii este marcat drept conținut nesigur.
• codai_deep_research (#codaiDeepResearch) — planifică mai multe căutări, citește cele mai bune pagini și întoarce un raport în care fiecare afirmație își citează sursa. Dacă raportul nu e gata în fereastra de așteptare, unealta întoarce un id de job, iar agentul o apelează din nou cu job_id.

Sunt aceleași unelte, cu aceleași scheme și același rezultat, ca pe desktop, telefon, CLI-ul headless și MCP-ul găzduit (un singur contract). Folosesc cheia ta codai (autentifică-te întâi) și endpoint-urile API POST /v1/tools/search, POST /v1/tools/fetch și POST /v1/research. Un refuz al uneia dintre regulile tale, un argument greșit sau o limită de rată îi sunt arătate modelului ca o linie ERROR și nu sunt niciodată reîncercate pe tăcute. Căutările și fetch-urile sunt contorizate (prețuri): primele 1.000 de apeluri pe lună sunt gratuite, iar apelurile sunt gratuite când codai este modelul de chat. Le activezi sau dezactivezi din selectorul Tools al chat-ului, sau le referi într-un prompt cu #.

Sesiuni de pe alte dispozitive (experimental, Insiders)Copiază linkul secțiunii

Cu codai.experimental.chatSessionsProvider activ, VS Code Insiders listează în propria vedere Sessions sesiunile care rulează pe celelalte dispozitive codai. Deschiderea uneia îi arată istoricul; un prompt scris acolo e trimis dispozitivului care o rulează. Folosește un API propus al VS Code, deci pornește Insiders cu --enable-proposed-api dragoscv.codai-vscode (sau adaugă "enable-proposed-api": ["dragoscv.codai-vscode"] în argv.json prin Preferences: Configure Runtime Arguments). Fără asta, setarea nu face nimic.

CompatibilitateCopiază linkul secțiunii

Extensia are nevoie de VS Code 1.95 sau mai nou. Unele funcții folosesc API-uri pe care le are doar VS Code; în alte editoare (și în versiunile VS Code fără acele API-uri) extensia arată o singură dată un mesaj cu ce nu e disponibil, iar restul funcționează în continuare.

De ce:

• Oglindirea sesiunilor Copilot citește fișierele de chat pe care GitHub Copilot Chat le păstrează în VS Code, deci merge doar în VS Code Stable și Insiders.
• @codai în chat are nevoie de API-ul de chat participant (vscode.chat.createChatParticipant).
• Uneltele pentru agent (#codaiWebSearch, uneltele Studio, …) au nevoie de vscode.lm.registerTool.

Un editor derivat care oferă totuși API-ul de chat sau de unelte primește acele funcții; mesajul listează doar ce lipsește cu adevărat. codai: Add codai models to Copilot Chat e oferită doar în VS Code și Insiders.

SetăriCopiază linkul secțiunii

ConfidențialitateCopiază linkul secțiunii

Extensia doar citește fișierele de sesiune pe care VS Code le păstrează deja (workspaceStorage/<id>/chatSessions/, iar pentru chaturile Copilot CLI din versiunile Insiders mai noi globalStorage/agent-host.db plus ~/.copilot/session-state/<id>/events.jsonl, citite dintr-o copie privată); nu le modifică niciodată. Trimite către ai.codai.ro: titlul sesiunii, prompturile tale fără contextul atașat, numele uneltelor și descrierea lor pe un rând, textul răspunsului final și cererile. Nu trimite conținutul fișierelor, atașamente, rezultatele uneltelor sau editările. Fiecare sesiune VS Code corespunde unei sesiuni codai cu cheia vscode:<mașină>:<id sesiune>; o ștergi din hub sau din orice aplicație ca pe oricare altă sesiune. Vezi politica de confidențialitate.

Titlurile și textul asistentului care vin de pe celelalte dispozitive sunt escapate înainte ca VS Code să le afișeze, ca să nu poată injecta linkuri sau comenzi, iar imaginile externe din răspunsurile oglindite sunt eliminate. Rapoartele de eroare sunt opționale (codai.telemetry); vezi rapoartele de eroare.

Probleme frecventeCopiază linkul secțiunii