🦞

Lobster Code
Il coding agent AI che vive sul tuo computer.

Un agente AI che scrive codice, gestisce file, usa git e automatizza il lavoro. 100% locale, zero cloud, zero costi. Web UI + Ollama, pronto in 2 minuti.

✦ Open Source — MIT License
⚡ Powered by Ollama — 100% locale
# Clona il repository
git clone https://github.com/SuperSapiensAi/LobsterCode.git
cd LobsterCode/ui

# Installa Ollama (ollama.ai) e scarica un modello con tool calling
ollama pull gemma4:latest

# Avvia Lobster Code
bash start-agent.command
Funzionalità

Non un chatbot. Un agente che lavora davvero.

Scrive codice, esegue comandi, versiona, protegge i tuoi file e impara il tuo progetto.

🧬

Project DNA

Scansiona il tuo progetto e ne costruisce un profilo persistente: stack, convenzioni, linter, test framework, struttura. L'agente scrive codice che rispetta il tuo stile.

Prompt Templates

Template intelligenti che si adattano al tuo stack. React? Ti suggerisce componenti. Python? Ti offre venv e test. Zero configurazione.

🚀

Agent Loop Multi-Turn

Non si ferma alla prima risposta. Esegue fino a 10 turni consecutivi di tool calling per completare task complessi in autonomia.

🐜

Git integrato

Status, diff, commit e log direttamente dalla sidebar. Niente terminale, niente context switch.

Snapshot & Rollback

Ogni azione crea uno snapshot automatico. Se qualcosa va storto, torni indietro con un click. Zero rischio.

🔒

Workspace Isolation

L'agente accede solo alle cartelle che gli concedi tu. Tre livelli di permesso con enforcement reale: scrittura limitata al workspace, tool MCP solo in full-access, anti-escalation integrato.

🛠

7 Tool nativi

bash, read_file, write_file, edit_file, list_directory, search_files, glob_search. Tutto il necessario per lavorare sul codice.

🧠

Session Memory

Salva note e contesto in .lobster/context.md nel tuo workspace. Appunti, decisioni e preferenze persistono tra le sessioni.

📋

Diff Preview

Ogni modifica mostra un diff riga per riga. Sai sempre cosa cambia, prima e dopo.

🔌

MCP Protocol

Connetti tool esterni via Model Context Protocol. Database, GitHub, Slack, browser — un file JSON e l'agente li usa come tool nativi.

🛡

Sicurezza nativa

Path di sistema protetti, comandi distruttivi bloccati, scritture atomiche, anti-escalation. L'agente non può auto-promuoversi né rompere il tuo OS.

👁

Streaming in tempo reale

Le risposte arrivano parola per parola via Server-Sent Events. Vedi l'agente pensare e agire in tempo reale.

🔮

Setup Wizard

Verifica Ollama, controlla la RAM, consiglia il modello migliore e lo scarica con un click. Operativo in 2 minuti.

Guarda come lavora

Agent loop reale con tool calling, diff preview e snapshot automatico.

Lobster Code — 🦞 Ollama · gemma4:latest
🚀 Ollama · gemma4:latest · Permessi: workspace-write
👤 Crea un componente React counter con TypeScript e test
# L'agente rileva: React + TypeScript + Jest
🔧 bash → mkdir -p src/components
🔧 write_file → src/components/Counter.tsx (38 righe)
+ export const Counter: React.FC = () => { ... }
🔧 write_file → src/components/Counter.test.tsx
✅ Componente creato! Snapshot salvato (3 file) · Rollback disponibile
Architettura

Architettura minima, massima potenza

Web UI in vanilla JS, backend Python stdlib, Ollama per l'AI.

🐍

Python

Backend puro stdlib, zero pip install

🦞

Ollama

LLM locali con tool calling nativo

🌐

Vanilla JS

Frontend senza framework, streaming SSE

🔒

3 livelli di permesso

Read-only, workspace-write (con enforcement path), full-access (con conferma)

Scegli il cervello che preferisci

Solo modelli con tool calling nativo verificato. Il wizard suggerisce il migliore per la tua RAM.

🏆

Qwen 2.5 Coder 14B

Il migliore per coding. Tool calling nativo, veloce e preciso.

Coding Tools
💎

Gemma 4 12B

Di Google. Multilingua eccellente, tool calling nativo, 128K contesto.

Generale Tools 128K
🌊

Mistral 7B

Versatile e veloce. Tool calling nativo, ottimo bilanciamento.

Generale Tools Veloce
🤖

Llama 3.3 70B

Di Meta. Tool calling nativo, potente e versatile. Richiede 48GB+ RAM.

Generale Tools 128K
🔮

Codestral 22B

Di Mistral AI, specializzato coding. 80+ linguaggi supportati.

Coding Tools
Confronto

Lobster Code vs. altri tool

Cosa ottieni scegliendo un agente locale, gratuito e open source.

🦞 Lobster Code Cursor Claude Code Ollama Chat
Costo Gratis $20/mese Pay-per-use Gratis
Privacy (locale)
Agent loop con tool
Web UI IDE CLI
Git integrato
Snapshot & Rollback
Permission system
Open source MIT
Zero config
MCP / Estensibilità
Come usarlo

Dalla riga di comando al progetto completo

Non è un chatbot. È un collega che esegue, versiona e protegge il tuo lavoro.

🏗

Scaffolding progetti

Crea strutture complete con context-awareness. L'agente rileva lo stack e adatta le sue azioni.

"Crea un'API REST in FastAPI con auth JWT e test pytest"
🐛

Debug e fix

Legge il codice, trova il bug, lo corregge con diff preview e crea uno snapshot per rollback.

