Empieza aquí

Inicio rápido

Lampson es un agente de programación que vive en tu proyecto. Lo abres dentro de una carpeta, le dices lo que quieres con tus palabras, y él lee, edita y ejecuta — mostrándote cada paso y preguntando antes de cualquier cosa arriesgada.

Instalar§

npm i -g lampson

¿No tienes Node.js? Hay un instalador de una línea para Windows, macOS y Linux que trae todo lo necesario.

Abrir un proyecto§

cd path/to/your/project
lampson            # en la terminal
lampson --web      # en el navegador, en http://127.0.0.1:8080

La carpeta en la que estás se convierte en el espacio de trabajo (workspace) del agente: el único lugar donde puede leer o escribir. Tanto la versión de terminal como la web trabajan sobre el mismo proyecto, comparten los mismos ajustes y las mismas sesiones.

Elegir un modelo§

La primera vez, Lampson pregunta dos cosas: qué proveedor usas (DeepSeek, Anthropic, OpenAI, Kimi, Groq, OpenRouter, Ollama…) y tu clave de API. Se guarda en tu máquina — en ningún otro sitio — y la comparten la terminal y la interfaz web. Cámbiala cuando quieras con /model.

¿No tienes un favorito? DeepSeek es económico y funciona muy bien. Ollama ejecuta un modelo en tu propia computadora sin ninguna clave. Consulta Modelos y proveedores.

Pedir algo§

Escribe lo que quieres como se lo dirías a un compañero:

❯ el formulario de login no muestra un error cuando la contraseña es incorrecta. arréglalo

Verás a Lampson buscar, leer los archivos relevantes, editar uno y ejecutar los tests — cada paso en su propia línea con un ✓ y un resultado breve. Cuando quiere hacer algo con consecuencias (instalar un paquete, borrar archivos, git reset) se detiene y pregunta:

? bash npm install zod        allow? ❯ yes  no

Responde con las flechas del teclado, o con p/d. Leer y editar archivos dentro del proyecto nunca necesita aprobación.

Qué sigue§

• Tu primera sesión — la terminal, los comandos con /, ! para ejecutar cosas tú mismo.
• Permisos — qué se permite, qué pregunta, qué se rechaza siempre.
• Plugins — dale al agente herramientas nuevas y enciéndelos cuando quieras.