Pi coding agent: ce este, instalare si noutatile din 1.5

Pe scurt, la 4 noiembrie 2026: Pi coding agent este un agent de programare open source pentru terminal, cu licenta MIT, care da modelului doar patru unelte (read, write, edit si bash) si lasa restul in seama extensiilor scrise de tine in TypeScript. Ultima versiune este 1.5.0, lansata pe 2 noiembrie 2026, iar de la versiunea 0.99 suportul MCP vine ca extensie integrata. Programul e gratuit; platesti doar modelul pe care il conectezi.

Pi a ajuns la versiunea 1.0 pe 1 octombrie 2026, iar repository-ul are peste 118.000 de stele pe GitHub. Eu lucrez zilnic cu Claude Code, dar pe Pi il folosesc altfel: ca motor agentic intr-o aplicatie desktop pe care o dezvolt, controlat prin SDK dintr-un proces Node.js. Din experienta asta iti spun ce este, cum il instalezi, ce ii lipseste fata de Claude Code si OpenCode si cand merita ales.

Ce este Pi coding agent

Pi este un harness: stratul de software dintre tine si modelul de limbaj, care decide ce unelte poate folosi modelul, cum se gestioneaza contextul si cum se salveaza sesiunile. L-a creat Mario Zechner, iar astazi proiectul este sub organizatia Earendil.

Din monorepo conteaza trei pachete:

• pi-coding-agent: CLI-ul interactiv, adica agentul pe care il folosesti in terminal.
• pi-agent-core: runtime-ul agentului, cu apelurile de unelte si starea sesiunii.
• pi-ai: un API unificat pentru mai multi furnizori (Anthropic, OpenAI, Google si altii) cu acelasi cod.

Filozofia e declarata: nucleul ramane minim, iar ce au alti agenti deja inauntru se adauga prin extensii, skill-uri sau pachete. Agentul se adapteaza la felul tau de lucru, nu invers.

Cum instalezi Pi coding agent

Cu npm ai nevoie de Node.js 22.19 sau mai nou:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Flag-ul --ignore-scripts nu e un detaliu: dezactiveaza scripturile de instalare ale dependentelor, una dintre caile prin care intra atacurile pe lantul de aprovizionare npm. Ca alternativa exista scripturile oficiale: curl -fsSL https://pi.dev/install.sh | sh pe macOS si Linux, powershell -c "irm https://pi.dev/install.ps1 | iex" pe Windows.

Apoi intri in folderul proiectului si rulezi pi. De la 1.0 interfata porneste pe tot ecranul; daca vrei scrollback-ul normal al terminalului, folosesti --tui-mode regular. Daca folderul are extensii sau setari de proiect, Pi te intreaba intai daca ai incredere in proiect (alegerea se gestioneaza cu /trust).

Ca sa conectezi un model ai doua variante:

• Cheie API: exporti variabila de mediu a furnizorului, de exemplu ANTHROPIC_API_KEY.
• Login: comanda /login gestioneaza credentialele furnizorilor suportati. De la 0.99 poti folosi si abonamentul ChatGPT cu /login openai.

Lista de furnizori e lunga: Anthropic, OpenAI, Google Gemini si Vertex, Amazon Bedrock, Mistral, Groq, DeepSeek, OpenRouter, xAI, Hugging Face, OpenCode Zen si Go si altii. Pentru modele locale exista suport pentru routerul llama.cpp, cu comanda /llama.

Ce inseamna asta daca lucrezi din Romania

Pi in sine nu are abonament si nu are restrictii de tara: il descarci si il rulezi. Costul real vine din cheile API, pe care le platesti cu cardul, de obicei in dolari. Daca platesti dintr-un cont in lei, banca face conversia; multi programatori folosesc un card Revolut ca sa controleze cursul. Ca reper, Claude Sonnet 5.5 costa 2 dolari pe milion de tokeni la intrare si 10 la iesire, adica aproximativ 9,56 si 47,80 lei la cursul din 3 noiembrie 2026 (circa 4,78 lei pentru un dolar), fara TVA.

Daca lucrezi pe SRL sau PFA, verifica inainte ca furnizorul sa emita factura pe datele firmei si cu codul tau de TVA, ca sa o poti inregistra in contabilitate. Iar daca vrei costul zero pe tokeni, Pi merge si cu modele locale prin llama.cpp, cu limitele hardware pe care le-am pus in ghidul despre Claude Code gratis si modele locale.

Un sfat practic: daca vrei sa folosesti un abonament de consum in loc de o cheie API, citeste intai termenii furnizorului, pentru ca nu toti permit folosirea planului in afara clientului lor oficial.

