Skip to content

.env da pasta de trabalho ​

Cada variável do .env da pasta de trabalho: onde ficam projetos, agentes, skills e MCPs, qual provider roda os agentes e as cores da saída.

Para ver o valor em vigor de cada uma e de onde ele vem (o ambiente, o .env ou o padrão), rode choliba list config; as credenciais aparecem só como definida ou não definida.

Para gravar uma delas no .env, rode choliba set config CHAVE valor, por exemplo choliba set config CHOL_SANDBOX docker. O comando grava uma chave por vez e diz o valor anterior. Uma chave com uma lista de valores só aceita um deles. Se o ambiente do processo define a chave, ele vence o .env, e o comando avisa. Uma credencial (CLAUDE_CODE_OAUTH_TOKEN, CURSOR_API_KEY) não vai na linha de comando, porque ficaria no histórico do shell. Rode choliba set config CURSOR_API_KEY sem o valor: num terminal, o choliba pede o valor sem mostrar o que é digitado; fora de um terminal, lê do stdin (echo "$TOKEN" | choliba set config CURSOR_API_KEY).

Quais destes valores o agent.yaml pode usar, e como: veja Variáveis. As credenciais de um projeto ficam no .env.json dele, não aqui: .env.json do projeto.

Cada pacote declara o próprio grupo. choliba list config mostra os grupos nesta ordem: agents, projects, sandbox e choliba.

GrupoVariávelPara quê
agentsCHOL_AGENTS_PROVIDERProvider padrão (auto, claude, claude-ollama ou cursor; padrão auto); --provider na linha de comando vence.
agentsCHOL_OLLAMA_URLOnde o provider claude-ollama encontra o Ollama (padrão http://localhost:11434); veja Ollama.
agentsCHOL_PLAYWRIGHT_MCP_OUTPUT_DIROnde a ferramenta playwright-cli grava arquivos e onde playwright-trace roda; padrão .cache/playwright-cli.
agentsCHOL_AGENTS_DIRPasta dos agentes (padrão .choliba/agents).
agentsCHOL_SKILLS_DIRPasta das skills (padrão .choliba/skills).
agentsCHOL_MCPS_DIRPasta dos MCPs (padrão .choliba/mcps).
agentsCLAUDE_CODE_OAUTH_TOKENCom CHOL_SANDBOX=docker, token de autenticação do provider correspondente. É uma credencial e nunca aparece em listagens.
agentsCURSOR_API_KEYCom CHOL_SANDBOX=docker, chave de usuário do provider correspondente. É uma credencial e nunca aparece em listagens.
projectsCHOL_GLOBAL_DIRRaiz dos artefatos e, sem CHOL_PROJECTS_DIR, dos projetos (CHOL_GLOBAL_DIR/projects). O setup preenche com .cache/choliba da pasta de trabalho.
projectsCHOL_PROJECTS_DIROnde ficam os projetos, se não em CHOL_GLOBAL_DIR/projects. O setup preenche com projects/ da pasta de trabalho.
projectsCHOL_TICKET_RUNSRaiz opcional de ticket-runs/; sem ela, usa CHOL_PROJECTS_DIR.
sandboxCHOL_SANDBOXOnde o provider roda: local (padrão) ou docker; veja Sandbox.
sandboxCHOL_SANDBOX_IMAGEImagem do sandbox Docker (padrão choliba-agent).
sandboxCHOL_NETWORKRede do container: isolated (padrão) ou host; veja Rede.
cholibaCHOL_COLORSCores no formato papel.nome=cor, separadas por vírgula. Papéis: providers, agents, states, gates, labels. Aceita as 16 cores do terminal; os padrões estão comentados no .env criado pelo setup.