"Il login non funziona, controlla auth.py e fixalo"
📂

Refactoring sicuro

Snapshot automatico prima di ogni modifica. Se non ti piace il risultato, rollback con un click.

"Refactora utils/ separando le funzioni per dominio"
📈

Analisi dati

Elabora CSV, genera grafici, calcola statistiche. Tutto locale, i tuoi dati restano tuoi.

"Analizza vendite.csv, mostra trend mensile e top 5 prodotti"
🐜

Git workflow

Commit, branch, log dalla UI. Genera changelog automatici analizzando i commit recenti.

"Genera un changelog dal branch develop e committalo"
🎨

Frontend da zero

HTML, CSS, JS — componenti, animazioni, responsive. Vede il diff di ogni file che tocca.

"Crea una landing page per il mio portfolio con dark mode"
"Il miglior tool è quello che non ti chiede mai di uscire dal tuo flusso. Lobster vive dove lavori tu — nei tuoi file, con i tuoi dati, tutto locale. Nessun cloud che ti spia, nessun abbonamento che ti frena."

— Il team di Lobster

🚀 Scopri anche Lobster Manager
🚀 Desktop App per macOS

Lobster Manager
Il centro di controllo del tuo dev environment.

App desktop nativa Electron + React + TypeScript. Gestisci progetti, Docker, porte, risorse di sistema e AI advisor — tutto in un'unica interfaccia. Open source, 100% locale, zero cloud.

✦ Open Source — MIT License 🔒 100% Locale — Zero Cloud ⚡ Gratuito per sempre
⬇ Scarica per macOS Codice Sorgente
🔍

Auto-Discovery Progetti

Rileva automaticamente tutti i tuoi progetti, il loro stack, framework, porte attive e container Docker associati.

🚦

Dashboard Real-Time

Semaforo verde/giallo/rosso per ogni progetto. Stato porte, container e git branch aggiornato in tempo reale.

🐳

Docker Manager

Start, stop, restart e log dei container. Gestisci Docker Compose con un click. Niente più terminale.

🔌

Port Monitor

Chi usa quale porta? Rileva conflitti, mostra il processo responsabile e puoi terminarlo dalla UI.

🧠

Smart Advisor AI

Analisi intelligente dei progetti con suggerimenti, triage priorità e report di sicurezza — powered by Ollama.

🦞

LobsterCode Integrato

Il coding agent direttamente nell'app. Tool calling, git, snapshot e rollback senza uscire dal Manager.

📝

.lobster.md per Progetto

Note, stack, diario e istruzioni AI per ogni progetto. Generate e aggiornate automaticamente.

👤

MY-PROFILE.md

Il tuo profilo personale per le AI: chi sei, come lavori, i tuoi progetti attivi. Auto-generato.

🔔

Notifiche e Monitoraggio

Avvisi in tempo reale quando un progetto si avvia, si ferma o un container entra in stato di errore.

Guarda cosa fa il Manager

Lobster Manager — 🦞 Dashboard
🚀 Auto-Discovery · Trovati 5 progetti · 3 attivi
🔍 Scan ~/Developer — React, FastAPI, Go rilevati
🔌 Port Monitor → :3000 (next-app) · :8080 (api) · :5432 (postgres)
🐳 Docker → 4 container running · 1 warning (high memory)
# Smart Advisor analizza il progetto “e-commerce”
🧠 Advisor → 2 conflitti porta rilevati · 1 container da riavviare
+ .lobster.md generato per “e-commerce” (stack, dipendenze, note)
✅ Dashboard aggiornata · Notifiche: 1 alert · Sistema stabile

Stack nativo, prestazioni native

Electron

App desktop nativa cross-platform

React + TypeScript

UI moderna, type-safe, component-based

🐳

Docker SDK

Gestione container senza terminale

🦞

Ollama

AI advisor e LobsterCode integrato

Scenari reali, ogni giorno

🔍

Discovery automatica

Apri il Manager e vedi subito tutti i tuoi progetti con stack, porte attive e container Docker associati.

Trova i 12 progetti in ~/Developer in 3 secondi
🔌

Conflitti porte

Un servizio non parte? Il Manager ti mostra chi sta usando quella porta e puoi terminare il processo con un click.

:3000 occupata da node — kill e riavvia
🐳

Docker senza terminale

Start, stop, restart, log e health check dei container. Docker Compose con un click. Niente più docker ps.

Restart del database quando i test falliscono
🧠

AI che capisce i tuoi progetti

Lo Smart Advisor analizza ogni progetto, suggerisce ottimizzazioni, rileva problemi di sicurezza e genera report.

“Il container redis usa troppa RAM, consiglio: imposta maxmemory”
📝

Documentazione automatica

Ogni progetto ha il suo .lobster.md con stack, dipendenze, note e istruzioni AI. Auto-generato e aggiornabile.

Context file pronto per qualsiasi AI o nuovo sviluppatore
📈

Monitoraggio risorse

CPU, RAM e disco in tempo reale. Alert quando un container o processo consuma troppo. Dashboard con semaforo verde/giallo/rosso.

Notifica: postgres usa il 90% della RAM allocata

Installa Lobster Manager

# Clona e avvia in modalità sviluppo
git clone https://github.com/SuperSapiensAi/LobsterCode.git
cd LobsterCode/lobster-utility
npm install
npm run dev

# Oppure builda l'app nativa per macOS
bash build-app.sh

Pronto per iniziare?

Lobster Code e Lobster Manager sono gratuiti, open source e pronti all'uso. Zero configurazione, nessun account, nessun abbonamento.

Repo su GitHub Installa Code → Installa Manager →