Castov

Castov

A Camada de Execução de IA Open-Source e Suíte de Desenvolvimento com Zero Telemetria

Ferramentas locais determinísticas para Claude Desktop, Cursor, Windsurf e LLMs Locais via o Model Context Protocol (MCP) — com suporte de um CLI de alta performance, imagem Docker, extensão de IDE e mais de 63 utilitários de navegador offline-first.

---

⚡ O que é o Castov?

Agentes de IA modernos e fluxos de trabalho de desenvolvimento sofrem com duas falhas críticas:

1. Alucinações de Agentes em Operações Exatas: LLMs frequentemente erram cálculos aritméticos para máscaras de rede CIDR, fusos horários, milissegundos de época e derivações de chaves criptográficas.
2. Vazamento de Dados e Segredos: Enviar logs do sistema, variáveis de ambiente ou tokens para APIs de nuvem de terceiros apresenta riscos de segurança inaceitáveis.

O Castov resolve ambos. Ele atua como uma Camada de Execução in-situ para ambientes de desenvolvimento. Ele fornece utilitários determinísticos, offline e instantâneos diretamente para seu terminal, editor, contêineres Docker e agentes de IA através do Model Context Protocol (MCP).

Tudo roda 100% localmente. Sem análises externas, sem telemetria e zero idas e vindas à nuvem.

---

🤖 Configuração de Agentes de IA (Model Context Protocol - MCP)

O Castov vem com um servidor MCP stdio JSON-RPC 2.0 integrado, de nível de produção, que suporta tanto protocolos de stream Content-Length quanto ndjson.

1. Claude Desktop

Adicione o Castov ao seu claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "castov": {
      "command": "npx",
      "args": ["-y", "castov", "mcp"]
    }
  }
}

2. IDE Cursor e Windsurf

Vá para Configurações → Recursos → Servidores MCP → Adicionar Novo Servidor MCP:

• Nome: castov
• Tipo: command
• Comando: npx -y castov mcp

Alternativamente, adicione ao .cursor/mcp.json do seu projeto:

{
  "mcpServers": {
    "castov": {
      "command": "npx",
      "args": ["-y", "castov", "mcp"]
    }
  }
}

Ferramentas Nativas Expostas aos Agentes (10 Ferramentas — Todas 100% Locais e Somente Leitura)

Ferramenta MCP	Capacidade	Exemplo de Prompt para Agente
castov_port	Identifica serviços em escuta, mapeamentos de protocolo e inspeciona colisão de processos	"Por que a porta 3000 está ocupada e qual serviço a utiliza?"
castov_cidr	Calcula máscaras de sub-rede IPv4, wildcard, broadcast e contagem de hosts utilizáveis	"Calcule o intervalo de IP utilizável e a máscara de sub-rede para 10.240.0.0/22"
castov_detect_id	Decodifica carimbos de tempo de criação embutidos de UUIDv7, ULID, ObjectId, Snowflake	"Quando este ObjectId do MongoDB ou ID Snowflake foi criado?"
castov_timestamp	Conversão bidirecional de época para ISO 8601, UTC e representações localizadas	"Converta 1713456789 para formato UTC humano e ISO"
castov_cron	Analisa agendamentos cron de 5 campos em inglês simples e calcula as próximas 5 execuções	"Explique o cron 0 9 * * 1-5 e mostre as próximas 5 execuções em America/New_York"
castov_timezone	Converte carimbos de tempo entre fusos horários IANA com avisos de transição de horário de verão	"Converta 2026-03-29 14:30 de America/New_York para Europe/Paris"
castov_secret	Gera segredos CSPRNG de 256 bits em Hex, Base64URL, chaves de API e UUIDv7 ordenáveis	"Gere um segredo criptográfico de 256 bits para AUTH_SECRET e JWT_SECRET"
castov_jwt_decode	Decodifica cabeçalhos, payloads e status exp de JWT offline, sem chamadas de rede	"Decodifique este JWT offline e verifique se está expirado"
castov_hash	Calcula digests SHA-256/384/512, SHA-1, MD5 e codificações Base64/Base64URL	"Calcule o digest hex SHA-256 e a codificação Base64URL deste payload de webhook"
castov_scan_secrets	Audita trechos de código, diffs de git ou blocos .env para chaves de API e chaves privadas vazadas	"Verifique este git diff para quaisquer chaves AWS, Stripe ou OpenAI acidentalmente codificadas"

---

📦 Distribuição Multicanal

O Castov está disponível em todos os lugares onde a engenharia moderna acontece:

1. CLI de Terminal (Node.js / npm)

Execute instantaneamente sem instalação:

npx castov --help

Ou instale globalmente:

npm install -g castov
castov --help

2. Contêiner Docker (Docker Hub)

Contêiner Alpine Linux leve (node:20-alpine) executando sob um usuário não-root node:

# Run one-off command
docker run --rm castovdev/castov:latest uuid --v7

# Interactive diagnostic shell
docker run -it --rm castovdev/castov:latest

3. Homebrew Tap (macOS e Linux)

Instale nativamente via Brew:

brew tap castovdev/castov
brew install castov

# Verify installation
castov --version

4. Extensões para VS Code, Cursor e Windsurf

Instale a extensão oficial diretamente no seu editor:

