Documentação

Do que você precisa

O SuperDevSpace comanda uma CLI de agente que você já tem. Antes da primeira execução, tenha isto em mãos:

• macOS 13 Ventura ou mais recente em Apple silicon, Windows 10 ou 11 de 64 bits, ou Linux de 64 bits (Ubuntu 22.04+, Debian 12+, Fedora 38+).
• Git e o repositório em que você quer que o time trabalhe, clonado localmente.
• Pelo menos uma CLI de agente instalada e com login feito — Claude Code, OpenAI Codex, Gemini CLI, Aider, Qwen Code, Cursor CLI ou OpenCode. O app verifica quais encontra e mostra o comando de instalação das outras.
• Uma assinatura ou chave de API para essa CLI. Ela fica entre você e o provedor dela; o SuperDevSpace nunca a vê e nunca revende acesso a modelos.

Instalar e entrar

Pegue o instalador na página de download; ela mostra quais versões já saíram. A versão para macOS (Apple silicon) é assinada, notarizada e se atualiza sozinha. O instalador para Windows começa como um beta que ainda não tem assinatura de código, então o SmartScreen pergunta uma vez (Mais informações › Executar assim mesmo). No Linux, use o AppImage (que se atualiza sozinho) ou o .deb / .rpm do seu gerenciador de pacotes. Cada arquivo publicado aparece com o seu SHA-256, para você conferir antes de abrir.

Na primeira execução, o app pede para você criar uma conta ou entrar (e-mail, Google, GitHub ou Apple). Uma conta nova começa um teste Premium de 14 dias, sem cartão. A conta guarda a sua assinatura e a sua lista de dispositivos — nada sobre o seu código.

Sua primeira organização

No SuperDevSpace, cada repositório é uma organização: um time, um quadro e uma memória próprios. O painel de boas-vindas guia você por três passos:

1. Adicione uma organização: dê um nome a ela e aponte para a pasta do repositório.
2. Monte o time: escolha papéis (frontend, backend, QA, revisor, designer e outros), dê um nome a cada agente e, se quiser, instruções extras. Você pode adicionar mais depois.
3. Inicie o gerente. Ele abre como uma sessão real de CLI de agente em uma aba de terminal que você pode ver e na qual pode digitar.

Dê uma diretiva

Diga ao gerente o que você quer em linguagem natural — digite no terminal ou no chat dele, ou dite. O gerente faz o que um líder faria:

1. Abre um sprint e divide a diretiva em tarefas no quadro, cada uma com um briefing curto.
2. Contrata um worker por tarefa. Cada worker é uma sessão de CLI própria, na sua própria aba de terminal, com o seu próprio git worktree no seu próprio branch.
3. Revisa o relatório de cada worker, faz squash-merge do branch na sua linha e pede correções quando algo não está certo.
4. Entrega a você um relatório consolidado no final.

Você pode entrar a qualquer momento: todo agente tem uma visão de chat e o seu terminal real, e cada mudança aparece como um diff ao lado da conversa que a produziu.

Worktrees e o script de setup

Os workers nunca compartilham um checkout. Cada um ganha um git worktree na pasta de dados do próprio app (não dentro do seu repositório), e cada turno concluído vira um commit no branch do worker, então nada fica só numa pasta sem commit.

Um worktree novo tem apenas o que o git rastreia. Se o seu repositório tiver .super/scripts/setup-worktree.sh, o app o executa em cada worktree novo antes de o worker começar, com SUPERDEV_MAIN_REPO apontando para o seu checkout principal. Os submódulos são inicializados para você.

              #!/usr/bin/env bash
set -euo pipefail
# Copy local-only files from the main checkout
cp "$SUPERDEV_MAIN_REPO/.env" .env 2>/dev/null || true
# Install dependencies
pnpm install --frozen-lockfile
            

Aprovações e perguntas

Quando um agente precisa de uma decisão — um pedido de permissão, uma escolha entre duas abordagens — ele pergunta a você em vez de adivinhar. A pergunta aparece no topo do espaço de trabalho e fica lá até você responder.

Um app complementar para o telefone, que mostra o mesmo quadro, os agentes e as perguntas pendentes, está chegando à App Store; hoje ele é um beta por convite.

Corrija uma página web apontando para ela

Abra o dev server do seu app no painel do navegador e escolha um elemento. O Inspector mostra a cadeia de componentes sob o cursor, com o arquivo e a linha de cada um, e envia o elemento, uma captura de tela e a sua observação para um agente. Funciona com Vite, Next.js e sites estáticos.

Escolhendo a CLI

A CLI é escolhida por organização. O Claude Code é o que o app domina hoje — hooks, resume, ferramentas MCP e respostas de permissão. As outras seis iniciam e rodam; o app as marca como experimentais e diz quais extras ainda não estão integrados, em vez de falhar em silêncio.

O que sai da sua máquina

Os agentes rodam como processos locais nos seus repositórios locais. Seu código-fonte, prompts, saída do terminal e caminhos de arquivo nunca são enviados para os nossos servidores. O serviço de conta guarda uma conta, um estado de assinatura e uma lista de dispositivos; a política de privacidade lista cada campo.