Comece aqui

Início rápido

O Lampson é um agente de programação que vive no seu projeto. Você o abre dentro de uma pasta, diz o que quer em palavras simples, e ele lê, edita e executa — mostrando cada passo e perguntando antes de qualquer ação arriscada.

Instalar§

npm i -g lampson

Não tem Node.js? Existe um instalador de uma linha para Windows, macOS e Linux que traz tudo o que é preciso.

Abrir um projeto§

cd path/to/your/project
lampson            # no terminal
lampson --web      # no navegador, em http://127.0.0.1:8080

A pasta em que você está vira o espaço de trabalho (workspace) do agente: o único lugar em que ele pode ler ou escrever. Tanto o terminal quanto a versão web trabalham no mesmo projeto e compartilham as mesmas configurações e as mesmas sessões.

Escolher um modelo§

Na primeira vez, o Lampson pergunta duas coisas: qual provedor você usa (DeepSeek, Anthropic, OpenAI, Kimi, Groq, OpenRouter, Ollama…) e a sua chave de API. Isso fica salvo na sua máquina — em nenhum outro lugar — e é compartilhado pelo terminal e pela interface web. Mude quando quiser com /model.

Não tem um favorito? O DeepSeek é barato e funciona muito bem. O Ollama roda um modelo no seu próprio computador, sem chave nenhuma. Veja Modelos e provedores.

Pedir algo§

Digite o que você quer, como diria a um colega:

❯ o formulário de login não mostra erro quando a senha está errada. corrija isso

Você verá o Lampson pesquisar, ler os arquivos relevantes, editar um deles e rodar os testes — cada passo em sua própria linha, com um ✓ e um resultado curto. Quando ele quer fazer algo com consequências (instalar um pacote, apagar arquivos, git reset), ele para e pergunta:

? bash npm install zod        allow? ❯ yes  no

Responda com as setas do teclado, ou com p/d. Ler e editar arquivos dentro do projeto nunca precisa de aprovação.

Próximos passos§

• Sua primeira sessão — o terminal, os comandos com /, ! para executar coisas você mesmo.
• Permissões — o que é permitido, o que pergunta, o que é sempre recusado.
• Plugins — dê novas ferramentas ao agente e ative-os quando quiser.