Saltar para o conteúdo principal
A CometAPI CLI é uma ferramenta oficial de linha de comando para interagir com a plataforma CometAPI. Ela oferece suporte a chat com múltiplos modelos (streaming e REPL), busca de modelos, consultas de saldo e uso, navegação de logs e gerenciamento de conta — tudo pelo terminal. Comece pela página do pacote no PyPI se quiser o comando de instalação mais recente, metadados do pacote e a versão de lançamento em um só lugar.
A CometAPI CLI está em beta. Espere pequenas mudanças nos comandos e na experiência de uso enquanto a interface da CLI se estabiliza.

​
Recursos

  • Chat com múltiplos modelos com streaming e REPL interativo
  • Busca e listagem de modelos
  • Saldo da conta e estatísticas de uso
  • Navegação de logs de uso com filtros e exportação em CSV
  • Logs de tarefas assíncronas (Suno, Midjourney, Kling e outros)
  • Saída em vários formatos: tabela, JSON, YAML, CSV, Markdown
  • Configuração baseada em TOML com assistente de configuração
  • Conclusão automática para shell em Bash, Zsh e Fish
  • Design amigável para agentes com saída JSON estruturada e códigos de saída determinísticos

​
Pré-requisitos

​
Instalação

Use a página do pacote no PyPI como referência principal de instalação e, em seguida, escolha um dos métodos abaixo para instalar a CLI: 
pip install cometapi-cli
Verifique a instalação: 
cometapi --version

​
Início rápido

1

Execute o assistente de configuração

O assistente interativo armazena sua chave de API e o token de acesso opcional em um arquivo de configuração local:
cometapi init
O assistente solicita:
2

Converse com um modelo

Envie uma única mensagem com saída em streaming:
cometapi chat "Explain quantum computing in one sentence"
Substitua o modelo padrão:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

Pesquise modelos disponíveis

Liste modelos que correspondem a uma palavra-chave:
cometapi models --search gemini --limit 10
4

Verifique seu saldo

Veja o saldo da sua conta:
cometapi balance
Mostre a visualização de faturamento da chave de API atual:
cometapi balance --source key
5

Execute diagnósticos

Verifique se a CLI consegue se conectar à CometAPI:
cometapi doctor

​
Sessão de chat interativa

Execute cometapi chat sem argumentos para entrar no REPL de chat com múltiplas interações: 
cometapi chat
Comandos do REPL:
ComandoDescrição
/modelAlterna o modelo ativo
/systemDefine ou altera o prompt do sistema
/clearLimpa o histórico da conversa
/historyMostra o histórico da conversa
/saveSalva a conversa em um arquivo
/tokensMostra o uso de tokens da sessão
/helpLista todos os comandos do REPL
/exitSai do REPL

​
Integração com agentes

A CLI foi projetada para uso por agentes de codificação com IA e scripts de automação:
  • Todos os comandos de dados oferecem suporte a --json para saída estruturada e legível por máquina
  • Códigos de saída determinísticos: 0 (sucesso), 64 (configuração ausente), 77 (erro de autenticação), 69 (serviço indisponível)
  • Erros vão para stderr, dados vão para stdout
  • Consulte a referência completa de comandos para opções por comando