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, 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. 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.

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.