OMEGA CLI

OMEGA CLI é uma ferramenta de desenvolvimento assistido executada no terminal. Este repositório reúne o cliente CLI, a interface web e o servidor MCP do projeto.

Instalação

Requer Node.js 22.14 ou posterior (Bun não é necessário). Funciona em Linux, macOS e Windows, x64 e arm64:

npm install -g @omegacli/omega-cli
omega --version

Depois, na pasta do projeto, rode omega, use /chaves para adicionar a chave de um provedor e /modelos para escolher o modelo. Atualização, desinstalação, instruções por sistema operacional e solução de problemas estão em docs/INSTALL.md.

Desenvolvimento

Requisitos: Bun 1.4 ou posterior e Node.js 22 ou posterior (interface web e servidor MCP).

bun install
bun run pack:npm   # gera dist/npm e o pacote .tgz em dist/
bun run e2e:npm    # instala o pacote em um prefixo temporário e testa o comando omega

O OMEGA inicia em modo local e não contata serviços de nuvem automaticamente. Os serviços de nuvem herdados do código de origem (API, OAuth, métricas e downloads em domínios que a ODSI não opera) foram removidos: nenhuma variável os liga.

As dependências internas @omega-ai/sdk e @omega-ai/sandbox-runtime ficam em vendor/, permitindo uma instalação reproduzível sem aliases externos.

Isolamento de credenciais

Processos filhos recebem um ambiente filtrado por padrão. Quando uma integração precisar de uma credencial, use uma exceção mínima:

$env:OMEGA_CLI_SUBPROCESS_ENV_ALLOW="GITHUB_TOKEN"

Separe vários nomes com vírgula. OMEGA_CLI_SUBPROCESS_ENV_SCRUB=false existe apenas como compatibilidade temporária e não é recomendado.

Validação e compilação

bun run typecheck
bun test
bun run build

cd web
npm install
npm run type-check
npm run build

cd ..\mcp-server
npm install
npm run build

O executável principal é gerado em dist/cli.mjs. Para conferir as opções disponíveis:

node dist/cli.mjs --help

Estrutura

• src/: código do CLI e serviços compartilhados
• vendor/: dependências internas preservadas localmente
• web/: interface web em Next.js
• mcp-server/: servidor Model Context Protocol
• scripts/: rotinas de compilação e manutenção
• tests/: testes automatizados

Diagnóstico

Use o diagnóstico seguro para verificar runtime, ferramentas, dependências internas e configuração dos serviços sem iniciar plugins ou servidores MCP:

node dist/cli.mjs doctor
node dist/cli.mjs doctor --json
node dist/cli.mjs doctor --strict

--json serve para CI e automação. --strict também retorna erro quando houver avisos de configuração.

Configuração

Copie .env.example quando precisar definir credenciais locais. Arquivos .env, resultados de compilação, dependências instaladas e caches são ignorados pelo Git.

Licença

Software proprietário da Omega Software. Consulte LICENSE.