Ce s-a schimbat de la Pi 0.99 la Pi 1.5

In putin peste o luna Pi a trecut de la 0.87 la 1.5. Noutatile care conteaza pentru cine il foloseste zilnic:

• 0.99 (29 septembrie): MCP, codemode si tool_search ca extensii integrate. Codemode il pune pe model sa scrie mici scripturi JavaScript, rulate intr-un sandbox QuickJS, care cheama mai multe unelte in paralel. Tot acum vin login-ul cu abonamentul ChatGPT si clasificatoarele precum Jev de la TypeSafe AI, apelabile din scripturi.
• 1.0 (1 octombrie): interfata pe tot ecranul implicit, codemode cu circa 40% mai putini tokeni de prompt, generare de imagini din scripturi si login Anthropic cu cod de copiat pentru masinile fara browser.
• 1.1 (7 octombrie): Claude Haiku 5.5 si optiunea --tools cu +nume si -nume, care adauga sau scoate o unealta fara sa rescrii lista, de exemplu pi --tools +codemode,-write.
• 1.2 si 1.3 (12 si 15 octombrie): lista de modele OpenRouter filtrata dupa cheie, scheme JSON publicate pentru configurari, furnizorul Kimi Code si corecturi pentru Gemini 4 Argon si GPT-6.1 Sol.
• 1.4 (21 octombrie): clasificatoarele accepta si imagini, iar scripturile codemode in paralel asteapta un worker liber in loc sa esueze.
• 1.5 (2 noiembrie): apare GPT-6.1 Terra, modelul OpenAI implicit devine GPT-6.1 Sol, streaming-ul e mai rapid, iar pachetele de extensii iti pot arata changelog-ul dupa o actualizare.

Filozofia nu s-a schimbat: sub-agentii si plan mode raman in afara nucleului, iar uneltele active implicit sunt tot read, bash, edit si write. Daca il folosesti prin SDK, cum fac eu, citeste changelog-ul inainte de update: in 1.2 evenimentul before_agent_start porneste si pentru rularile lansate de extensii, in 1.5 validarea argumentelor uneltelor a trecut pe un nou motor de scheme, iar sesiunile SDK nu incarca singure extensiile integrate precum MCP.

Cum il folosesti: cele patru moduri

• Interactiv: TUI in terminal. Cu @ cauti fisiere din proiect, cu !comanda rulezi o comanda si trimiti rezultatul modelului, cu /model schimbi modelul in mijlocul sesiunii.
• Print sau JSON: pi -p "cerere" raspunde si iese, --mode json emite toate evenimentele ca linii JSON. Bun pentru scripturi si pipeline-uri CI.
• RPC: pi --mode rpc vorbeste JSONL pe stdin si stdout, deci il integrezi din Python, Go sau Swift.
• SDK: importi createAgentSession din @earendil-works/pi-coding-agent si creezi sesiuni in aplicatia ta Node.js.

Sesiuni in arbore si AGENTS.md

Sesiunile se salveaza ca fisiere JSONL cu structura de arbore. Cu /tree te intorci in orice punct al conversatiei, cu /fork creezi o sesiune noua dintr-un mesaj anterior, cu /export o exporti in HTML. Cand un agent o ia pe drumul gresit dupa douazeci de pasi, sa poti reveni fara sa pierzi munca e diferenta dintre a o lua de la zero si a corecta directia.

La pornire Pi incarca AGENTS.md (sau CLAUDE.md) din folderul global, din folderele parinte si din cel curent. Daca ai deja un proiect configurat pentru Claude Code, instructiunile sunt citite fara sa schimbi nimic. Promptul de sistem se inlocuieste cu .pi/SYSTEM.md sau se extinde cu APPEND_SYSTEM.md.

Extensii, skill-uri si pachete

Aici e inima lui Pi. Extensiile sunt module TypeScript care pot inregistra unelte, comenzi, scurtaturi, handler-e de evenimente si componente de interfata. Cu o extensie poti adauga sub-agenti, plan mode, confirmari inainte de comenzile periculoase, protectia unor foldere sau checkpoint-uri git.

• Skill-uri: urmeaza standardul Agent Skills, deci un SKILL.md scris pentru Claude merge si aici. Le chemi cu /skill:nume sau le incarca agentul cand are nevoie. Daca n-ai scris niciunul, porneste de la ghidul meu pentru un skill de la zero.
• Prompt template: fisiere Markdown refolosibile, apelate cu /nume.
• Pi Packages: colectii de extensii, skill-uri si template-uri instalabile cu pi install din npm sau git.

