felipe.Abrir meu painel ↗01 · Pegue sua chave
Abra o modo desenvolvedor no painel e obtenha uma chave de API autorizada. Não é a senha da sua conta. O acesso depende das condições do seu plano.
FLIP IA STUDIO CLI · VERSÃO 0.1.0Seu projeto.
Seu projeto.
Seu terminal.
Seu próximo passo.
Converse com a API do Felipe IA Studio e trabalhe com arquivos no computador. A CLI propõe, mostra o que vai mudar e pede sua aprovação antes de gravar ou executar verificações.
Instalar a CLI ↓Node.js 22+ · Linux, macOS e Windows¹ · Chave de API necessária.
flip · primeira conversa
# Use sua chave do painel $ flip login Chave validada e salva cifrada. $ flip models Modelos disponíveis para sua API $ flip ask "Explique esta função" \ --file src/soma.js $ flip agent "Revise a função de soma" \ --workspace ./meu-projeto Ações locais só após sua aprovação.
Exemplo de comandos. Resultados dependem do modelo e do acesso.
Instale. Conecte. Comece.
Instale Node.js 22 ou superior com npm. Depois, use o pacote desta versão:
npm install --global https://felipeiastudio.online/downloads/felipe-ia-studio-cli-0.1.0.tgzBaixar .tgz · Conferir SHA-256
O pacote não possui scripts de instalação ou dependências de execução. Se preferir baixar primeiro, instale com npm install --global ./felipe-ia-studio-cli-0.1.0.tgz. Não é necessário usar sudo; configure uma instalação de Node no seu usuário se houver erro de permissão.
02 · Faça login
Execute flip login. A chave é validada no catálogo e cifrada com uma senha local de pelo menos 12 caracteres. A CLI não usa o login Google do navegador.
03 · Consulte o acesso
Use flip models e flip status. Depois, experimente um pedido pequeno. O consumo de geração é cobrado pela API conforme sua conta.
Da pergunta à alteração revisável.
| Comando | Para que serve |
|---|---|
flip ask "pedido" | Uma resposta, com streaming ou --no-stream. |
flip chat | Conversa em memória. /new limpa e /exit encerra. |
flip ask "revise" --file src/app.js | Envio explícito de até quatro arquivos de texto dentro do projeto, com limite de contexto. |
flip agent "tarefa" | O modelo propõe leitura, busca e edições; você aprova cada ação. |
flip agent "revise e teste" --allow-run | Permite propostas de verificadores suportados. Cada execução ainda exige confirmação. |
flip undo ID | Restaura uma alteração registrada se o arquivo não mudou desde então. |
flip init | Cria um .flipignore para excluir conteúdo do projeto, após confirmação. |
flip doctor | Mostra versão, endereço e estado da configuração sem revelar a chave. |
flip logout | Remove a credencial salva na máquina. Revogação da chave é feita no painel. |
Use --model ID para selecionar um modelo exato do catálogo, --workspace PASTA para escolher o projeto e --max-steps N para limitar o agente a 1–20 consultas (padrão: 6). Não há reenvio automático de geração interrompida.
Ações que você consegue conferir.
Antes de enviar
Arquivos sensíveis conhecidos e links simbólicos são bloqueados. Um detector local bloqueia padrões comuns de segredos. Use também .flipignore e confira o conteúdo autorizado.
Antes de gravar
Você vê uma prévia das diferenças e digita a aprovação do caminho exato. A CLI registra a versão anterior e recusa restaurar sobre alterações posteriores.
Antes de executar
Testes são opcionais e restritos aos verificadores suportados. Eles executam código com as permissões do seu usuário, podem alterar arquivos e acessar a rede. Não são um sandbox.
As proteções da CLI não substituem revisão de código nem isolamento do sistema operacional. O detector não identifica todo tipo de segredo. Trabalhe em um repositório versionado e só aprove arquivos e testes que você conhece.
Para automação, sem chave no histórico.
Em um ambiente de CI ou terminal configurado, forneça FLIP_API_KEY pelo gerenciador de segredos. Você pode enviar uma pergunta pela entrada padrão e receber JSON:
# FLIP_API_KEY já deve estar no ambiente seguro printf '%s' 'Explique o resultado desta etapa.' | flip ask --json # URL alternativa, quando sua equipe fornece outra API compatível flip login --base-url https://sua-api.example # Não coloque chaves nos argumentos, no repositório ou no prompt.
O modo de agente não aprova ações automaticamente em CI. FLIP_PASSPHRASE pode abrir o cofre local em ambientes controlados; prefira uma chave de ambiente fornecida pelo mecanismo de segredos do CI.
Antes de instalar, vale saber.
Isso roda a IA offline no meu computador?
Não. As respostas usam a API configurada. Leitura, prévia e alterações de arquivos acontecem localmente. A CLI não instala modelos ou transforma sua máquina em servidor.
O consumo está separado do meu plano?
A CLI envia chamadas autenticadas à API. A autorização, os modelos, a franquia e a cobrança são os da sua conta de API. Confira as condições vigentes no painel. Uma tarefa de agente pode exigir várias consultas.
Posso usar qualquer modelo?
Use os identificadores que sua API retorna em flip models. O agente precisa de um modelo capaz de seguir o protocolo JSON; se a resposta não for válida, a CLI para em vez de executar texto livre. Não há garantia de conclusão de toda tarefa.
A CLI salva minha conversa?
O chat fica apenas em memória durante a sessão. Há registro local de metadados de ações, sem conteúdo das perguntas. Alterações aprovadas guardam cópias locais do código para restauração. O tratamento de dados pela API segue as condições do serviço.
Como atualizo ou removo?
Instale uma versão nova pelo link oficial quando disponível. Para remover o executável, use npm uninstall --global felipe-ia-studio-cli. Isso não apaga automaticamente sua configuração ou cópias de código; confira a pasta da CLI antes de removê-las.
¹ Quais sistemas foram testados?
A implementação usa Node.js e foi testada em Linux. Conversa e arquivos foram preparados para macOS e Windows, mas ainda precisam de testes nesses sistemas. No Windows, a CLI não executa npm.cmd; use node --test ou rode npm test manualmente.