Carvalhocode (fork do OpenClaude)

Carvalhocode é um fork privado do OpenClaude personalizado para fornecer integrações diretas com Python e R, além de scaffolding para Playwright, Flutter, análise e testes automatizados.

Início rápido:

• Executar exemplo Python: python src/integrations/python/example_script.py
• Executar exemplo R: Rscript src/integrations/r/runner.R
• Executar testes Playwright: cd tools/playwright && npm ci && npx playwright install --with-deps && npm test
• Flutter: adicione um projeto Flutter em flutter-app/ e execute flutter test em CI ou localmente

Remotos do repositório:

• upstream: https://github.com/fabianocarcosta/carvalhocode (não alterado)
• fork: https://github.com/fabianocarcosta/openclaude (backup)
• carvalhocode: https://github.com/fabianocarcosta/carvalhocode (este repositório)

Por que Carvalhocode

• Use uma única CLI para várias APIs de modelos e backends locais
• Salve perfis de provedores com /provider
• Compatível com OpenAI-compatible, Gemini, GitHub Models, Codex, Ollama, Atomic Chat, etc.
• Workflows integrados: bash, ferramentas de arquivo, grep/glob, agentes, tarefas, MCP e ferramentas web
• Extensão VS Code incluída para integração e tema

Instalação

npm install -g @fabianocarcosta/carvalhocode

Se o instalador indicar que ripgrep não foi encontrado, instale ripgrep no sistema e confirme rg --version antes de iniciar Carvalhocode.

Executando

carvalhocode

Dentro do Carvalhocode:

• execute /provider para configurar provedores
• execute /onboard-github para onboarding de GitHub Models

Dependências de sistema

Para integrações pesadas (OCR, Tika, Camelot, navegadores headless), execute:

scripts/install_system_deps.sh

O que você precisa ter no computador

• Node.js 20 ou superior
• npm para instalação e publicação
• Bun para o build local e scripts de desenvolvimento
• ripgrep (rg) para as buscas internas da CLI
• Python 3.12+ com venv e pip
• R + Rscript
• Flutter SDK, se você for usar os exemplos e os fluxos mobile
• Git, se for contribuir ou enviar mudanças para o GitHub

Verificação rápida

node -v
bun --version
npm --version
rg --version
python3 --version
Rscript --version
flutter --version

Desenvolvimento local

• Python: use .venv e instale requirements.txt (e requirements-optional.txt para recursos avançados)
• JS: npm ci ou bun install
• Flutter: instale Flutter SDK localmente para builds multiplataforma

Referência das funções e trilhas

Veja o inventário completo de funções antigas e novas em docs/recent-work-inventory.md.