Un detaliu care mi-a placut imediat: ii poti cere chiar lui Pi sa iti scrie extensia care lipseste, apoi dai /reload si o folosesti fara restart.

Ce ii lipseste fata de Claude Code (si de ce e intentionat)

• MCP integrat, dar in afara nucleului: de la 0.99 suportul MCP (servere stdio si HTTP, cu OAuth) e o extensie integrata. Adaugi servere cu pi mcp add, le gestionezi cu /mcp si o poti dezactiva din pi config. Daca MCP e nou pentru tine, citeste ce este MCP si cum functioneaza.
• Fara sub-agenti: se fac cu mai multe instante in tmux sau cu un pachet.
• Fara plan mode si fara lista de sarcini: scrii planul intr-un fisier sau instalezi un pachet.
• Fara sistem de permisiuni: Pi ruleaza cu drepturile utilizatorului care l-a pornit.

Securitatea si GDPR

Ultimul punct merita citit de doua ori. Fara confirmari, un agent cu acces la bash poate sterge, muta sau trimite orice poate atinge utilizatorul. Documentatia oficiala propune patru variante: un container Docker pentru tot procesul, Docker Sandboxes, OpenShell cu politici pe fisiere, retea si credentiale, sau extensia Gondolin, care ruleaza uneltele intr-o micro VM. Pe cele mai practice le-am explicat in Docker Sandbox pentru agenti AI si NVIDIA OpenShell.

Pentru o firma din Romania mai e un aspect: tot ce citeste agentul ajunge la furnizorul modelului. Daca in repository sunt date personale ale clientilor, esti in zona GDPR si raspunzi tu, ca operator, inclusiv in fata ANSPDCP. Pe o masina cu chei, clienti si date reale, eu nu l-as porni fara izolare.

Pi vs Claude Code vs OpenCode

Agent	Puncte forte	Limite
Claude Code	Merge din prima: sandbox, permisiuni, hook-uri, plugin-uri, sub-agenti	Doar modele Claude; costul depinde de plan
OpenCode	Open source, zeci de furnizori, MCP si sub-agenti gata facuti	Mai putin control fin decat Pi
Pi	Cel mai mic si mai controlabil, SDK si RPC, orice model	Trebuie sa scrii TypeScript si sa te ocupi de izolare

Pentru cat costa planurile Claude in lei vezi cat costa Claude Code, iar comparatia completa este in Claude Code vs OpenCode vs Codex.

Cum il folosesc eu: Pi ca motor intr-o aplicatie

Am ales Pi pentru proiectul la care lucrez nu pentru CLI, ci pentru SDK. Aveam nevoie de o bucla agentica de incredere, de pus intr-o aplicatie desktop, cu uneltele si regulile mele.

• Pi ruleaza intr-un proces Node.js separat, in spatele unui adapter: aplicatia nu depinde direct de API-ul lui, asa ca un update nu strica totul.
• Uneltele integrate ale lui Pi sunt dezactivate: agentul vede doar uneltele pe care le inregistrez eu, fiecare cu un control asupra a ce poate face.
• Actiunile care modifica ceva (publicare, stergere, deploy) trec mereu printr-un diff si o aprobare umana.

Cu Claude Code n-as avea acest control: e un produs finit. Pi e o componenta. Regula mea este "Pi gestioneaza agentul, aplicatia gestioneaza proiectul".

Cand alegi Pi coding agent

• Da, daca vrei sa pui un agent in aplicatia ta prin SDK sau RPC, cu orice model, inclusiv local.
• Da, daca iti place sa iti construiesti uneltele si scrii TypeScript.
• Nu, daca vrei un agent care merge din prima, cu permisiuni si sandbox gata facute.
• Nu, daca nu il poti izola intr-un container pe o masina cu date sensibile.

Citeste si

• Claude Code vs OpenCode vs Codex: ce alegi in 2026?
• Claude Skills: cum creezi un skill de la zero
• Ce este MCP (Model Context Protocol) si cum functioneaza
• Docker Sandbox: cum izolezi Claude Code si Codex

Pe scurt

Pi coding agent nu e cel mai comod agent din 2026, si tocmai asta e ideea. Patru unelte, un nucleu mic, sesiuni in arbore, SDK si RPC: e caramida potrivita pentru cine vrea un agent pe masura, nu pentru cine cauta unul gata facut. Singura conditie pe care n-as negocia-o este izolarea.

Daca vrei sa integrezi un agent AI in software-ul sau in procesele firmei tale si nu stii de la ce harness sa pornesti, scrie-mi: iti spun ce drum are sens pentru cazul tau.