🤖 CLAW AGENT

Seu Assistente de IA para Código no VS Code

✨ Analise, refatore, documente e teste código com IA — sem sair do VS Code.

📋 Índice

• Recursos
• Início Rápido (2 minutos)
• 6 Comandos Principais
• Provedores de IA
• Compatibilidade
• Views no Sidebar
• Configuração
• Compilação e Build
• Troubleshooting
• Privacidade
• Contribuir
• Licença

🎯 Recursos

🚀 Início Rápido (2 minutos)

1️⃣ Instalar

# Opção A: Via VSIX
code --install-extension claw-agent-1.2.0.vsix

# Opção B: VS Code → Extensions → ⋮ → Install from VSIX

2️⃣ Configurar Provedor de IA

Escolha uma das opções e configure a variável de ambiente:

# OpenAI (chatGPT) — Recomendado
export OPENAI_API_KEY="sk-..."

# Google Gemini — Grátis
export GOOGLE_API_KEY="AIzaSy..."

# Anthropic Claude — Premium
export ANTHROPIC_API_KEY="sk-ant-..."

# Ollama — Local, 100% grátis
export OLLAMA_ENDPOINT="http://localhost:11434"

# LocalAI — Local, 100% grátis
export LOCALAI_ENDPOINT="http://localhost:8080"

💡 Dica: Adicione ao ~/.bashrc (ou ~/.zshrc) para persistir entre sessões.

3️⃣ Usar

Abra qualquer arquivo de código → clique com botão direito → escolha um comando CLAW Agent.

📊 6 Comandos Principais

Todos os comandos também estão disponíveis em: Ctrl+Shift+P → digite "CLAW Agent"

🤖 Provedores de IA

* Plano gratuito com limite de requisições diárias
** Performance depende do hardware local

Obtendo Chaves de API

🖥️ Compatibilidade Cross-Platform

Destaques da v1.2.0

• ✅ Configuração via interface do VS Code (Settings UI)
• ✅ Modelos de IA atualizados (GPT-4o, Gemini 2.5 Pro, Claude Sonnet 5)
• ✅ Renderização segura com CSP no painel de resultados
• ✅ Comandos de menu mais robustos (mapeamento por label completo)
• ✅ Integração com clawagent.* settings do VS Code

🌳 Views no Sidebar

📊 Configurações (no Explorer)

Acesse: clique em CLAW Agent - Configurações no Explorer

📊 STATUS E INFORMAÇÕES   ⚡ COMANDOS RÁPIDOS   ⚙️ CONFIGURAÇÕES
├─ Status: 🟢 Ativo       ├─ 🔍 Analisar        ├─ Provedor de IA
├─ Provedor: OpenAI       ├─ ✨ Melhorar        ├─ Timeout
├─ Versão: 1.2.0          ├─ 📚 Documentar      ├─ Idioma
└─ Arquivo Atual          ├─ 🧪 Testar          ├─ Profundidade
                           ├─ ❓ Perguntar       └─ ⚙️ Todas
                           └─ 📋 Status

📂 Sugestões do CLAW (Activity Bar)

Clique no ícone 🤖 na Activity Bar para sugestões contextuais baseadas no arquivo aberto.

⚙️ Configuração

Via VS Code Settings UI

1. Ctrl+Shift+P → "CLAW Agent: Abrir Configurações"
2. Ou: Ctrl+, → Pesquise por "clawagent"

Propriedades disponíveis

📦 Compilação e Build

Pré-requisitos

node >= 18
npm >= 9

Compilar

# Instalar dependências
npm install

# Compilar TypeScript
npm run compile

# Modo watch (desenvolvimento)
npm run watch

# Build de produção (TypeScript + Webpack)
npm run compile:prod

# Empacotar VSIX
npm run package

# Verificar o que vai no pacote
npm run package:dry

Build em Container

O projeto suporta 3 métodos de build em container:

• Distrobox (Ubuntu): ./build-distrobox.sh
• Podman (Alpine, mais leve): ./build-podman.sh
• Docker Compose (padrão indústria): docker-compose up --build

🐛 Troubleshooting

🔐 Privacidade e Segurança

• ✅ Nenhuma chave de API armazenada no repositório
• ✅ Secrets via variáveis de ambiente ou VS Code Secrets
• ✅ Suporte 100% offline (Ollama, LocalAI)
• ✅ Código sanitizado — sem vazamento de chaves em logs
• ✅ Content-Security-Policy no painel webview (previne XSS)
• ✅ MIT License — uso comercial permitido

🤝 Contribuir

Contribuições são bem-vindas! Siga estes passos:

1. Faça um fork do repositório
2. Crie uma branch: git checkout -b feature/sua-feature
3. Commit: git commit -m 'feat: adiciona nova funcionalidade'
4. Push: git push origin feature/sua-feature
5. Abra um Pull Request

Reportar bugs: Abrir issue

📄 Licença

MIT © 2026 Rafael Batista

Você é livre para usar, modificar e distribuir esta extensão para qualquer fim, incluindo comercial.