🚀 Niteo Code CLI - Agente de Codificação Azure OpenAI

Cliente standalone para Azure OpenAI - Zero dependências externas

O Niteo Code CLI é um agente de codificação inteligente que funciona como um assistente completo para desenvolvedores. Não requer código-fonte externo - tudo está incluído no pacote npm.

✨ Características

• 🎯 100% Independente - Não depende de códigos externos
• 🤖 Agente Completo - Ler, escrever, analisar e executar código
• ⚡ Zero configuração - Setup em 1 comando
• 🔒 Seguro - API keys armazenadas localmente
• 🌐 Azure nativo - Otimizado para Azure OpenAI
• 📦 Leve - Apenas Node.js built-ins, sem dependências
• 🛠️ Developer-friendly - Perfeito para automação
• 🔄 Dual Mode - Suporta modelos Codex (completions) e GPT (chat)

🚀 Instalação Rápida

# Instalar globalmente
npm install -g niteo-code

# Configurar (interativo)
niteo-code --setup

# Usar - Modo Agente Interativo
niteo-code

# Ou pergunta direta
niteo-code "Como criar uma API REST em Python?"

🤖 Modo Agente

O CLI funciona como um agente de codificação completo com comandos especializados:

💻 Você: help

📋 Comandos:
  ls [dir]      - Listar arquivos
  read <file>   - Ler arquivo
  write <file>  - Escrever arquivo
  analyze <file> - Analisar código
  exec <task>   - Executar tarefa
  context       - Ver contexto
  clear         - Limpar tela
  exit          - Sair

Exemplos de Uso

# Listar arquivos do projeto
💻 Você: ls

# Ler um arquivo
💻 Você: read main.py

# Analisar código
💻 Você: analyze main.py

# Executar tarefa de codificação
💻 Você: exec "Criar função para validar email"

# Ver contexto do projeto
💻 Você: context

# Escrever arquivo (interativo)
💻 Você: write utils.py

📋 Pré-requisitos

• Node.js 16+
• Conta Azure com Azure OpenAI habilitado
• API Key e Endpoint do Azure OpenAI

🔧 Configuração

Setup Interativo (Recomendado)

niteo-code --setup

O setup guiará você pelos seguintes passos:

1. API Key - Obtida no portal Azure
2. Base URL - Endpoint do seu recurso Azure OpenAI
3. Modelo - Nome do modelo deployado (ex: gpt-4o-mini)
4. API Version - Versão da API (padrão: 2025-04-01-preview)

Obter Credenciais Azure

1. Acesse Portal Azure
2. Vá para seu recurso Azure OpenAI
3. Em Keys and Endpoint:
   • Copie a Key 1 (API Key)
   • Copie o Endpoint (Base URL)
4. Em Model deployments:
   • Anote o nome do modelo deployado

🎯 Uso

Comandos Básicos

# Modo agente interativo (recomendado)
niteo-code

# Pergunta direta
niteo-code "Como funciona async/await em JavaScript?"

# Configuração
niteo-code --setup

# Versão
niteo-code --version

# Ajuda
niteo-code --help

Modo Agente Interativo

Quando executado sem argumentos, niteo-code entra em modo agente:

niteo-code
```bash
niteo-code

🚀 Niteo Code CLI - Agente de Codificação

✅ Agente Ativo
Modelo: gpt-4o-mini
Projeto: meu-projeto
Arquivos: 15
Linguagens: Python, JavaScript

💻 Você: 

Comandos disponíveis no modo agente:

• ls [dir] - Listar arquivos do projeto
• read <arquivo> - Ler e exibir conteúdo de arquivo
• write <arquivo> - Escrever novo arquivo (modo interativo)
• analyze <arquivo> - Analisar código com IA
• exec <tarefa> - Executar tarefa de codificação
• context - Ver contexto detalhado do projeto
• help - Mostrar todos os comandos
• clear - Limpar tela
• exit - Sair

Exemplos Práticos

# Modo agente (experiência completa)
niteo-code
💻 Você: ls src/
💻 Você: read main.py
💻 Você: analyze main.py
💻 Você: exec "Adicionar validação de entrada"
💻 Você: write tests/test_main.py
💻 Você: exit

# Perguntas diretas
niteo-code "Explique este erro de TypeScript"
niteo-code "Como otimizar esta query SQL?"

# Desenvolvimento
niteo-code "Script para backup automático no Azure"
niteo-code "Como configurar CI/CD com GitHub Actions?"

🎯 Modelos Suportados

Modelos de Codificação (Completions)

• codex-mini - Rápido e eficiente para código
• code-davinci-002 - Avançado para análises complexas

Modelos de Chat (Conversação)

• gpt-4o - Mais avançado
• gpt-4o-mini - Rápido e econômico
• gpt-4 - Balanceado
• gpt-35-turbo - Básico

O CLI detecta automaticamente o tipo de modelo e ajusta o formato da requisição.

🔍 Troubleshooting

❌ "Configuração não encontrada"

# Solução
niteo-code --setup

❌ "API Error 401: Unauthorized"

• Verifique sua API key no portal Azure
• Execute niteo-code --setup para reconfigurar

❌ "API Error 404: Resource not found"

• Verifique o endpoint e modelo no portal Azure
• Confirme se o modelo está deployado

❌ "Raw mode is not supported"

• Use terminal independente (não integrado do VS Code)
• Linux: Terminal padrão, gnome-terminal
• Windows: CMD, PowerShell
• macOS: Terminal.app, iTerm2

📁 Estrutura de Configuração

~/.codex/
├── config.json    # Configuração principal
└── env.sh         # Variáveis de ambiente

config.json

{
  "model": "gpt-4o-mini",
  "provider": "azure",
  "providers": {
    "azure": {
      "name": "AzureOpenAI",
      "baseURL": "https://seu-recurso.openai.azure.com/openai",
      "envKey": "AZURE_OPENAI_API_KEY"
    }
  }
}

env.sh

export AZURE_OPENAI_API_KEY="sua-api-key"
export AZURE_BASE_URL="https://seu-recurso.openai.azure.com"
export AZURE_OPENAI_API_VERSION="2025-04-01-preview"
export AZURE_MODEL="gpt-4o-mini"

🔐 Segurança

• ✅ API keys armazenadas localmente em ~/.codex/
• ✅ Permissões restritas nos arquivos de configuração
• ✅ Não envia dados para terceiros além da Azure
• ⚠️ Não commitar arquivos ~/.codex/ no git

🌟 Funcionalidades

| Funcionalidade | Status | Descrição | |---------------|--------|-----------| | ✅ Azure OpenAI | Pronto | Cliente nativo para Azure OpenAI | | ✅ Setup interativo | Pronto | Configuração guiada em 1 comando | | ✅ Zero dependências | Pronto | Apenas Node.js built-ins | | ✅ Modo silencioso | Pronto | Ideal para scripts e automação | | ✅ Teste de conexão | Pronto | Validação de configuração | | ✅ Cross-platform | Pronto | Linux, macOS, Windows |

📖 Documentação Adicional

• Configuração Detalhada - Guia completo de setup
• Portal Azure OpenAI
• Documentação Azure OpenAI

🔄 Atualizações

# Verificar versão atual
niteo-code --help

# Atualizar para última versão
npm update -g niteo-code

# Reinstalar se necessário
npm uninstall -g niteo-code
npm install -g niteo-code

🤝 Contribuições

Contribuições são bem-vindas!

📄 Licença

MIT License - veja LICENSE para detalhes.

✨ Niteo Code CLI - Simplificando IA para desenvolvedores

Criado com ❤️ para a comunidade de desenvolvedores.