Dia a dia
Espaços de trabalho
Cada pasta que você abre com o Lampson vira um espaço de trabalho (workspace), com suas próprias sessões, memória, tarefas agendadas, plugins e servidores. Você pode ter vários abertos ao mesmo tempo e alternar entre eles sem parar nada.
cd ~/code/shop && lampson # registra ~/code/shop (na primeira vez) e abre o terminal nele
cd ~/code/blog && lampson --web # um segundo espaço de trabalho, no navegador
O hub§
http://127.0.0.1:8080 é o hub: a tela dos espaços de trabalho. Abra um, crie um (um seletor de pastas no seu desktop; um navegador de arquivos do lado do servidor em um VPS), ligue-os e desligue-os, defina por quanto tempo um espaço ocioso continua vivo.
Cada espaço de trabalho roda em seu próprio processo, atrás do hub; quando o hub reinicia sozinho (ao adicionar ou remover um espaço de trabalho) eles continuam rodando. A cada 15 segundos o hub inicia o que deveria estar rodando e para o que ficou ocioso (⚙ → horas de inatividade; 0 = nunca; um espaço de trabalho com tarefas agendadas continua ativo).
lampson --hub start|stop|status|logs|restart
lampson --install # manter o hub vivo entre logins (Windows: Tarefa Agendada · Linux: systemd --user)
Desligar ou reiniciar o Lampson§
Desligar um espaço de trabalho (no cartão dele no hub) para o processo daquele projeto; o hub continua ligado em localhost:8080 para você ligar os outros. Para o Lampson inteiro:
lampson --hub stop # o hub, todos os espaços de trabalho e o edge HTTPS (--domain)
lampson --hub start # liga de novo: http://127.0.0.1:8080
lampson --hub restart # stop + start, por exemplo depois de atualizar
lampson --hub status # se o hub está no ar e quais espaços de trabalho estão rodando
lampson --hub logs # as últimas linhas do log do hub
lampson --uninstall # desfaz o --install: o hub não inicia mais no login
O mesmo pelo navegador: ⚙ → Apagar o reiniciar. Reiniciar volta sozinho e a página recarrega; desligar só funciona no próprio PC, porque pelo celular não haveria como ligar de novo.
stop e restart cortam os terminais, os processos que o agente iniciou e qualquer turno em andamento; as sessões ficam salvas. Se você usou lampson --install, um hub desligado volta a iniciar no próximo login.
Onde as coisas ficam§
Nada é escrito dentro do seu projeto. O Lampson guarda seu próprio estado em ~/lampson:
| caminho | o que é |
|---|---|
~/lampson/.lampson/config.json | provedor, modelo, chaves, preferências |
~/lampson/.lampson/ws/<name>/ | uma pasta por espaço de trabalho: sessões, traces, agendamentos, logs de processos |
~/lampson/memory/<name>/ | as anotações do agente sobre aquele projeto |
~/lampson/plugins/ | plugins globais |
Dentro do seu projeto, só o que você decidir versionar: .lampson/plugins/, .lampson/mcp.json, .lampson/lsp.json, skills/, AGENTS.md.
Por que um processo por projeto§
No Synsema, o acesso de uma ferramenta a arquivos é um nome de pasta literal declarado no código. Um espaço de trabalho é, portanto, uma pequena pasta com um link chamado workspace que aponta para o seu projeto; o processo dele só enxerga essa pasta. É isso que torna "ele só pode tocar neste projeto" um fato, e não uma esperança.