primocode 4.3.1 → 7.0.1

package/README.md

@@ -1,146 +1,130 @@
-# PrimoCode v4.1 — Cross-Platform
+# PrimoCode v6.0
 
-Assistente de engenharia com IA multi-agente para terminal.
-**Funciona em: Windows, macOS, Linux e Termux (Android)**
+**AI coding companion** brasileiro no estilo **Claude Code**. CLI interativa minimalista e poderosa, com streaming, comandos slash, suporte a arquivos anexados, execução de shell e conselho multi-agente (Arquiteto → Engenheiro → Revisor).
 
-## 🎯 Missão
+**Novidades v6.0:**
+- 🎨 Interface estilo Claude Code — minimalista e elegante
+- ⚡ Auto-instalação de Node.js quando não detectado (Y/n)
+- 🚀 Pipeline de qualidade máxima com 3 IAs
+- 🛠️ Modo Act com tool-calling nativo (write_file, run_shell, browser_*)
 
-Fazer pessoas comuns poderem tirar suas ideias do papel — mesmo sem saber programação, servidor, dados, DDoS, HTTPS, etc.
+## Instalação rápida
 
-## Funcionalidades
+### Linux / macOS / WSL
 
-- **Pipeline Multi-Agente Oculto**: 5 agentes trabalham em background
-- **Memória de Projetos**: Todos os projetos salvos automaticamente
-- **Mouse Virtual**: Controle do cursor e cliques na interface
-- **Pesquisa Web Oculta**: A IA pesquisa automaticamente para qualidade
-- **Mascote ASCII**: Animações no terminal (idle, thinking, coding, happy)
-- **Nunca Código no CMD**: Sempre salva em arquivo e abre no navegador
+```bash
+curl -fsSL https://raw.githubusercontent.com/ConectaPrimoAI/primocode/main/install.sh | bash
+```
 
-## 📱 Instalação
+### Windows (CMD ou PowerShell)
 
-### Windows
 ```cmd
-npm install -g primocode
-```
-Ou:
-```cmd
-git clone https://github.com/ConectaPrimoAI/primocode.git %USERPROFILE%\.primocode\primocode
-cd %USERPROFILE%\.primocode\primocode
-npm install
-npm link
+curl -fsSL https://raw.githubusercontent.com/ConectaPrimoAI/primocode/main/install.cmd -o install.cmd && install.cmd
 ```
 
-### macOS / Linux
-```bash
-npm install -g primocode
-```
-Ou:
+**Se não tiver Node.js:** O instalador pergunta se deseja instalar automaticamente. Digite `Y` para sim.
+
+### Manual (qualquer SO)
+
 ```bash
-git clone https://github.com/ConectaPrimoAI/primocode.git ~/.primocode/primocode
-cd ~/.primocode/primocode
+git clone https://github.com/ConectaPrimoAI/primocode.git
+cd primocode
 npm install
-npm link
+npm link          # registra 'primocode' globalmente
+primocode
 ```
 
-### Termux (Android) ⭐
-```bash
-# 1. Atualizar pacotes
-pkg update && pkg upgrade
+Requer **Node.js 18.17+**.
 
-# 2. Instalar dependências
-pkg install git nodejs termux-api
+## Uso
 
-# 3. Dar permissão de armazenamento
-termux-setup-storage
+### Modo interativo
 
-# 4. Clonar e instalar
-git clone https://github.com/ConectaPrimoAI/primocode.git ~/primocode
-cd ~/primocode
-npm install
+```bash
+primocode
+```
 
-# 5. Criar link (opcional)
-ln -s $(pwd)/bin/primocode.js $PREFIX/bin/primocode
-chmod +x $PREFIX/bin/primocode
+### Modo one-shot
 
-# 6. Testar
-primocode --version
+```bash
+primocode "escreva um endpoint express /users em node"
+primocode --agent "refatore este código pra funcional"
+primocode -f app.js "por que este código está com bug?"
 ```
 
-**Dica Termux**: Se `npm link` não funcionar, use:
-```bash
-cp bin/primocode.js $PREFIX/bin/primocode
-chmod +x $PREFIX/bin/primocode
+### Comandos slash (dentro do modo interativo)
+
+| Comando | Descrição |
+|---|---|
+| `/help` | Ajuda |
+| `/mode normal\|agent` | Alterna modo de resposta |
+| `/model main\|fast` | main = llama-3.3-70b, fast = llama-3.1-8b |
+| `/attach <arquivo>` | Anexa arquivo ao próximo prompt |
+| `/detach` | Remove anexos |
+| `/files` | Lista anexos |
+| `/tree [profundidade]` | Árvore do diretório |
+| `/read <arquivo>` | Exibe conteúdo |
+| `/write <arquivo>` | Salva a última resposta |
+| `/apply` | Aplica todos os blocos de código com hint `// filename: xxx` |
+| `/run <cmd>` | Executa shell local |
+| `/status` | Health check do server |
+| `/clear` | Limpa histórico |
+| `/cls` | Limpa tela |
+| `/exit` | Sair |
+
+## Configuração
+
+Config em `~/.primocode/config.json`:
+
+```json
+{
+  "server": "https://primocode-server.onrender.com",
+  "model": "main"
+}
 ```
 
