RosmarOps

RosmarOps per a equips de seguretat

RosmarOps és un programa de només lectura que revisa què poden fer els agents d'IA en un ordinador. Per fer-ho obre fitxers de credencials i llança PowerShell, que és just el que fa un lladre de credencials. Per això aquesta pàgina explica exactament què fa, perquè ho puguis comprovar abans d'autoritzar-lo.

1. Quins fitxers obre i per què

  • La configuració dels agents d'IA: Claude Code, Cursor, Cline, GitHub Copilot, Codex, Grok Build, Antigravity CLI, Gemini CLI i Hermes Agent. Els seus permisos, servidors MCP, hooks, skills i instruccions (AGENTS.md, CLAUDE.md, GEMINI.md i similars). La llista completa, fitxer a fitxer, és al README: https://github.com/qtorb/rosmarops#what-it-reads
  • Fitxers de credencials, per saber quines claus pot llegir cada agent:
    • els .env dels repositoris;
    • els de npm, AWS, GitHub CLI, git, Railway i Supabase;
    • els de sessió dels mateixos agents.
  • Els repositoris: els fitxers seguits per git i el seu historial, per trobar claus desades, a més dels seus hooks i workflows.
  • A Windows: les tasques programades, les exclusions de Microsoft Defender i algunes claus de directives del registre que configuren agents. Només les llegeix.

Mai no ensenya una clau sencera: l'informe mostra els 4 primers i els 4 últims caràcters. No obre fitxers de més de 2 MB. Se salta node_modules, .git i les altres carpetes de dependències i compilació.

2. Quins processos llança

A Windows:

  • powershell.exe -NonInteractive -NoProfile, sense finestra, per a consultes de només lectura (Get-ScheduledTask, Get-MpPreference, Get-ItemProperty). També el fa servir per mostrar les seves pròpies finestres i avisos: connectar l'espai, enviar un problema, triar la carpeta de projectes i la notificació en acabar.
  • code --list-extensions, per saber quines extensions d'IA té VS Code.
  • git, només amb ordres locals de lectura (rev-parse, ls-files, rev-list, config) i amb els hooks desactivats.
  • explorer.exe, per obrir l'informe al navegador.

A macOS i Linux llança git igual, i l'ordre del sistema per obrir l'informe i mostrar la notificació (open, xdg-open, notify-send).

No instal·la serveis, controladors ni tasques programades. No canvia el registre ni la configuració de cap programa.

3. Què escriu i on

Només dins de %USERPROFILE%\.rosmarops (a macOS i Linux, ~/.rosmarops):

  • el seu estat, state.json;
  • els informes, en HTML i JSON;
  • a la carpeta data, el registre d'enviaments (rosmarops-sends.log) i la llista local de problemes que troba.

Res més.

4. Quan es connecta i on

Per defecte, mai. Només es connecta en dos casos, sempre per HTTPS i només a app.rosmarops.com, port 443:

  • si la persona connecta l'ordinador al seu espai: envia els seus resultats, xifrats, després de cada revisió;
  • si la persona prem «Enviar» quan el programa troba un problema: envia la llista de codis d'error, sense rutes, noms ni claus. Això és des de la versió 0.11.0.

Cada enviament queda a rosmarops-sends.log.

Respecta HTTPS_PROXY. Si bloqueges app.rosmarops.com, tota la resta funciona igual: la revisió i l'informe no necessiten xarxa.

5. Com es garanteix

Cada promesa d'aquesta pàgina té una prova automàtica al codi, que s'executa a cada canvi:

  • que no hi ha xarxa fora d'aquest únic host;
  • que no escriu fora de la seva carpeta;
  • que cap clau no surt sencera.

Les tens, una per una, al model de confiança: https://github.com/qtorb/rosmarops/blob/master/docs/trust-model.md

El codi és obert (AGPL-3.0): https://github.com/qtorb/rosmarops

6. Com comprovar el binari

Encara no està signat amb un certificat de signatura de codi. Per saber que és el que es va compilar al repositori:

  1. Suma de control. Cada versió publica SHA256SUMS.txt. A Windows:

    Get-FileHash rosmarops.exe -Algorithm SHA256

    i compara el resultat amb la línia de rosmarops.exe.
  2. Atestació de GitHub. Uneix el binari al commit exacte i al workflow que el va compilar:

    gh attestation verify rosmarops.exe --repo qtorb/rosmarops

  3. Compilació reproduïble. El pots compilar tu mateix des de l'etiqueta de la versió i obtenir la mateixa suma. Els passos són al README: https://github.com/qtorb/rosmarops#build-it-yourself

7. Quines alertes poden saltar i per què

  • «Accés a credencials», perquè obre fitxers com .aws/credentials, .git-credentials o els de sessió dels agents. És el que mesura: quines claus pot llegir cada agent.
  • «PowerShell llançat per un programa sense signar», perquè és així com fa les seves consultes de només lectura i mostra les seves finestres.
  • «Consulta de les exclusions de Defender» (Get-MpPreference), perquè avisa quan apareix una exclusió nova, que és una cosa que també fa el programari maliciós.
  • «Programa poc comú» o SmartScreen, perquè és nou, encara no té reputació i no està signat.
  • Moltes lectures de fitxers en poc temps, perquè recorre els projectes buscant claus.

Cap d'aquestes alertes no va acompanyada d'escriptures fora de .rosmarops ni de connexions a cap altra destinació. Si en veus alguna de les dues, no és RosmarOps tal com el publiquem.

8. Com autoritzar-lo

  1. Comprova el binari com a l'apartat 6.
  2. Autoritza'l per la seva empremta SHA-256, no per la seva ruta. Així, una còpia modificada no hereta el permís. Cada versió nova té una empremta nova.
  3. Si vols, prova'l abans en un ordinador de proves i mira al teu EDR què obre, què llança i què escriu. Ha de coincidir amb aquesta pàgina.
  4. Si no vols que es connecti mai, bloqueja app.rosmarops.com. Funciona igual.

9. Contacte

Per avisar d'una fallada de seguretat: https://github.com/qtorb/rosmarops/blob/master/SECURITY.md

Per a qualsevol altra pregunta: legal@rosmarops.com