# Lampson

> Agente de programação com IA, gratuito e open source, que mora no seu projeto; escrito em Synsema. Terminal + interface web, ferramentas confinadas ao projeto montado, qualquer modelo compatível com OpenAI ou Anthropic.

Install: `npm i -g lampson` · repository: https://github.com/kitecosmic/lampson · site: https://lampson.org/pt

## Documentação

- [Início rápido](https://lampson.org/pt/docs/quickstart.md): Instale o Lampson, abra um projeto, escolha um modelo de IA e dê sua primeira tarefa ao agente de programação no terminal — em cerca de dois minutos.
- [Sua primeira sessão](https://lampson.org/pt/docs/first-run.md): Como ler uma sessão do Lampson — os passos, os diffs, os comandos que começam com barra e como executar coisas você mesmo no terminal com o ponto de exclamação.
- [A interface web](https://lampson.org/pt/docs/web-ui.md): lampson --web — o mesmo agente de programação no navegador, com árvore de arquivos, logs ao vivo, terminais reais e painéis para tudo o que faz no terminal.
- [Permissões](https://lampson.org/pt/docs/permissions.md): O que o Lampson faz sozinho, o que pergunta a você e o que recusa em qualquer situação — mais os três modos do agente de programação: ask, yolo e strict.
- [Modelos e provedores](https://lampson.org/pt/docs/providers.md): Com quais APIs de modelos de IA o Lampson funciona, como trocar de provedor e como apontar para qualquer endpoint compatível, incluindo Ollama na sua máquina.
- [Espaços de trabalho](https://lampson.org/pt/docs/workspaces.md): Cada projeto que você abre é um espaço de trabalho (workspace) com processo próprio; um hub em 127.0.0.1:8080 permite alternar entre eles e os mantém vivos.
- [Sessões e traces](https://lampson.org/pt/docs/sessions.md): Cada conversa com o agente de programação é salva com todos os passos; reabra uma sessão depois e leia o trace para ver o que ele fez e quanto tempo levou.
- [Memória do projeto](https://lampson.org/pt/docs/memory.md): O Lampson guarda anotações por projeto — como rodar, armadilhas, decisões — e as relê na próxima sessão do agente de programação. Você pode ler e editá-las.
- [Plugins](https://lampson.org/pt/docs/plugins.md): Plugins são pastas que dão novas ferramentas ao Lampson, em qualquer linguagem — uma consulta ao banco, a API da sua empresa, um deploy. Desligados por padrão; você liga cada um.
- [Skills](https://lampson.org/pt/docs/skills.md): como fazemos um release deste projeto
- [Servidores MCP](https://lampson.org/pt/docs/mcp.md): Conecte servidores MCP com o mesmo JSON que já usa; as ferramentas deles entram na caixa do agente de programação e pedem permissão antes de rodar.
- [Servidores de linguagem (LSP)](https://lampson.org/pt/docs/lsp.md): Dê ao agente de programação ir à definição, referências e a estrutura dos arquivos via servidores de linguagem do seu projeto, em vez de adivinhar com grep.
- [Subagentes](https://lampson.org/pt/docs/subagents.md): O agente de programação divide o trabalho entre workers paralelos ou manda uma tarefa para segundo plano e segue falando com você; cada worker tem log ao vivo.
- [Tarefas agendadas](https://lampson.org/pt/docs/schedules.md): Execute tarefas sem ninguém no teclado — a cada 6 horas, todo dia às 9, dias úteis às 8:30 — e aprove ações arriscadas do agente de programação pelo celular.
- [Comandos e opções](https://lampson.org/pt/docs/commands.md): Todos os comandos com barra do terminal, todas as opções de inicialização do agente de programação Lampson e os atalhos de teclado do prompt.
- [Configuração](https://lampson.org/pt/docs/configuration.md): Tudo é opcional. Onde ficam as configurações do Lampson, o que o .env pode sobrescrever e os poucos ajustes do agente de programação que vale a pena conhecer.
- [Docker e servidores](https://lampson.org/pt/docs/deploy.md): Rode o Lampson em um contêiner ou em um VPS atrás do seu próprio domínio, com aprovações do agente de programação direto do celular.
- [Perguntas frequentes](https://lampson.org/pt/docs/faq.md): Respostas curtas às primeiras perguntas sobre o Lampson, o agente de programação com IA para o terminal: privacidade do código, modelos e custo.