Comece aqui

A interface web

lampson --web

abre http://127.0.0.1:8080 no projeto da pasta atual. Mesmo agente, mesmas configurações e sessões do terminal — escolha o que preferir, ou use os dois.

A tela§

• Cabeçalho — o nome do projeto, o modo de permissões (ask / yolo / strict), a pílula de plugins (quantos estão ligados), a pílula provider · model (clique para trocar), ⚙ configurações, >_ terminal e o botão sol/lua para o tema.
• Painel esquerdo — sessões (com ≡ para o trace de cada uma — o registro passo a passo), a árvore de arquivos, a memória do projeto, servidores MCP e LSP, API (as keys para seus apps e agentes), Canais (Telegram, Chatwoot…), tarefas agendadas e aprovações pendentes.
• Centro — o chat: cada passo de ferramenta como uma linha com seu resultado, diffs das edições e uma caixa de texto onde você pode colar ou arrastar imagens.
• Painel direito — os servidores que o agente iniciou (logs ao vivo), subagentes, a lista de tarefas da sessão, portas em uso.
• Árvore de arquivos — um clique abre o arquivo no editor: cores por tipo de arquivo (JS/TS, CSS, HTML, Python, Rust, Go, shell, SQL, YAML, Synsema…) e Ctrl+S salva. Se o agente mudou o arquivo em disco nesse meio-tempo, você escolhe entre sobrescrever ou recarregar em vez de perder algo; sem mudanças locais, ele se atualiza sozinho. Clique com o botão direito em um arquivo, uma pasta ou no espaço vazio para o menu de sempre: novo arquivo ou pasta, renomear, duplicar, copiar / recortar / colar, copiar o caminho relativo ou absoluto, inserir o caminho no chat, excluir. Arraste um arquivo ou pasta sobre uma pasta para movê-lo (com Ctrl ao soltar, copia). Na linha selecionada, F2 renomeia, Delete pergunta antes de excluir e Ctrl+C / Ctrl+X / Ctrl+V copiam, recortam e colam. Nada sobrescreve um arquivo existente: uma duplicata vira nome copy.ext.

Aprovar§

Quando o agente quer fazer algo arriscado, a mensagem ganha dois botões, permitir e negar. Nada roda até você clicar em um deles.

API e Canais§

• API — crie uma key (quais agentes ela pode usar, quantos pedidos por minuto, para quais URLs pode mandar callbacks) e veja-a uma única vez, com as URLs da API e do MCP prontas para copiar; revogue as que você não usa mais. → API HTTP
• Canais — cada canal instalado: ligar ou desligar, qual agente responde, o modo (webhook ou sem URL pública), a URL do webhook, configurar e os últimos eventos. → Canais

Equipes e objetivos§

No início (http://127.0.0.1:8080/), cada projeto mostra suas equipes e o que espera por você, e equipos abre a visão de todos os seus projetos (/equipos). Dentro de um projeto, o botão equipos do cabeçalho abre uma tela à parte, em tela cheia: seus objetivos (com o quadro, o informe e o resultado) e suas equipes como um grafo ao vivo — quem se reporta a quem, quem está trabalhando, qual mensagem está passando — com o quadro, o registro e um editor para montá-las.

O que espera por você — as perguntas dos seus agentes e o que pedem para aprovar, incluindo os merges na main com o que entra — fica na caixa de entrada: o botão ⚑ do cabeçalho, em todas as telas, com tudo de todos os seus projetos. Você responde ali mesmo, também pelo celular.

Terminais no navegador§

>_ terminal abre um shell de verdade no painel central, na pasta do seu projeto — até quatro abas com + nueva terminal (“nova terminal”). Elas sobrevivem a um recarregamento da página (o shell continua rodando; a página se reconecta e reexibe a última saída) e morrem junto com o Lampson.

A tela de espaços de trabalho§

http://127.0.0.1:8080 sem nenhum projeto mostra todos os espaços de trabalho (workspaces): os projetos que você já abriu com o Lampson. Abra um, crie um a partir de um seletor de pastas, ligue-os e desligue-os. Veja Espaços de trabalho.

Só local§

A API web responde apenas ao seu próprio computador. Qualquer outro endereço recebe 401. Para deixar um script entrar de outro lugar, defina LAMPSON_WEB_TOKEN no .env e envie Authorization: Bearer <token>. Para acessar o Lampson pelo celular e aprovar ações, veja Tarefas agendadas — isso passa por links de uso único, nunca pela exposição da API.