Comandos da CLI
Referência completa dos comandos kasy.
Criação e execução
| Comando | Descrição |
|---|---|
kasy prepare | Prepara a máquina: instala e loga só o que o backend escolhido precisa |
kasy prepare --backend supabase | Só Supabase CLI + login (sem Firebase/gcloud). Use firebase, api ou all conforme o caso |
kasy new | Cria novo app (pergunta backend, features, credenciais) |
kasy new --lang pt | Cria app em português (também salva o idioma da CLI) |
kasy new --backend firebase --with revenuecat,sentry | Pula prompts com flags |
kasy new --configure-later | Rápido + não conecta Firebase/Supabase agora (app em modo preview; rode kasy backend depois) |
kasy backend | Conecta o projeto Firebase/Supabase real num app criado com configure later (mesma lógica do kasy new, sem recriar a pasta) |
kasy setup | Alias de kasy new |
kasy run | Roda com credenciais completas (recomendado) |
kasy run --ios | Simulador iOS |
kasy run --android | Emulador Android |
kasy run --web | Web em localhost:5555 |
kasy run --web --open-browser | Abre no navegador padrão quando o Flutter ficar pronto |
kasy run --web --open-browser --fresh | Abre no navegador padrão e limpa storage de dev (localStorage, sessionStorage, IndexedDB) |
kasy run --web --open | Web em janela Chrome isolada do Flutter |
kasy clear-web | Limpa storage de dev no localhost (app web já rodando) |
kasy run --prod | Config de produção |
kasy run --raw | Saída bruta sem spinner |
kasy reset | Desinstala e reinstala (testa primeira abertura) |
kasy reset --web | Limpa storage web no navegador padrão |
kasy reset --ios / --android | Device específico |
kasy reset --no-reinstall | Só desinstala |
Features
| Comando | Descrição |
|---|---|
kasy add <feature> | Liga feature (ex.: revenuecat, ads, ai_chat) |
kasy add --list | Lista features e quais estão ativas |
kasy remove <feature> | Remove feature e desfaz todas as alterações |
kasy remove <feature> --yes | Remove sem confirmar |
kasy update | Mostra features com atualizações disponíveis |
kasy update <feature> | Atualiza feature específica |
kasy update backend | Sincroniza migrations SQL/Edge Functions (Supabase) ou Cloud Functions/firestore.rules (Firebase) que faltam no projeto |
kasy update web | Atualiza os scripts do kit no web/index.html (limpeza de storage, tema antes do boot, altura no Safari iOS) sem tocar no título/favicon/splash |
kasy features | Lista backends e features disponíveis |
kasy kanban list | Lê o Kanban do projeto (Firebase/Supabase); usado principalmente pela IA via MCP |
kasy kanban create-task --title "..." --column-id <id> | Cria tarefa no board sem abrir o app |
Deploy e diagnóstico
| Comando | Firebase | Supabase | API REST |
|---|---|---|---|
kasy deploy | Sobe Functions + Firestore rules + Storage rules | Sobe Edge Functions + migrations + secrets | Não se aplica (você faz deploy do seu servidor) |
kasy check | Valida secrets + APNs Key + IAM | Valida secrets + Edge Functions + JWT | Valida só config local |
kasy check --fix | Tenta corrigir automaticamente | Tenta corrigir automaticamente | Sem efeito (não há servidor remoto) |
kasy doctor | Verifica ambiente, dependências e estado do projeto (todos os backends) | ||
kasy status | Resumo do projeto: backend, features ativas e credenciais pendentes | ||
kasy validate | Valida combinações de backend/features (todos os backends) |
Configuração e versão
| Comando | Descrição |
|---|---|
kasy configure | Configura App Store ID e outras credenciais do projeto |
kasy configure --status | Só lista o que falta configurar (sem wizard) |
kasy configure --set SENTRY_DSN=https://... --set RC_TEST_KEY=test_... --yes | Preenche credenciais sem wizard (repetível; MCP) |
kasy fix pub-get | Roda flutter pub get no projeto |
kasy fix pods | Roda pod install no iOS (Mac) |
kasy fix clean | Limpa cache Flutter/Xcode + flutter clean |
kasy release-version | Atualiza app_latest_version no Firebase Remote Config |
kasy release-version -v 1.4.0 | Versão direta |
kasy release-version -v 1.4.0 -f --yes | Obrigatória, sem confirmação (CI) |
kasy apple-web | Configura login Apple na web (Firebase ou Supabase) |
kasy facebook | Configura login Facebook (nativo + backend) |
kasy phone | Liga o login por telefone (OTP) e habilita o provedor no Firebase/Supabase (--check mostra o que falta, --off esconde o botão) |
kasy notifications text | Edita textos das notificações locais do projeto |
kasy docs | Exibe documentação no terminal |
Personalização visual
| Comando | Descrição |
|---|---|
kasy icon --image <caminho.png> | Troca ícone do app (iOS + Android) e regenera assets |
kasy rename "Novo Nome" | Troca o nome do app em todo o projeto; --bundle-id auto troca também o ID (só antes de publicar). Ver Nome do app |
kasy color | Troca a cor primária da marca (colors.dart) |
kasy color --primary-light "#0553B1" --primary-dark "#2563EB" | Define cores sem wizard |
kasy splash --light <caminho.png> --dark <caminho.png> | Troca logos da splash (modo claro + escuro) e regenera assets |
kasy favicon --image <caminho.png> | Troca favicon e ícone PWA da web |
Publicação: iOS (Mac)
| Comando | Descrição |
|---|---|
kasy ios configure | Wizard: Key ID, Issuer ID, .p8 da Apple (uma vez) |
kasy ios configure --api-key ... --issuer-id ... --p8 <caminho> | Mesma coisa sem wizard (MCP) |
kasy ios release | Incrementa build + gera IPA + envia ao App Store Connect |
kasy ios build | Só gera o IPA (sem enviar) |
kasy ios clean | Limpa cache Flutter/Xcode após erro de DerivedData |
kasy ios release --version-name 1.0.2 | Muda versão visível e incrementa build |
kasy ios release --no-bump | Não incrementa o build (uso raro) |
Publicação: Android
| Comando | Descrição |
|---|---|
kasy android configure | Wizard: salva android/key.properties (keystore) |
kasy android configure --keystore <caminho.jks> --store-password ... | Mesma coisa sem wizard (MCP) |
kasy android release | Gera AAB release e abre Play Console |
kasy android build-aab | Só gera o AAB (sem abrir console) |
kasy android build-apk-signed | Gera APK release assinado (sideload, lojas alternativas) |
kasy android build-apk | Gera APK de debug, sem assinatura (teste rápido) |
Domínio web (Firebase Auth)
| Comando | Descrição |
|---|---|
kasy domain list | Lista domínios autorizados no Firebase Auth |
kasy domain add app.seudominio.com | Autoriza domínio custom na web |
kasy domain remove app.seudominio.com | Remove domínio da lista |
Publicação: Codemagic (sem Mac)
| Comando | Descrição |
|---|---|
kasy codemagic configure | Salva token + App ID + branch (uma vez) |
kasy codemagic configure --token ... --app-id ... | Mesma coisa sem wizard (MCP) |
kasy codemagic release | Dispara build iOS + Android na nuvem |
kasy codemagic release --ios | Só iOS |
kasy codemagic release --android | Só Android |
kasy codemagic status <buildId> | Consulta status do build |
CLI em si
| Comando | Descrição |
|---|---|
kasy version / kasy --version | Versão instalada |
kasy language | Troca o idioma da CLI (mesmo seletor da primeira vez) |
kasy language en | Define inglês sem abrir o seletor |
kasy license | Ver ou trocar a chave de ativação da CLI. Regras em Chave e ativação |
kasy license --show | Mostra chave mascarada |
kasy mcp setup | Instala o kasy-mcp e escreve o mcp.json do seu editor (ver MCP) |
kasy upgrade | Atualiza a CLI para a versão mais recente |
kasy uninstall | Desinstala a CLI |
kasy help / kasy --help | Ajuda |
Instalação da CLI
npm install -g kasy-cli
# ou sem instalar:
npx kasy-cli newLicença
Grátis (sem chave): prepare, mcp, run, reset, clear-web, doctor, status, features, fix, configure, splash, icon, favicon, apple-web, facebook, release-version, kanban, version, language, license, help, uninstall
Exige chave válida: new, backend, add, remove, deploy, check, validate, docs, ios, android, codemagic, notifications, color, domain. Depois que você teve uma chave válida uma vez, esses comandos continuam funcionando no projeto já criado, mesmo com o plano vencido.
Exige chave e plano ativo: new, update, upgrade. Criar projeto novo e atualizar dependem da assinatura em dia; o que já está criado continua rodando sozinho (Firebase/Supabase), sem depender da CLI.
Atualizado em 03/11/2026