ai-usage
Un petit programa per a la terminal que fa de marcador de benzina dels serveis d'IA: quant has gastat, quant queda i quan es torna a omplir, sempre a la vista. El meu primer projecte en Go.
Què fa
ai-usage és un petit programa que viu a la terminal i fa una cosa senzilla: ensenya sempre, a primera vista, quant et queda de cada servei d'IA que fan servir els teus agents. Funciona com el marcador de benzina d'un cotxe, però per als serveis d'IA: quant has gastat, quant queda i quan es tornarà a omplir. Verd si vas bé, vermell si t'hi estàs acostant. Els serveis que vigila són Codex, MiniMax i z.ai, i el programa mira els tres alhora perquè no hagis d'entrar a cap web per saber com vas.
Per què el vaig fer
Els serveis d'IA limiten el consum per hores, i quan el dipòsit s'acaba a mitja feina, l'agent s'atura. Passa molt sovint treballant amb agents cada dia, i descobrir-ho tard costa hores. Amb aquest widget el marcador sempre és a la vista i ningú es queda sense gasolina per sorpresa.
El meu primer projecte en Go
El programa està escrit en Go, un llenguatge de la família de C, i aquest ha estat el meu primer projecte complet amb ell. També vaig fer un pas més: Term, la terminal que faig servir — una beta amb sistema de plugins, com les extensions del navegador — ara té un plugin meu que posa el marcador a la barra inferior de cada finestra. Sempre visible sense ocupar espai de treball.
Què demostra aquest projecte
- Integració amb serveis externs: cada proveïdor dona les dades a la seva manera; el programa les consulta totes alhora i les tradueix a un format únic que es pot llegir a simple vista o fer servir des d'altres programari.
- Disseny que s'adapta: si la finestra és estreta, la informació es posa en columnes; si és ampla, tot en una línia.
- Qualitat comprovada sola: el projecte té proves automàtiques i una cuina de proves (anomenada CI) que compila i verifica el codi en cada canvi, per a Mac i Linux, sense que ningú hi hagi de confiar la memòria.
- Seguretat des del principi: les claus d'accés mai no entren al codi, i abans de pensar en obrir el projecte al públic hi vaig passar una revisió de secrets sobre tota la història de canvis.
- Documentat per continuar-lo: el vocabulari del projecte, les decisions i el pla de treball estan per escrit, perquè una altra persona — o un altre agent — el pugui agafar i seguir.
Estat
Acabat i en ús cada dia des del primer dia. El codi és privat de moment; el pla és obrir-lo aviat amb una neteja prèvia de l'historial i una primera versió instal·lable per a macOS i Linux.