Projetos
Um projeto é uma pasta no seu computador que o OpenChamber acompanha — geralmente uma base de código. Trocar de projeto troca a pasta em que o agente trabalha, junto com as sessões e configurações daquele projeto.
Adicionar um projeto
Você pode adicionar um projeto a partir de alguns lugares:
- a entrada Add project na paleta de comandos
- o botão + no topo da barra lateral de sessões
- o navegador de pastas quando você escolhe um diretório
Aponte-o para uma pasta e o OpenChamber a memoriza. O nome vem da pasta; você pode mudá-lo depois.
Trocar de projeto
Escolha um projeto na barra lateral para torná-lo ativo. Tudo — sessões, git, notas — segue o projeto que você tem aberto.
Tornar um projeto reconhecível
Abra Settings → Projects para dar a um projeto um nome, cor ou ícone personalizado. O OpenChamber tenta encontrar um ícone automaticamente — veja Ícones de projeto.
No VS Code, o OpenChamber sempre usa a pasta que você tem aberta como o único projeto, então não há nada para adicionar ou trocar. A página de configurações de Projects fica oculta lá.
Ambiente do projeto
Quando as ferramentas de um projeto vêm do direnv, do devenv ou de um shell Nix, os hooks do Git, o terminal e as ações de projeto não as encontram sozinhos. Abra Configurações → Projetos, escolha o projeto e, em Ambiente:
- adicione variáveis de que só esse projeto precisa
- ou defina um comando de ambiente que as imprima, por exemplo
direnv export jsonoudevenv print-dev-env --json
O comando roda na pasta do projeto e, para um worktree, na pasta do próprio worktree. Ele roda de novo quando você faz um commit, abre um terminal ou roda uma ação, se a última execução já tiver alguns minutos, e Rodar de novo o executa na hora. Só ter o projeto aberto não faz ele rodar. Embaixo do campo você vê quantas variáveis a última execução adicionou, ou por que ela falhou. Uma execução que falha não adiciona nada, e o Git e o terminal continuam funcionando sem ela.
Essas variáveis vão para o Git, o terminal e as ações de projeto, somadas às de Configurações → Geral → Variáveis de ambiente (veja Variáveis de ambiente). O OpenCode atende todos os projetos a partir de um único processo, então ele não recebe variáveis de projeto: coloque o que o agente precisa na lista geral.
O comando é só seu. Ele não é lido do repositório, então um repositório clonado não consegue fazer o OpenChamber rodar nada.
Relacionado
- Conversas — sessões sem projeto, para perguntas rápidas
- Notas, Tarefas e Planos do Projeto — mantenha notas de trabalho por projeto
- Ações de Projeto — salve comandos que você executa com frequência
- Contexto — veja quanto da memória do modelo uma sessão está usando