Empieza aquí

La interfaz web

lampson --web

abre http://127.0.0.1:8080 sobre el proyecto de la carpeta actual. El mismo agente, los mismos ajustes y sesiones que en la terminal — elige la que prefieras, o usa ambas.

La pantalla§

• Cabecera — el nombre del proyecto, el modo de permisos (ask / yolo / strict), el pill de plugins (cuántos están encendidos), el pill provider · model (haz clic para cambiar), ⚙ ajustes, >_ terminal y el interruptor de tema sol/luna.
• Panel izquierdo — sesiones (con ≡ para la traza de cada una), el árbol de archivos, la memoria del proyecto, servidores MCP y LSP, API (las keys para tus apps y agentes), Canales (Telegram, Chatwoot…), tareas programadas y aprobaciones pendientes.
• Centro — el chat: cada paso de herramienta como una línea con su resultado, diffs para las ediciones y un cuadro de texto donde puedes pegar o arrastrar imágenes.
• Panel derecho — los servidores que arrancó el agente (logs en vivo), subagentes, la lista de tareas de la sesión, puertos en uso.
• Árbol de archivos — un clic abre el archivo en el editor: colores según el tipo (JS/TS, CSS, HTML, Python, Rust, Go, shell, SQL, YAML, Synsema…) y Ctrl+S guarda. Si el agente cambió el archivo en disco mientras tanto, se te pregunta si sobrescribir o recargar en vez de perder nada; si no tienes cambios locales, se actualiza solo. Clic derecho sobre un archivo, una carpeta o el espacio vacío muestra el menú de siempre: nuevo archivo o carpeta, renombrar, duplicar, copiar / cortar / pegar, copiar la ruta relativa o absoluta, insertar la ruta en el chat, eliminar. Arrastra un archivo o carpeta sobre una carpeta para moverlo (con Ctrl al soltar, lo copia). Sobre la fila seleccionada, F2 renombra, Supr pregunta antes de borrar y Ctrl+C / Ctrl+X / Ctrl+V copian, cortan y pegan. Nunca se pisa un archivo existente: un duplicado se llama nombre copy.ext.

Aprobar§

Cuando el agente quiere hacer algo arriesgado, el mensaje recibe dos botones, permitir y denegar. Nada se ejecuta hasta que haces clic en uno.

API y Canales§

• API — crea una key (qué agentes puede usar, cuántos pedidos por minuto, a qué URLs puede mandar callbacks) y la ves una sola vez, con las URLs de la API y del MCP listas para copiar; revoca las que ya no uses. → API HTTP
• Canales — cada canal instalado: encenderlo o apagarlo, qué agente contesta, el modo (webhook o sin URL pública), la URL del webhook, configurar y los últimos eventos. → Canales

Equipos y objetivos§

En el inicio (http://127.0.0.1:8080/), cada proyecto muestra sus equipos y lo que te espera, y equipos abre la vista de todos tus proyectos (/equipos). Dentro de un proyecto, el botón equipos de la cabecera abre una pantalla aparte, a pantalla completa: tus objetivos (con su tablero, su informe y su resultado) y tus equipos como un grafo en vivo — quién reporta a quién, quién está trabajando, qué mensaje pasa — con su tablero, su registro y un editor para armarlos.

Lo que te espera —las preguntas de tus agentes y lo que piden aprobar, incluidos los merges a main con lo que entra— está en la bandeja: el botón ⚑ de la cabecera, en todas las pantallas, con todo de todos tus proyectos. Se responde ahí mismo, también desde el celular.

Terminales en el navegador§

>_ terminal abre un shell real en el panel central, en la carpeta de tu proyecto — hasta cuatro pestañas con + nueva terminal. Sobreviven a una recarga de la página (el shell sigue ejecutándose; la página se vuelve a conectar y reproduce la última salida) y mueren con Lampson.

La pantalla de espacios de trabajo§

http://127.0.0.1:8080 sin proyecto muestra todos los proyectos que has abierto con Lampson. Abre uno, crea uno desde un selector de carpetas, enciéndelos y apágalos. Consulta Espacios de trabajo (workspaces).

Solo local§

La API web responde únicamente a tu propia computadora. Cualquier otra dirección recibe 401. Para dejar entrar a un script desde otro sitio, define LAMPSON_WEB_TOKEN en .env y envía Authorization: Bearer <token>. Para llegar a Lampson desde tu teléfono y aprobar cosas, consulta Tareas programadas — eso va por enlaces de un solo uso, nunca exponiendo la API.