osFoundry trova il codice anche quando non sai cosa cercare

Cerchi “lock out” e il progetto non restituisce nulla. Il codice c’è, ma lo chiama cooldown, throttle, isCoolingDown. Grep non trova. L’app desktop osFoundry trasforma il repository in vettori e cerca per significato, così individui dove scatta il blocco dopo password sbagliate anche se il nome è diverso¹.

Si parte dalla scansione. Apri Indexes, aggiungi la cartella del progetto e guardi cosa coprirebbe l’indicizzazione. Vedi quanti file, quanti megabyte e quanti chunk, e perché il resto viene escluso. La scansione non costa nulla e non crea embedding. Serve a capire cosa entra e cosa no prima di premere il tasto di indicizzazione¹.

La lista degli esclusi non è un errore. L’app salta sempre node_modules, dist, build.git e .venv, oltre alle regole del tuo .gitignore. Ignora anche i lockfile, per esempio package-lock.json e pnpm-lock.yaml. Scarta i file binari e quelli oltre 1 MB. Non sono codice che si cerca per significato¹.

Il resto viene tagliato in pezzi. Circa 700 token per chunk, con una sovrapposizione di 80 token. Così una funzione a cavallo tra due blocchi finisce intera almeno in uno. Ogni chunk mantiene il numero di riga iniziale e finale. Questo consente di restituire file.ts:1-46 invece di un generico percorso di file¹.

Per indicizzare in locale premi “Index locally · bge-m3 · free”. Il modello bge-m3 gira sul tuo computer, legge ogni chunk e scrive il suo vettore. Niente upload, niente costi. Il primo giro su un portatile richiede tempo, perché ogni pezzo passa nel modello una volta. Poi diventa incrementale. Se il testo non cambia, il vettore resta valido. Modifichi una funzione, l’app re-embedda solo i chunk toccati. Puoi anche attivare la reindicizzazione automatica quando i file cambiano¹.

Quando il badge dice Ready, vedi “on-device · bge-m3” accanto alla cartella. A quel punto puoi chiedere in chiaro. Apri una chat Maestro e scrivi come faresti a un collega: “Dove blocchiamo un utente dopo troppe password sbagliate?”¹.

L’agente prova prima grep. Se non trova corrispondenze, chiama folder_search. Il tool esegue due ricerche in parallelo: una per keyword e una vettoriale sui chunk. Poi fonde le classifiche con Reciprocal Rank Fusion, che guarda solo la posizione in ciascuna lista. Un pezzo in alto in entrambe sale in vetta. L’agente restituisce il file e l’intervallo di righe e legge il sorgente prima di rispondere, così puoi saltare subito al punto giusto¹.

Grep resta la scelta migliore quando conosci l’identificatore, il messaggio di errore o il nome del file. La ricerca per significato serve quando sai descrivere il comportamento ma non il lessico usato nel codice. È tipico nella prima settimana su una codebase nuova¹.

L’app è disponibile per macOS, Windows e Linux. La voce di prezzo cloud che vedi a destra riguarda l’altro pulsante, e il conteggio di token è sovrastimato di proposito, calcolato a un token ogni tre byte, così il valore reale non lo supera¹.