primocode 7.3.0 → 7.4.1

package/README.md

@@ -1,16 +1,35 @@
-# PrimoCode v7.1.0
+# PrimoCode v7.4.0
 
 Agente de engenharia brasileiro para o terminal, no estilo Claude Code.
-Cria arquivos de verdade, roda comandos, abre o navegador — e lembra do que fez
-entre uma sessão e outra.
+Cria arquivos de verdade, roda comandos, **controla o navegador e o desktop** —
+e lembra do que fez entre uma sessão e outra.
 
 ```
-    ╷
-  ╭─┴─╮   PrimoCode
-  │◕ ◕│   v7.1.0
-  ╰───╯   projeto: jogo-de-carro
+    ╭◠╮
+  ╭─┴─┴─╮
+ ◖┫ ● ● ┣◗     PrimoCode  v7.4.0
+  ┃  ‿  ┃      projeto: jogo-de-carro
+  ╰──┬──╯
+   ╰─┴─╯
 ```
 
+Personalize o mascote (`primo`, `fox`, `cat`) e o nome com que ele te chama —
+veja `/mascot` e `/name`.
+
+## Por que trocar o Claude Code pelo PrimoCode
+
+| | PrimoCode | Assistentes gringos de terminal |
+|---|---|---|
+| **Idioma** | Nasceu em português do Brasil — fala como gente, não como manual traduzido | Inglês primeiro; PT-BR é tradução |
+| **Chave de API** | **Não precisa.** Instala e usa — o modelo já vem hospedado | Exige conta e chave de API própria |
+| **Controla a máquina** | Navegador (Chrome real) **e** desktop: mouse, teclado, tela | Em geral só arquivos e shell |
+| **Memória** | Cada projeto lembra o que foi feito, entre sessões | Esquece ao fechar |
+| **Instalação** | Node puro, **zero dependências** — segundos | Pacotes e dependências |
+| **Cara própria** | Mascote, nome e temas que você escolhe | Fixo |
+| **Custo** | Roda em modelos rápidos e baratos (Groq/Llama) | Cobrança por token da API |
+
+Em uma frase: **é o poder de um agente de código no terminal, em português, controlando o seu computador de verdade — sem você precisar configurar chave de API nenhuma.**
+
 ## Instalação
 
 ```bash
@@ -67,18 +86,53 @@ Alterne com `/mode primocode` ou `/mode chat`.
 |---|---|
 | `write_file` | Cria arquivo novo ou reescreve inteiro |
 | `edit_file` | **Troca um trecho exato.** É o que evita reescrever 800 linhas pra mudar uma |
+| `multi_edit` | Várias trocas no mesmo arquivo, em ordem, tudo-ou-nada |
 | `read_file` | Lê o arquivo, com `offset`/`limit` para os grandes |
 | `glob` | Acha arquivos por padrão: `**/*.js`, `src/**/*.{ts,tsx}` |
 | `grep` | Procura texto/regex **dentro** dos arquivos, com arquivo e linha |
 | `list_dir` | Árvore de arquivos |
 | `run_shell` | Roda comando na pasta do projeto |
-| `open_in_browser` | Abre HTML ou URL |
+| `run_in_new_terminal` | Sobe servidor de dev / watch em outro terminal |
+| `write_todos` | Plano de tarefas da sessão, visível no terminal |
+| `open_in_browser` | Abre HTML ou URL no navegador padrão |
 | `spawn_agent` | Delega uma sub-tarefa a outro agente |
 
 O `edit_file` é rigoroso de propósito: se o trecho não existe, ou aparece mais
 de uma vez sem `replace_all`, ele **recusa** e devolve as linhas reais do
 arquivo — em vez de editar o lugar errado.
 
+### Controle de navegador e desktop
+
+O agente não só abre o navegador — ele **age** nele, e no computador também.
+
+| Tool | Para quê |
+|---|---|
+| `browser_open` | Abre a página num Chrome controlado (CDP) e espera carregar |
+| `browser_click` | Clica por texto visível, seletor CSS ou coordenada |
+| `browser_type` | Digita num campo (por seletor) ou onde o foco estiver |
+| `browser_key` | Enter, Tab, Escape, setas… |
+| `browser_read` | Lê o texto visível da página (conferir o resultado) |
+| `browser_screenshot` | Print da página, salvo no projeto |
+| `browser_scroll` / `browser_wait` / `browser_eval` | Rolar, esperar seletor, rodar JS |
+| `desktop_screenshot` | Print da tela inteira do usuário |
+| `desktop_click` / `desktop_move` / `desktop_drag` | Mouse na tela real |
+| `desktop_type` / `desktop_key` / `desktop_scroll` | Teclado e rolagem do sistema |
+| `desktop_size` | Resolução da tela, para calcular coordenadas |
+
+O navegador roda via Chrome DevTools Protocol (sem dependências npm).
+
+**Requisitos por plataforma** (as ferramentas dão um erro claro se faltar algo):
+
+| | Navegador | Desktop (mouse/teclado) | Screenshot da tela |
+|---|---|---|---|
+| **Windows** | Chrome ou Edge | nativo (PowerShell) | nativo (PowerShell) |
+| **macOS** | Chrome/Chromium | `brew install cliclick` | nativo (`screencapture`) |
+| **Linux** | Chrome/Chromium | `apt install xdotool` | `scrot`, `gnome-screenshot`, `spectacle`, `maim` ou ImageMagick |
+
+Variáveis de ambiente úteis:
+- `CHROME_PATH` / `PRIMOCODE_CHROME` — aponta para um Chrome fora do caminho padrão
+- `PRIMOCODE_BROWSER_HEADLESS=1` — roda o navegador sem janela (CI/servidor)
+
 ## Subagentes
 
 Para tarefas com partes independentes, o agente delega:
@@ -143,6 +197,9 @@ primocode -f app.js "onde está o bug?" # com arquivo anexado
 | `/run <comando>` | Executa no shell, dentro da pasta do projeto |
 | `/open <arquivo\|url>` | Abre no navegador |
 | `/status` | Health check do servidor |
+| `/name <nome>` | Como o Primo te chama na saudação |
+| `/mascot primo\|fox\|cat` | Escolhe o mascote (mostra os três) |
+| `/config` | Mostra suas preferências e onde ficam salvas |
 | `/clear` · `/cls` | Limpa conversa / tela |
 | `/uninstall` | Remove o PrimoCode (seus projetos ficam) |
 | `/exit` | Sair |

package/bin/primocode.js

@@ -13,7 +13,8 @@ const fs = require('fs');
 const os = require('os');
 
 const pkg = require('../package.json');
-const { c, welcomeBox, Spinner } = require('../lib/ui');
+const ui = require('../lib/ui');
+const { c, welcomeBox, Spinner } = ui;
 const api = require('../lib/api');
 const tools = require('../lib/tools');
 const cfg = require('../lib/config');
@@ -35,6 +36,7 @@ const HELP = `
 ${c.bold('Comandos')}
   ${c.brand('/project')}              lista projetos ou muda: /project <nome>
   ${c.brand('/mode')}                 alterna: /mode primocode|chat
