Primeiros passos
Instale o choliba, crie a pasta de trabalho e leve o primeiro pedido até o código implementado, com ticket e testes no caminho.
Dependências
- bash
curl -fsSL https://bun.com/install | bash - bash
bunx playwright install chromium Para rodar agentes, o CLI de um provider instalado e autenticado:
- Provider suportados: claudecodex (rode
codex logindepois de instalar) cursor-agent
- Provider suportados: claudecodex (rode
Instalação
Atenção
Durante a fase de desenvolvimento, choliba não será publicado como package no npm
A versão de desenvolvimento é v0.0.1-dev
Para instalar
mkdir dev-tools && cd dev-tools
echo '{ "name": "dev-tools", "private": true }' > package.json
curl -LO https://github.com/choliba/choliba/releases/download/v0.0.1-dev/choliba-0.0.1-dev.tgz
curl -LO https://github.com/choliba/choliba/releases/download/v0.0.1-dev/choliba-0.0.1-dev.tgz.sha256
sha256sum -c choliba-0.0.1-dev.tgz.sha256
bun add --trust ./choliba-0.0.1-dev.tgzNão instale se
sha256sum -cnão terminar emOK.O
--trustdeixa o Bun rodar opostinstalldo pacote, que já executacholiba setup.Se você rodou sem
--trust:
bun choliba setupSem sobrescrever o que já existe, ele:
cria
.choliba/agents/.choliba/skills/.choliba/mcps/projects/
cria em
app/exemplo/(uma página só)cria em
projects/exemplo/um projeto que aponta para app/exemplo/copia de um template
.env.example,.gitignore,.editorconfig(largura e indentação, que o Prettier lê) e os arquivos do Prettier e do ESLint, e cria o.envinicial comCHOL_GLOBAL_DIRapontando para.cache/cholibaeCHOL_PROJECTS_DIRparaprojects/, os dois da própria pasta de trabalho;lista
cholibaemtrustedDependenciesdopackage.json, para que instalações futuras rodem o setup de novo sem pedir--trust;aponta o VS Code para o schema do
agent.yaml(.vscode/settings.json);liga o autocomplete do bash (veja Autocomplete).
A pasta de trabalho
choliba roda sempre numa pasta de trabalho: a pasta, subindo a partir de onde o comando é chamado, cujo package.json depende de choliba. A instalação começa criando um na pasta nova, porque o Bun também procura o package.json subindo de pasta. É nela que ficam o .env, os agentes (.choliba/agents/), as skills (.choliba/skills/) e os MCPs (.choliba/mcps/) usados pelos comandos. Rodar choliba de qualquer subpasta dela funciona do mesmo jeito. Essas três pastas são o padrão; CHOL_AGENTS_DIR, CHOL_SKILLS_DIR e CHOL_MCPS_DIR no .env apontam para outras.
Atualização
Dentro da pasta de trabalho:
bun choliba updateEle compara a versão instalada com a da release, baixa o pacote novo, confere o SHA-256, instala e mostra as novidades desde a versão que você tinha. Para só ver se há versão nova, sem instalar: bun choliba update --check. Detalhes em choliba update.
Sem o comando (numa instalação anterior a ele), o passo a passo é este. A URL da release não muda a cada versão, então, para o Bun baixar o pacote novo (e não reaproveitar o do cache), remova e instale de novo:
bun remove choliba
rm -f choliba-0.0.1-dev.tgz choliba-0.0.1-dev.tgz.sha256
curl -LO https://github.com/choliba/choliba/releases/download/v0.0.1-dev/choliba-0.0.1-dev.tgz
curl -LO https://github.com/choliba/choliba/releases/download/v0.0.1-dev/choliba-0.0.1-dev.tgz.sha256
sha256sum -c choliba-0.0.1-dev.tgz.sha256
bun add --trust ./choliba-0.0.1-dev.tgzPara conferir qual versão ficou instalada, rode
bun choliba --versione compare com o título da última atualização nas notas da release.
A saída tem este formato:
$ bun choliba --version
choliba 0.0.1-dev.16+1a2b3c4