Grok CLI: assistente inteligente de IA no terminal

Grok O CLI é um assistente de IA de terminal de código aberto desenvolvido com base no modelo Grok-3 da xAI. Ele permite que os usuários realizem a manipulação de arquivos, a edição de códigos e a automação de tarefas a partir da linha de comando por meio da interação com a linguagem natural. Os usuários não precisam digitar comandos complexos, basta usar a linguagem cotidiana para descrever as necessidades, e o Grok CLI poderá selecionar ferramentas e executar tarefas de forma inteligente. O projeto é mantido pela equipe superagent-ai, hospedado no GitHub, e oferece suporte a instalações globais e configurações personalizadas para desenvolvedores, equipe de operações e usuários que precisam de um terminal eficiente. O código segue a licença MIT e a contribuição da comunidade é livre.

Lista de funções

• Interação de linguagem natural: ao interagir com o terminal por meio do diálogo cotidiano, a CLI do Grok entende a intenção do usuário e executa as ações de acordo.
• Operações inteligentes de arquivos: visualize, crie e edite arquivos automaticamente, ofereça suporte ao processamento em lote e a operações complexas de arquivos.
• Integração do comando Bash: simplifique as operações do terminal executando comandos do shell diretamente na caixa de diálogo.
• Seleção automática de ferramentas: de acordo com as necessidades do usuário, a IA seleciona de forma inteligente a ferramenta adequada para concluir a tarefa.
• Interface interativa: crie uma bela interface de terminal com base no Ink para aprimorar a experiência do usuário.
• Configuração personalizada: suporte por meio de .grok/GROK.md O arquivo define regras de comportamento específicas do projeto.
• Geração e edição de código: gere automaticamente arquivos de código (por exemplo, TypeScript) e siga o estilo de código do projeto.
• Gerenciamento de projetos: suporte para visualização da estrutura de diretórios, execução de testes, execução de lint e outras tarefas de desenvolvimento.

Usando a Ajuda

Processo de instalação

A CLI do Grok é fácil de instalar e oferece suporte à instalação global via npm. Aqui estão as etapas detalhadas:

1. Garantir o meio ambiente
   Certifique-se de ter o Node.js (versão recomendada 16 ou superior) e o npm instalados em seu sistema. Isso pode ser verificado com o seguinte comando:

   node -v
   npm -v
   

2. Instalar a CLI do Grok globalmente
   Abra um terminal e execute o seguinte comando:

   npm i -g @vibe-kit/grok-cli
   

   Depois de instalada, a CLI do Grok pode ser usada em qualquer diretório.

3. Verificar a instalação
   Digite o seguinte comando para verificar se a instalação foi bem-sucedida:

   grok --version
   

   Se o número da versão for retornado, a instalação foi bem-sucedida.

4. Configuração de chaves de API (opcional)
   Alguns recursos podem exigir uma chave de API para o xAI. Depois de obter a chave, execute-a:

   grok config set api-key <你的密钥>
   

   A chave é armazenada localmente para que a CLI do Grok chame o modelo Grok-3.

Uso

O núcleo da CLI do Grok é interagir com o terminal por meio de linguagem natural. Uma vez iniciado, você pode inserir diretamente comandos semelhantes a conversas cotidianas, e a IA os analisará e executará. Veja abaixo um fluxo detalhado das principais funções:

1. interação de linguagem natural

Inicie a CLI do Grok e execute-a:

grok

Quando você entrar no modo de interação, insira o requisito diretamente. Exemplo:

• Digite "Show the contents of package.json" e a CLI do Grok fará algo parecido com isto cat package.json e retorna o resultado.
• Digite "create a hello.js file, write to console.log('Hello World')" e a CLI do Grok criará automaticamente o arquivo e escreverá o código.

2. manipulação inteligente de arquivos

A CLI do Grok suporta uma variedade de operações de arquivo adequadas para gerenciar rapidamente os arquivos de projeto. Por exemplo:

• Ver documentoDigite "View the contents of src/index.ts" e a CLI do Grok exibirá o conteúdo do arquivo.
• Criação de documentosDigite "create a new utils.ts file containing an addition function" (criar um novo arquivo utils.ts contendo uma função de adição) e a CLI do Grok gerará o arquivo e escreverá o código, por exemplo:

  /** Add two numbers */
  export function add(a: number, b: number): number {
  return a + b;
  }
  

• Substituição de lotesDigite "Replace oldFunction with newFunction in all JS files" (Substituir oldFunction por newFunction em todos os arquivos JS) e a CLI do Grok percorrerá o diretório e concluirá a substituição.