+  ${c.brand('/model')}                alterna: /model main|fast
   ${c.brand('/attach')} <arquivo>     anexa arquivo ao próximo pedido
   ${c.brand('/files')}                lista anexos   ${c.brand('/detach')} remove
   ${c.brand('/tree')} [n]             árvore do projeto
@@ -42,6 +44,9 @@ ${c.bold('Comandos')}
   ${c.brand('/run')} <comando>        executa no shell do projeto
   ${c.brand('/open')} <arquivo|url>   abre no navegador
   ${c.brand('/status')}               checa o servidor
+  ${c.brand('/name')} <nome>          como o Primo te chama
+  ${c.brand('/mascot')} <estilo>      mascote: primo|fox|cat
+  ${c.brand('/config')}               mostra suas preferências
   ${c.brand('/clear')}                limpa a conversa   ${c.brand('/cls')} limpa a tela
   ${c.brand('/uninstall')}            remove o PrimoCode
   ${c.brand('/exit')}                 sair
@@ -178,7 +183,7 @@ async function runChat(promptForModel, userTextForMemory) {
             model: state.config.model,
             token: state.config.token,
         }, (evt) => {
-            if (evt.erro) { if (!started) sp.stop(); console.log(c.err(`\nerro: ${evt.erro}`)); return; }
+            if (evt.erro) { if (!started) sp.stop(); console.log('\n' + c.err(ui.friendlyError(evt.erro))); return; }
             if (evt.delta) {
                 if (!started) { sp.stop(); process.stdout.write('\n'); started = true; }
                 text += evt.delta;
@@ -188,7 +193,7 @@ async function runChat(promptForModel, userTextForMemory) {
         });
     } catch (e) {
         sp.stop();
-        console.log(c.err(`\n${e.message || e}`));
+        console.log('\n' + c.err(ui.friendlyError(e)));
         return;
     }
     sp.stop();
