Apps e parx
parx
O agente de programação do Parallel, no seu terminal. Mac, Windows e Linux, em oito idiomas.
parx é um agente que trabalha na pasta do teu projeto a partir do terminal: lê o código, altera-o, executa comandos e mostra-te cada mudança. A IA do Parallel roda nos nossos servidores e cada tarefa é cobrada em Ações da tua conta.
Nunca usaste o terminal? Começa pelo guia do terminal para iniciantes.
O que precisas
- Mac, Windows (PowerShell ou cmd) ou Linux.
- Node.js 20 ou mais recente.
- Uma conta Parallel com Ações.
Iniciar sessão
parx loginparx pergunta-te como queres entrar:
- Pelo navegador (recomendado). parx abre getparallel.net com um código de uso único, por exemplo
BCDF-GHJK. Confirmas que o código e o nome do computador são teus e clicas em Aprovar. O código expira em 10 minutos. - Com uma chave de API. Crias-na no Parallel, em Configurações → parx no terminal, e colas. A chave é mostrada apenas uma vez. Serve para servidores ou integração contínua: também pode ser fornecida na variável
PARALLEL_API_KEYsem guardar nada no disco. - Sem navegador nesse computador (por exemplo, via SSH). parx mostra um link curto, o código e um QR para abrir no celular.
A sessão do navegador dura 90 dias e renova-se com o uso.
parx conta: quem és, teu plano, tuas Ações e como entraste.parx logout: encerra a sessão neste computador.parx logout --todas: encerra a sessão em todos os teus terminais. As chaves de API continuam ativas: podem ser revogadas em Configurações → parx no terminal, onde também vês cada terminal conectado.
Como usar
Vai para a pasta do teu projeto e escreve:
parxAbre-se uma sessão: escreve o que queres e parx faz. Para uma tarefa única, sem sessão:
parx "adiciona validação ao formulário de contato"Ao terminar cada tarefa, diz-te quanto gastou: ✓ Feito · N Ações · N s · X Ações disponíveis.
Modos
| Modo | O que faz |
|---|---|
| preguntar (padrão) | Pede permissão para cada comando e cada alteração de arquivo, mostrando a mudança. Respondes 1 sim, 2 sim e não perguntar mais sobre isso na sessão, 3 não. |
| auto | Trabalha sozinho dentro do projeto. Shift+Tab muda o modo durante a sessão. Comandos de risco e o que está fora do projeto continuam a pedir permissão. |
| leer | Apenas lê. Não altera nada. |
Modelos
Escolhes quanto pensa a IA do Parallel em cada tarefa:
| Modelo | Para que serve |
|---|---|
| rapido (Rápido) | Tarefas simples. Gasta menos Ações. |
| potente (Potente) | Padrão. Para quase tudo. |
| maximo (Máximo) | Tarefas mais difíceis. É o que mais Ações gasta. |
O que nunca toca
Em qualquer modo, parx não lê nem escreve arquivos de credenciais: .env (exceto modelos como .env.example), chaves SSH, .npmrc, .ssh, .aws, .kube, .docker, .vercel, .supabase, keychains e arquivos .pem.
Comandos de risco perguntam sempre, mesmo no modo auto: sudo, rm -rf, git push, git reset --hard, publicar pacotes, instalações globais, curl | sh, ssh, deploys e similares.
Se não gostares de algo, /deshacer reverte a última alteração de arquivo.
Instruções do projeto
Se o teu projeto tem um arquivo PARALLEL.md ou AGENTS.md, parx lê-o ao começar: coloca aí como testar, o estilo ou o que não deve tocar.
Quanto custa
Cada tarefa é um passo e é cobrada uma vez, em Ações, conforme o que realmente custou (mínimo 1). Antes de cada chamada verifica o teu saldo: se ficares sem Ações, parx avisa e leva-te a comprar mais ou melhorar de plano.
Todos os comandos estão em Comandos de parx.