nuxs-capsule

A camada invisível que corta o desperdício de tokens dos seus agentes de IA. Funciona em Claude Code, Cursor e Codex — instala em 30 segundos, comprime na fonte, e devolve a memória que a compactação joga fora.

O problema

Você paga pelo modelo mais caro do mundo — e ele recomeça do zero a cada sessão, reenviando todo o histórico a cada turno. O gasto não está na sua pergunta nova: está no histórico que a acompanha, que cresce a cada passo e é reenviado inteiro.

Logs gigantes, arquivos enormes, retornos de comando que entopem o contexto. Aí a janela enche, o agente compacta de qualquer jeito e esquece o que vocês decidiram.

O que o Capsule faz

Três frentes, sem você mexer em nada depois do setup:

• 🗜️ Comprime na fonte — hooks interceptam saídas grandes de Bash / Read / WebFetch / subagente e comprimem antes de entrar no contexto. 20 compressores especializados (stack trace, git diff, logs, schema, SQL, OpenAPI, sessão, threads, e mais).
• 🧠 Anti-amnésia — quando o contexto compacta, o Capsule lê o que está sendo descartado, resume de forma densa e re-injeta o estado da tarefa (o que foi investigado, decidido, e o que falta). Com fatos críticos preservados literais (paths, SHAs, configs) pra não distorcer.
• 📊 Mede tudo — quantos tokens foram economizados, por agente, em tempo real. Você vê o valor, não acredita no marketing.

Instalação

npm install -g nuxs-capsule
nuxs-capsule setup

O setup detecta seus agentes (Claude Code, Cursor, Codex), instala os hooks e o servidor MCP, e está pronto. Reinicie seus agentes e funciona.

Ou em uma linha:

curl https://nuxs.ai/install.sh | bash

Como usar

Depois do setup, não precisa fazer nada — os hooks rodam sozinhos. Quando quiser comprimir algo sob demanda, os agentes têm acesso às ferramentas via MCP, ou pelo terminal:

cat erro.log | nuxs-capsule wrap --type log

No fim de cada sessão você vê um resumo do quanto economizou. Esse número é real, medido — não estimado.

O que comprime (20 tipos)

| Categoria | Tipos | |---|---| | Código & dev | stack · diff · test · build · codebase · schema · apispec · sql · log | | Dados & web | api · network · prompt · events · rag · pdf | | Sessão & conversa | session · threads | | Multimodal (beta) | image · meeting · video |

Metade roda localmente por algoritmo (zero custo, zero latência de rede); a outra metade usa a IA da Nuxs quando vale a pena resumir.

Privacidade — arquitetura zero-knowledge

O conteúdo dos seus logs, arquivos e respostas nunca sai da sua máquina. O que o Capsule envia é apenas métrica agregada (quantos tokens, qual tipo, quanto economizou) — nunca o conteúdo, URLs, paths ou identificadores. Há um filtro de auditoria no servidor que rejeita qualquer payload que pareça conter segredo. LGPD/GDPR by design.

Onde funciona

| Cliente | Como | |---|---| | Claude Code | hooks (PreToolUse/PostToolUse/SessionStart) + MCP + proxy local | | Codex CLI | mesmo sistema de hooks | | Cursor | MCP | | Qualquer CLI OpenAI/Anthropic-compatível | via proxy local (BYOK) |

Proxy local com fallback automático

Pra qualquer cliente HTTP (Claude Code, SDKs Anthropic/OpenAI, etc), o pacote expõe um proxy local que cuida do upstream e nunca trava o cliente.

npx -p nuxs-capsule nuxs-capsule-proxy
# escuta em http://localhost:8311

Cliente aponta o base URL pro proxy local:

export ANTHROPIC_BASE_URL=http://localhost:8311
export OPENAI_BASE_URL=http://localhost:8311/openai/v1
export GOOGLE_AI_BASE_URL=http://localhost:8311/google/v1beta

Modos (env NUXS_PROXY_MODE):

• auto (default) — tenta backend Nuxs; em 5xx ou timeout, cai pro upstream original (api.anthropic.com, api.openai.com, …). Cliente nunca quebra mesmo se o proxy estiver fora.
• strict — só backend Nuxs (pra debug; falha = falha).
• disabled — só upstream original (útil pra plano Claude Max/Pro flat-rate, onde compressão não economiza dinheiro).

Pra detecção/aviso automáticos: se você tem CLAUDE_CODE_OAUTH_TOKEN (plano), o proxy printa um lembrete sugerindo o modo disabled.

Configuração avançada

Aponta pro seu próprio backend (self-host) sem reinstalar:

export NUXS_SERVER_URL="https://seu-backend"
export NUXS_PROXY_BASE="https://seu-proxy"

Links

• Site: https://nuxs.ai
• Painel: https://nuxs.ai/painel

Licença

Source-available. O núcleo é auditável; uso comercial requer license key Nuxs.