@@ -294,6 +299,47 @@ async function handleSlash(text) {
             break;
         }
 
+        case 'name': {
+            if (!rest) { console.log(c.muted(`  Nome atual: ${state.config.userName || '(nenhum)'}`)); break; }
+            state.config.userName = rest;
+            cfg.saveConfig({ userName: rest });
+            console.log(c.ok(`Feito! Vou te chamar de ${rest}.`));
+            break;
+        }
+
+        case 'mascot': {
+            const estilos = ['primo', 'fox', 'cat'];
+            const m = rest.toLowerCase();
+            if (!m) {
+                console.log('');
+                for (const e of estilos) {
+                    console.log(`  ${e === state.config.mascot ? c.brand('● ' + e) : c.muted('○ ' + e)}`);
+                    ui.mascot(e).forEach((l) => console.log('   ' + l));
+                    console.log('');
+                }
+                console.log(c.muted('  Escolha: /mascot <estilo>'));
+                break;
+            }
+            if (!estilos.includes(m)) { console.log(c.err(`Uso: /mascot ${estilos.join('|')}`)); break; }
+            state.config.mascot = m;
+            cfg.saveConfig({ mascot: m });
+            console.log('');
+            ui.mascot(m).forEach((l) => console.log('  ' + l));
+            console.log(c.ok(`\nMascote: ${m}`));
+            break;
+        }
+
+        case 'config': {
+            console.log('');
+            console.log(`  ${c.muted('nome')}      ${c.white(state.config.userName || '(nenhum)')}`);
+            console.log(`  ${c.muted('mascote')}   ${c.white(state.config.mascot || 'primo')}`);
+            console.log(`  ${c.muted('modelo')}    ${c.white(state.config.model)}`);
+            console.log(`  ${c.muted('modo')}      ${c.white(state.mode)}`);
+            console.log(`  ${c.muted('servidor')}  ${c.dim(state.config.server)}`);
+            console.log(c.muted(`\n  ${cfg.CONFIG_FILE}`));
+            break;
+        }
+
         case 'clear': state.history = []; console.log(c.ok('Conversa limpa.')); break;
         case 'cls': process.stdout.write('\x1Bc'); break;
 
@@ -346,6 +392,17 @@ async function main() {
 
     const args = process.argv.slice(2);
 
+    // Flags padrão de CLI — funcionam em qualquer máquina, úteis em scripts/CI.
+    if (args[0] === '--version' || args[0] === '-v' || args[0] === '-V') {
+        console.log(`PrimoCode v${VERSION}`);
+        process.exit(0);
+    }
+    if (args[0] === '--help' || args[0] === '-h') {
+        console.log(welcomeBox(VERSION, null, { mascot: state.config.mascot, userName: state.config.userName }));
+        console.log(HELP);
+        process.exit(0);
+    }
+
     // Modo one-shot: primocode "crie um jogo de carro"
     if (args.length && !args[0].startsWith('-')) {
         const fileFlag = args.indexOf('-f');
@@ -373,7 +430,10 @@ async function main() {
         process.exit(0);
     }
 
-    console.log(welcomeBox(VERSION, state.workDir ? shortPath(state.workDir) : null));
+    console.log(welcomeBox(VERSION, state.workDir ? shortPath(state.workDir) : null, {
+        mascot: state.config.mascot,
+        userName: state.config.userName,
+    }));
     rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: makePrompt() });
     rl.prompt();
 