• VS Code Marketplace: Pesquise por Castov ou instale Castov.castov-vscode
• Open VSX Registry: Disponível para Cursor, Windsurf, VSCodium: castov/castov-vscode

# Command line installation
code --install-extension Castov.castov-vscode

5. GitHub Action (Pipelines CI/CD)

Automatize varreduras de segurança, auditorias de vazamento de segredos e verificações de ambiente em seus fluxos de trabalho do GitHub:

- name: Run Castov Secret Scanner
  uses: castovdev/castov-action@v1.0.0
  with:
    command: 'scan .'

---

🛠️ Início Rápido do CLI e Comandos Principais

castov <command> [options]

🔍 Gerenciador de Processos e Portas (Matador de EADDRINUSE)

Inspecione qual processo está ocupando uma porta ou encerre-o de forma limpa:

# Inspect service and protocol
castov port 3000

# Inspect active process PID and terminate it immediately
castov port 3000 --kill

🔐 Gerador de Segredos Criptográficos

Gere chaves de alta entropia para .env, NEXTAUTH_SECRET, assinatura JWT e autenticação de API:

castov secret
castov secret --len 64

🌐 Calculadora de Sub-rede e CIDR

Calcule máscaras de rede, máscaras wildcard e intervalos de hosts utilizáveis sem consultas externas:

castov cidr 192.168.1.0/24
castov cidr 10.0.0.0/16

🛡️ Scanner Local de Vazamento de Segredos

Varra recursivamente diretórios locais em busca de tokens de API commitados ou não commitados (AWS, Stripe, OpenAI, GitHub, Chaves Privadas):

castov scan .

🚑 Curador de Logs de Crash e Erros de Terminal

Envie crashes de terminal ou cole rastreamentos de pilha de erros para correção instantânea e determinística:

castov fix "Error: listen EADDRINUSE: address already in use :::8080"
npm run build 2>&1 | castov fix

🧠 Gerador de Regras de IA e Prompts de Sistema

Inicialize .cursorrules ou CLAUDE.md com práticas de engenharia robustas:

castov rules nextjs --write
castov rules fastapi
castov rules rust

⏱️ Detector Universal de IDs e Carimbos de Tempo

Extraia metadados e carimbos de tempo de época de qualquer identificador distribuído moderno:

castov detect 018e3a2b-8a5c-7b00-9821-654321abcdef
castov detect 507f1f77bcf86cd799439011
castov ts 1713456789

---

🌐 Suíte Completa de 63 Ferramentas para Desenvolvedores

Além do CLI e do Servidor MCP, o Castov fornece 63 ferramentas web do lado do cliente acessíveis em castov.com:

Categoria	Ferramentas em Destaque
Segurança e Privacidade	Cofre de Variáveis de Ambiente com Esteganografia, Scanner de Segredos no Lado do Cliente, Cofre de Variáveis de Ambiente com Conhecimento Zero, Gerador de Hash (SHA-256/512/MD5), Decodificador JWT, Codificador/Decodificador Base64, Gerador UUID v4/v7.
Redes e DevOps	Inspetor de Porta EADDRINUSE, Calculadora CIDR IPv4, Visualizador de Dockerfile, Túnel Fantasma P2P, Gerador de Mock de Fetch, Testador de Carga de API, Inspetor de DNS e Cabeçalhos.
Dados e Arquitetura	Gerador de Tipos TypeScript a partir de JSON, Galáxia JSON 3D, Formatador e Visualizador JSON Interativo, Fiddle SQLite no Navegador, Verificador de Diff Linha por Linha, Telepatia de Conflitos AST.
Frontend e UI	Estúdio CSS Glassmorphism, Gerador de Mockups de Aplicativos, Renderizador de Código para Imagem em Alta Resolução, Gerador de Favicon, Construtor de README para Perfil GitHub.
Tempo e Agendamento (25+ Ferramentas)	Conversor de Carimbo de Tempo Unix, Conversor de Época, Analisador ISO 8601 e RFC 3339, Conversor e Simulador de Fusos Horários, Gerador e Explicador de Cron em Inglês Simples, Relógio Mundial, Matriz de Horário Comercial, Milissegundos para Data.

---

🔒 Garantia de Privacidade e Zero Telemetria

Ferramentas de engenharia nunca devem vazar seu IP, segredos da empresa ou trechos de código.

• 0 Cookies de Análise ou Rastreamento: Sem PostHog, Google Analytics ou scripts de telemetria de terceiros.
• Offline Primeiro: Todas as operações criptográficas dependem do navegador e da API SubtleCrypto / Web Crypto nativa do runtime.
• Compatível com Air-Gap: Tanto o CLI, a imagem Docker quanto o aplicativo web podem ser executados em ambientes offline e intranets restritas.

---

💻 Desenvolvimento Local

O Castov é construído com Next.js 16 (App Router), TypeScript (Estrito) e Tailwind CSS v4.

# 1. Clone repository
git clone https://github.com/castovdev/castov.git
cd castov

# 2. Install dependencies
npm install

# 3. Setup local environment
cp .env.example .env.local

# 4. Start development server
npm run dev

# 5. Build CLI and Web applications
npm run build

Para executar testes em todos os pacotes:

npm run test

---

📄 Licença

O Castov é um software open-source licenciado sob a Licença MIT — Copyright © 2026 Abdelmalik Benidir / Castov (castov.com). Gratuito para uso pessoal, comercial e empresarial.