3. integração do comando Bash

A CLI do Grok oferece suporte à execução direta de comandos do shell. Por exemplo:

• Digite "run npm install" e a CLI do Grok executará o arquivo npm install e exibir os resultados.
• Digite "show current directory structure" (mostrar estrutura de diretório atual) e a CLI do Grok executará algo parecido com isto tree talvez ls -R que retorna a árvore de diretórios.

4. seleção automática de ferramentas

A CLI do Grok seleciona de forma inteligente as ferramentas com base na tarefa. Por exemplo, digite "executar testes e mostrar resultados" e ele reconhecerá automaticamente as estruturas de teste em seu projeto (como Jest ou Mocha) e as executará! npm test.

5. configuração personalizada

A CLI do Grok oferece suporte a regras personalizadas no nível do projeto. Criar uma .grok/GROK.md arquivo, escrevendo instruções, por exemplo:

# Custom Instructions for Grok CLI
- Always use TypeScript for new code files.
- Use functional components with hooks for React.
- Add JSDoc comments for public functions.

A CLI do Grok carrega automaticamente essas regras no diretório do projeto. Por exemplo, ao gerar componentes React, os componentes de função são usados preferencialmente aos componentes de classe.

6. desenvolvimento de suporte à missão

A CLI do Grok é adequada para que os desenvolvedores executem tarefas comuns. Por exemplo:

• Executar linterDigite "run lint check" e a CLI do Grok executará o npm run lint.
• Verificação de tipoDigite "Check TypeScript type" e a CLI do Grok será executada npm run typecheck.
• Construção do projetoDigite "build project" e a CLI do Grok executará o projeto npm run build.

advertência

• requisito de redeAlgumas funções exigem rede para chamar o modelo Grok-3.
• Problemas de competênciaVerifique se você tem permissões de leitura e gravação nos arquivos e diretórios, caso contrário, a operação poderá falhar.
• Registro de depuraçãoSe tiver problemas, você pode executar grok --debug Veja os registros detalhados.

Ao fazer isso, os usuários podem começar a usar rapidamente a CLI do Grok e concluir com eficiência as tarefas do terminal usando a linguagem natural. [](https://github.com/superagent-ai/grok-cli)

cenário do aplicativo

1. Codificação diária para desenvolvedores
   Os desenvolvedores podem criar e editar rapidamente arquivos de código, executar testes ou criar projetos em linguagem natural a partir do terminal. Por exemplo, ao desenvolver um projeto React, digite "Criar um novo componente React em TypeScript" e a CLI do Grok gerará um arquivo de código que esteja em conformidade com as regras do projeto.
2. Automação de tarefas de O&M
   Os administradores de sistema podem usar a CLI do Grok para realizar operações de arquivos em massa ou executar scripts de shell. Por exemplo, digite "Localizar todos os arquivos de registro e excluir arquivos com mais de 30 dias" e a CLI do Grok gerará e executará automaticamente os comandos apropriados.
3. Aprendizado e experimentação
   Os iniciantes podem aprender os comandos do terminal com a CLI do Grok. Por exemplo, se você digitar "Explain the ls command" (Explique o comando ls), a CLI do Grok retornará a descrição do comando e mostrará como usá-lo.
4. Contribuição para projetos de código aberto
   Os colaboradores podem usar a CLI do Grok para navegar e modificar rapidamente o código do projeto de código aberto. Por exemplo, digite "encontrar todos os comentários TODO" e a CLI do Grok examinará o código e listará os locais relevantes.

QA

1. A CLI do Grok exige uma chave de API xAI?
   Alguns recursos exigem uma chave de API para chamar os modelos do Grok-3, mas a funcionalidade básica pode ser executada localmente. As chaves podem ser obtidas e configuradas no site da xAI.
2. Como posso personalizar o comportamento da CLI do Grok em meu projeto?
   No diretório raiz do projeto, crie o arquivo .grok/GROK.md e escrever regras como "Sempre use TypeScript", que são carregadas automaticamente pela CLI do Grok.
3. Quais sistemas operacionais são compatíveis com a CLI do Grok?
   A CLI do Grok é compatível com Windows, macOS e Linux, e está pronta para ser executada com o Node.js instalado.
4. É possível usar a CLI do Grok off-line?
   Alguns recursos (como operações de arquivos e comandos locais) são suportados off-line, mas os recursos orientados por IA exigem uma conexão com a Internet.