@@ -400,7 +460,7 @@ async function main() {
                 if (isSlash(text)) await handleSlash(text);
                 else await sendPrompt(text);
             } catch (e) {
-                console.log(c.err(`\n${e.message || e}`));
+                console.log('\n' + c.err(ui.friendlyError(e)));
             }
         }
         busy = false;

package/lib/act.js

@@ -10,7 +10,7 @@
 
 'use strict';
 
-const { c, actionHeader, Spinner } = require('./ui');
+const { c, actionHeader, Spinner, friendlyError } = require('./ui');
 const tools = require('./tools');
 const api = require('./api');
 const cfg = require('./config');
@@ -71,6 +71,46 @@ function logResult(kind, result, profundidade) {
         case 'open_in_browser':
             console.log(p + c.muted(result.opener || 'aberto'));
             return;
+        case 'multi_edit': {
+            const delta = result.linhasDepois - result.linhasAntes;
+            const sinal = delta > 0 ? c.ok(`+${delta}`) : delta < 0 ? c.err(`${delta}`) : c.muted('±0');
+            console.log(p + c.muted(`${result.substituicoes} trocas · `) + sinal + c.muted(' linhas'));
+            return;
+        }
+        case 'write_todos': {
+            const marca = { completed: c.ok('✔'), in_progress: c.brand('▶'), pending: c.dim('○') };
+            for (const t of result.todos || []) {
+                const texto = t.status === 'completed' ? c.dim(t.content) : c.white(t.content);
+                console.log(p + `${marca[t.status] || c.dim('○')} ${texto}`);
+            }
+            console.log(p + c.muted(`${result.feitos}/${result.total} concluídas`));
+            return;
+        }
+        case 'browser_open':
+            console.log(p + c.muted(result.url || 'aberto'));
+            return;
+        case 'browser_read':
+            console.log(p + c.muted(`${(result.text || '').length} caracteres lidos da página`));
+            return;
+        case 'browser_screenshot':
+        case 'desktop_screenshot':
+            console.log(p + c.muted(`${result.path} · ${tools.fmtBytes(result.bytes || 0)}`));
+            return;
+        case 'browser_click':
+        case 'browser_type':
+        case 'browser_key':
+        case 'browser_scroll':
+        case 'browser_wait':
+        case 'browser_eval':
+        case 'desktop_click':
+        case 'desktop_move':
+        case 'desktop_drag':
+        case 'desktop_type':
+        case 'desktop_key':
+        case 'desktop_scroll':
+        case 'desktop_size':
+            console.log(p + c.ok('ok') + (result.text || result.tag || result.selector || result.width ? c.muted(' · ' + (result.selector || result.tag || (result.width ? `${result.width}×${result.height}` : ''))) : ''));
+            return;
     }
 }
 
@@ -135,16 +175,18 @@ async function runAct(userPrompt, opts) {
             });
         } catch (e) {
             sp.stop();
-            if (subagent) return { assistantMessage: { role: 'assistant', content: `Subagente falhou: ${e.message || e}` } };
-            console.log(c.err(`\nErro: ${e.message || e}`));
+            const amigavel = friendlyError(e);
+            if (subagent) return { assistantMessage: { role: 'assistant', content: `Subagente falhou: ${amigavel}` } };
+            console.log('\n' + c.err(amigavel));
             throw e;
         }
         sp.stop();
 
         if (streamError) {
-            if (subagent) return { assistantMessage: { role: 'assistant', content: `Subagente falhou: ${streamError}` } };
-            console.log(c.err(`\nErro: ${streamError}`));
-            return { assistantMessage: { role: 'assistant', content: `Erro: ${streamError}` } };
+            const amigavel = friendlyError(streamError);
+            if (subagent) return { assistantMessage: { role: 'assistant', content: `Subagente falhou: ${amigavel}` } };
+            console.log('\n' + c.err(amigavel));
+            return { assistantMessage: { role: 'assistant', content: amigavel } };
         }
 
         // Sem tool_calls: o modelo respondeu e acabou.