-## 🚀 Uso
+Ou por variável de ambiente:
 
 ```bash
-# Interativo
-primocode
+export PRIMOCODE_SERVER="https://primocode-server.onrender.com"
+export PRIMOCODE_MODEL="main"
+```
 
-# One-shot
-primocode "crie um site de portfolio"
+## Modo Agente (conselho de 3 IAs)
 
-# Modo chat
-primocode --chat "explique recursão"
-```
+Ative com `--agent` ou `/mode agent`. Roda 3 chamadas encadeadas:
 
-## 📂 Estrutura de Memória
+1. **Arquiteto** — desenha a estrutura, sem código.
+2. **Engenheiro** — implementa seguindo o plano.
+3. **Revisor** — consolida, corrige, entrega versão final limpa.
 
-### Windows
-```
-C:\primocode\
-├── memory.md
-├── projeto-site\
-│   ├── index.html
-│   └── primocode-site.md
-└── ...
-```
+Cada passo é transmitido em tempo real (streaming).
 
-### macOS / Linux
-```
-~/primocode/
-├── memory.md
-├── projeto-site/
-│   ├── index.html
-│   └── primocode-site.md
-└── ...
-```
+## Modo Act (autônomo com tools)
 
-### Termux (Android)
-```
-/storage/shared/primocode/     ← Acessível pelo gerenciador de arquivos
-├── memory.md
-├── projeto-site/
-│   ├── index.html
-│   └── primocode-site.md
-└── ...
-```
+O modo padrão. A IA pode:
+- Criar/editar arquivos (`write_file`)
+- Ler arquivos (`read_file`)
+- Listar diretórios (`list_dir`)
+- Executar comandos shell (`run_shell`)
+- Abrir terminal novo (`run_in_new_terminal`)
+- Controlar o navegador (`browser_*`)
+- Abrir páginas no browser (`open_in_browser`)
+
+Tudo sem nunca colar código no chat — apenas resultados.
 
-## 📋 Comandos
+## Arquitetura
 
 ```
-/mode Primo Code|Chat    Alterar modo
-/attach <arquivo>        Anexar arquivo
-/app <nome>              Abrir aplicativo
-/terminal                Abrir terminal
-/run <arquivo>           Executar arquivo
-/screenshot              Capturar tela
-/mouse <x> <y>           Mover mouse
-/click <x> <y>           Clicar
-/search <termo>          Pesquisar na web
-/project                 Ver projeto atual
-/projects                Listar projetos
-/clear                   Limpar conversa
-/exit                    Sair
+┌────────────────┐   HTTPS/SSE    ┌───────────────────┐    HTTPS   ┌──────────┐
+│  primocode CLI │ ─────────────► │  primocode-server │ ─────────► │  Groq    │
+│  (seu terminal)│ ◄─────────────  │  (Render)         │ ◄───────── │  API     │
+└────────────────┘   streaming    └───────────────────┘            └──────────┘
 ```
 
-## 🔧 Requisitos Termux
-
-- `termux-api` (para abrir navegador, apps)
-- `termux-setup-storage` (para acessar arquivos)
-- Node.js 18+
+- CLI: zero dependências (só stdlib do Node).
+- Server: Express + `groq-sdk`, streaming SSE.
 
 ## Licença
 
-MIT
+MIT © ConectaPrimoAI