# Lampson — agente de programação com IA, open source, para o seu terminal e navegador

> Versão Markdown de https://lampson.org/pt — a mesma página que um navegador exibe como HTML.

Um agente de programação para os seus projetos

# Aponte para uma pasta.
Ele lê, edita e executa — *e pergunta antes.*

Lampson é um agente de programação que você instala uma vez e abre dentro de qualquer projeto. Converse com ele no terminal ou no navegador, acompanhe cada passo que ele dá e diga sim ou não antes que algo arriscado aconteça. Ele funciona com o modelo pelo qual você já paga.

[Instalar](https://lampson.org/pt/install)
[Ler a documentação](https://lampson.org/pt/docs)
[GitHub](https://github.com/kitecosmic/lampson)

$`npm i -g lampson`

depois entre em um projeto com `cd` e digite `lampson`

my-app — lampson

```
lampson 0.2 · deepseek-chat · build · ask

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

✓ grep "password" src/                    3 files
✓ read src/components/LoginForm.tsx       88 lines
✓ read src/api/auth.ts                   41 lines
✓ edit src/components/LoginForm.tsx       +6 −1
   40   } catch (err) {
   41 +   setError("Wrong email or password");
? bash npm test                          allow? ❯ yes  no
✓ bash npm test                          14 passed

O formulário agora mostra “Wrong email or password” abaixo do
campo de senha quando a API devolve 401. Os testes passam.

─── 5 steps · 12k tokens · 38s
```

## Nada para aprender. Nada para configurar.

Você descreve o que quer em palavras simples. O Lampson descobre quais arquivos importam, altera esses arquivos, roda os testes e mostra o resultado — um passo visível de cada vez.

### 01Fica dentro do seu projeto

O Lampson só pode tocar na pasta em que você o abriu. Nem na sua pasta pessoal, nem no projeto ao lado. Isso não é uma configuração que você poderia esquecer — é assim que funciona a linguagem em que ele foi escrito.

### 02Pergunta antes de qualquer ação arriscada

Ler e editar simplesmente acontecem. Apagar coisas, instalar pacotes, mexer no histórico do git, rodar instaladores — isso para e espera o seu *sim*. Comandos realmente destrutivos são recusados de imediato.

### 03Terminal ou navegador

`lampson` abre um chat no seu terminal. `lampson --web` abre o mesmo agente no navegador, com árvore de arquivos, logs ao vivo dos servidores que ele iniciou e uma aba de terminal de verdade.

### 04Seu modelo, sua chave

DeepSeek, GLM, Kimi, Groq, OpenRouter, Ollama na sua própria máquina, Anthropic, OpenAI… Escolha um provedor na primeira execução, cole uma chave, pronto. Troque a qualquer momento com um único comando.

### 05Lembra do seu projeto

Como rodar, o que quebrou da última vez, decisões que vocês tomaram juntos — o Lampson guarda anotações por projeto e as relê na próxima sessão. Você também pode ler e editar essas anotações.

### 06Trabalha enquanto você está fora

“Toda manhã às 9, rode os testes e me avise.” Tarefas agendadas rodam sozinhas; se uma delas encontra algo arriscado, você recebe um link no celular para aprovar ou negar.

Plugins

## Dê novas habilidades a ele. Ative quando quiser.

Um **plugin** é uma pequena pasta que ensina uma nova ferramenta ao Lampson: consultar seu banco de dados, chamar a API da sua empresa, fazer deploy, enviar uma mensagem. Os plugins vêm **desligados por padrão** — você liga cada um, e só então o agente pode usá-lo.

- Um plugin é uma pasta com um `plugin.json` e um script em qualquer linguagem.

- Um plugin em Synsema roda sob um teto de capacidades; um executável roda como está. Nos dois casos, ligá-lo é decisão sua.

- O agente pode *escrever* um plugin para você — mas nunca ligá-lo sozinho.

- Mantenha plugins globais (todos os projetos) ou dentro de um só projeto.

[Como os plugins funcionam →](https://lampson.org/pt/docs/plugins)

plugins

```
$ ls ~/lampson/plugins/
example-hello/  deploy/  postgres/

$ cat ~/lampson/plugins/postgres/plugin.json
{
  "name": "postgres",
  "description": "read-only queries on the dev database",
  "kind": "exec",
  "command": "python query.py",
  "tools": [{ "name": "query", "readonly": true, … }]
}

lampson ❯ /plugins on postgres
☼ postgres is on — 1 tool available: plugin_postgres_query
```

Também incluído

## O que você esperaria, sem a configuração.

- **Subagentes** — ele pode dividir um trabalho em workers paralelos e reunir os resultados.

- **Skills** — coloque um `SKILL.md` no seu projeto e o agente aprende os seus procedimentos.

- **Servidores MCP** — a mesma configuração JSON que você já usa em outros lugares.

- **Servidores de linguagem** — ir à definição e às referências em vez de adivinhar com grep.

- **Sessões e traces** — cada passo é salvo; reabra uma conversa dias depois.

- **Imagens** — cole uma captura de tela e pergunte sobre ela.

Funciona com

DeepSeekAnthropicOpenAIGLM (Z.ai)KimiGroqGrokOpenRouterMiniMaxOllamaqualquer API compatível com OpenAI

Sua chave de API fica guardada na sua máquina e só é enviada ao provedor que você escolheu. O Lampson não tem servidor próprio — nada sai do seu computador além da sua conversa com o modelo.

## Experimente em um projeto que você tem aberto agora mesmo.

Uma linha para instalar. Uma palavra para começar.

$`npm i -g lampson`

[Outras formas de instalar](https://lampson.org/pt/install)
[Início rápido](https://lampson.org/pt/docs/quickstart)