Cosmic CLI

O que é o Cosmic CLI?

O Cosmic CLI é uma interface de linha de comando com IA que traz as capacidades da plataforma Cosmic para um fluxo de trabalho no terminal. Ele foi projetado para ajudá-lo a criar aplicativos, gerenciar conteúdo, implantar em produção e executar ou orquestrar agentes de IA sem sair da linha de comando.

Em vez de depender apenas do painel do Cosmic, o CLI oferece modos de comando interativos e assistidos por IA para realizar tarefas de múltiplos passos — como gerar um app pronto para produção com configuração de repositório e implantação — por meio de comandos em linguagem natural e fluxos de trabalho estruturados.

Principais Recursos

• Instalação em um comando e uso global do CLI: Instale o CLI globalmente (com npm ou bun) para executar capacidades do Cosmic a partir do seu terminal.
• Navegação interativa no workspace do shell: Inicie uma sessão interativa com histórico de comandos, prompts conscientes do workspace, navegação estilo sistema de arquivos e capacidade de executar comandos do sistema com um prefixo configurado.
• Modos de chat com IA com contexto de conteúdo: Use modos conversacionais que incluem consciência total do contexto do seu conteúdo, com flags para fornecer contexto adicional para operações de IA.
• Geração de apps em linguagem natural com setup de repo: Descreva o que deseja construir; o CLI gera um aplicativo pronto para produção conectado ao seu projeto Cosmic e prepara um repositório GitHub para implantação.
• Atualizações de código com IA a partir do seu repositório: Conecte-se a um repositório existente para que um Code Agent analise seu código, crie uma branch de feature e faça commits com base nas suas instruções.
• Automação de implantação no Vercel: Implante diretamente no Vercel com gerenciamento de variáveis de ambiente, tratamento de domínios personalizados, implantações de preview e releases de produção, incluindo streaming de logs em tempo real.
• Controle de CLI para agentes de IA e workflows: Crie, execute e gerencie os três tipos de agentes pelo terminal, incluindo captura de sessões de autenticação no navegador para Computer Use Agents, aprovação de operações pendentes e encadeamento de agentes em AI Workflows com monitoramento passo a passo.
• Gerenciamento de repositórios e variáveis de ambiente: Gerencie repositórios GitHub, branches, pull requests, variáveis de ambiente e domínios personalizados, configurando automaticamente as configurações locais de ambiente com as chaves de API Cosmic corretas (incluindo variantes específicas para Next.js).
• Múltiplos provedores de modelos de IA: Selecione entre vários provedores de IA e defina um modelo padrão (exemplos incluem Claude via Anthropic, GPT via OpenAI e Gemini via Google).

Como Usar o Cosmic CLI

1. Instale o CLI globalmente usando o método de sua preferência (o artigo menciona npm e bun).
2. Autentique-se usando um dos dois métodos suportados: autenticação de usuário para acesso completo ao painel ou autenticação por chave de bucket para acesso rápido a um bucket específico.
3. Inicie uma sessão interativa ou use comandos diretos para trabalhar no seu workspace Cosmic.
4. Crie ou atualize projetos usando comandos em linguagem natural para geração de apps ou conectando a um repositório Git existente para alterações de código assistidas por IA.
5. Implante no Vercel pelo CLI, incluindo implantações de preview e releases de produção, com configuração de variáveis de ambiente e domínios gerenciada pelo CLI.
6. Execute agentes de IA e workflows pelo terminal, monitorando o progresso de execução e aprovando operações pendentes quando necessário.

Casos de Uso

• Da ideia a um app ao vivo (incluindo conteúdo e implantação): Gere um aplicativo pronto para produção conectado ao seu projeto Cosmic, com um repositório GitHub e uma implantação ao vivo no Vercel criada por meio de um fluxo end-to-end único.
• Mantenha e escale operações de conteúdo: Use criação de conteúdo com IA para produzir objetos estruturados corretamente no seu bucket Cosmic, e use o modo de chat de conteúdo interativo para tarefas contínuas de conteúdo.
• Modifique um codebase existente com mudanças prontas para review: Aponte o CLI para o seu repositório para que o Code Agent crie uma branch de feature e faça commits com base em instruções, abra um pull request e implante um preview.
• Atualize configuração de ambiente e implante de forma confiável: Use o CLI para gerenciar variáveis de ambiente e domínios personalizados durante implantações, com streaming de logs para rastrear o progresso.
• Coordene tarefas de IA de múltiplos passos pelo terminal: Execute os tipos de agentes suportados e encadeie-os em AI Workflows, revisando o progresso de cada passo e cancelando execuções quando necessário.

FAQ

• O Cosmic CLI exige o uso do painel Cosmic? Não. O CLI foi projetado para trazer as capacidades do Cosmic ao seu terminal, incluindo gerenciamento de conteúdo, criação de apps, implantação e orquestração de agentes.

• Como o CLI lida com autenticação? O CLI suporta dois métodos: autenticação de usuário (acesso completo ao painel) e autenticação por chave de bucket (acesso rápido a um bucket específico sem login).

• Que tipos de interações com IA estão disponíveis no CLI? O CLI inclui modos de chat com IA com contexto de conteúdo e suporta agentes de IA e Workflows de IA que podem ser controlados pelo terminal.

• O CLI pode implantar no Vercel? Sim. O CLI inclui integração nativa com Vercel para gerenciamento de variáveis de ambiente, implantações de preview, lançamentos de produção, domínios personalizados e streaming de logs em tempo real.

• Há limites baseados em planos para o uso do CLI? O artigo afirma que o Cosmic CLI respeita os mesmos limites baseados em planos do painel, incluindo limites para Agentes de IA.

Alternativas

• Integração via API (escreva seus próprios scripts): Se preferir controle total, você pode criar seus próprios scripts de terminal em torno das APIs do Cosmic para operações de conteúdo, automação de repositórios e implantações; isso troca conveniência por personalização.
• Assistentes de codificação com IA de uso geral no seu IDE: Assistentes focados em IDE podem ajudar com alterações de código, mas podem não cobrir diretamente a estruturação de conteúdo específica do Cosmic, preparação de repositórios e fluxos de implantação no Vercel.
• Ferramentas de automação de workflows (plataformas CI/CD e orquestração): Ferramentas que orquestram jobs e implantações podem automatizar partes do workflow, mas você precisaria de etapas adicionais para gerar conteúdo estruturado do Cosmic e coordenar interações de agentes.
• Gerenciamento de conteúdo e apps com foco no painel: Permanecer no painel Cosmic é uma alternativa quando você quer ferramentas visuais, embora não forneça o shell interativo via terminal, automação de repo/implantação ou workflows de agentes controlados pelo CLI descritos aqui.