xodex-cli 0.1.9

CLI Agente de IA (OpenAI | Gemini | Grok) para terminal, com contexto de projeto e ferramentas de dev.

Xodex – DeepSeek (default) + OpenAI/Gemini/Grok

Xodex é um agente de programação para terminal. DeepSeek é o provedor padrão (economy), mas você também pode usar OpenAI, Gemini ou Grok.

🔐 Primeira execução: o Xodex abre um wizard interativo para escolher provedor, modelo e salvar sua API key com segurança (Keychain/Keyring).
Reabra quando quiser com: xodex setup.

---

🚀 Instalação sem Python (binários)

Baixe o binário na página de Releases (ou use latest):

Linux (x86_64)

curl -L -o xodex https://github.com/thiagovt-dev/xodex/releases/latest/download/xodex-linux-amd64
chmod +x xodex
./xodex

macOS

# Intel
curl -L -o xodex https://github.com/thiagovt-dev/xodex/releases/latest/download/xodex-macos-x64
# Apple Silicon
# curl -L -o xodex https://github.com/thiagovt-dev/xodex/releases/latest/download/xodex-macos-arm64

chmod +x xodex
# Se o Gatekeeper bloquear:
# xattr -d com.apple.quarantine xodex
./xodex

Windows

1. Baixe xodex-windows-x64.exe em Releases (versão latest).
2. Execute: xodex-windows-x64.exe

---

🍺 Homebrew (em breve)

Quando o tap estiver publicado:

brew tap thiagovt-dev/xodex
brew install xodex
xodex

---

📦 NPM (em breve)

Quando o wrapper estiver publicado:

npm i -g xodex-cli
xodex

---

💻 Instalação para dev (Python)

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
pip install -e .
xodex

Dica: se usar .env em dev, o wizard não aparece quando as variáveis já estão no ambiente.

---

🧠 Providers & modelos (defaults)

• DeepSeek (default) → deepseek-reasoner (V3.1 Thinking Mode)
  Alternativa: deepseek-chat (V3.1 Non-thinking)
• OpenAI → gpt-5
• Gemini → gemini-2.5-flash
• Grok (xAI) → grok-4-0709

Troque depois com xodex setup.

O Xodex mostra o modelo ativo no prompt do REPL:
assistente [deepseek-reasoner]> ...

---

⌨️ Comandos do REPL

• /q — sair
• /clear — limpar histórico
• /help — ajuda
• /read <path> — ler arquivo
• /write <path> — escrever arquivo (finalize com linha EOF)
• /run <cmd> — executar comando com confirmação
• /agent — alterna modo agente (ações pedem permissão)
• /ask <texto> — pergunta ao modelo sem usar histórico
• Git: /status | /branches | /checkout <branch> | /new-branch <name> | /commit "mensagem"

---

🤝 Contribuindo

Contribuições são muito bem-vindas! Este projeto está aberto para a comunidade e aceita:

• 🐛 Reportes de bugs
• ✨ Sugestões de novas funcionalidades
• 📝 Melhorias na documentação
• 🔧 Novos providers de IA
• 🧪 Testes e melhorias de qualidade

Como contribuir:

1. Fork o repositório
2. Clone seu fork: git clone https://github.com/SEU_USUARIO/xodex.git
3. Crie uma branch: git checkout -b feature/nova-funcionalidade
4. Faça suas alterações seguindo o guia de contribuição
5. Teste suas mudanças: ruff check . && black --check . && pytest
6. Commit com Conventional Commits: git commit -m "feat: adiciona novo provider"
7. Push para sua branch: git push origin feature/nova-funcionalidade
8. Abra um Pull Request

Padrões de código:

• Formatação: Black
• Lint: Ruff
• Testes: Pytest
• Commits: Conventional Commits

📖 Leia mais: CONTRIBUTING.md | Código de Conduta | Política de Segurança

---

⚠️ Aviso Legal

Xodex não é afiliado a OpenAI, Google, xAI, DeepSeek ou qualquer outro provedor de IA. Este é um projeto independente desenvolvido pela comunidade.

---

Créditos

Xodex foi desenvolvido por Thiago Vasconcelos, um desenvolvedor Full-Stack apaixonado por criar soluções inovadoras.