Criando e configurando projetos
Criando um novo projeto
- Clique em Projetos no menu lateral
- Clique em Novo Projeto
- Preencha o formulário:
- Nome (obrigatório)
- Diretório de trabalho (caminho onde o agente vai operar)
- Ambiente (local, Bridge ou SSH)
- Contexto (use o Refinador IA ou escreva manualmente)
- Agente padrão (opcional)
- Credenciais (opcional)
- Clique em Criar projeto
Editando um projeto existente
- No card do projeto, clique no ícone de engrenagem (⚙️)
- Edite os campos desejados
- Clique em Salvar alterações
Diretório de trabalho
O diretório de trabalho define onde o agente opera por padrão. Ao pedir para o agente ler ou criar arquivos sem um caminho absoluto, ele usa este diretório como base.
Exemplos por ambiente:
| Ambiente | Exemplo de caminho |
|---|---|
| Windows (local/Bridge) | C:\Users\carlos\projetos\meu-app |
| Linux/macOS (local/Bridge) | /home/carlos/projetos/meu-app |
| SSH remoto | /var/www/meu-app |
Defina o diretório de trabalho como a raiz do repositório Git do projeto. Isso permite que o agente faça commits, leia a estrutura completa e navegue naturalmente pelos arquivos.
Contexto do projeto
O contexto é um texto livre injetado em toda nova sessão do projeto. Escreva o que o agente precisa saber sem que você precise repetir toda vez:
API REST em Node.js com Express e TypeScript.
ORM: Prisma com PostgreSQL.
Testes: Jest + Supertest.
Deploy: Railway via GitHub Actions.
Convenção de commits: Conventional Commits em inglês.
Diretório de trabalho: /home/carlos/projetos/api-pagamentos
Dicas para um bom contexto:
- Inclua a stack completa (linguagem, framework, banco, deploy)
- Mencione convenções do time
- Liste as principais restrições ou limitações
- Use o Refinador IA para gerar um contexto rico a partir de perguntas
Credenciais vinculadas
Credenciais são acessos (bancos de dados, servidores SSH) que o agente pode usar dentro do projeto. Ao vincular uma credencial, o agente pode acessar esses recursos sem você precisar informar as credenciais durante a conversa.
Gerencie credenciais em Configurações → Credenciais.