AXME Code

AXME Code

Claude Code esquece seu projeto a cada sessão. Nós corrigimos isso.

AXME Code é um plugin para Claude Code que dá ao seu agente de codificação de IA memória persistente entre sessões, hooks de segurança pré-execução, aplicação de decisões arquiteturais e handoff estruturado de sessão — via um servidor MCP, automaticamente, em todas as sessões.

Pare de reexplicar sua arquitetura na sessão 47. Pare de perder memória entre handoffs de sessão. Pare de torcer para o agente não rodar git push --force na main. AXME Code lembra o que aconteceu, aplica suas decisões arquiteturais, continua de onde a última sessão parou e bloqueia comandos perigosos antes que eles sejam executados — para você focar em construir.

Você continua usando Claude Code exatamente como antes. AXME Code funciona de forma transparente em segundo plano.

⭐ Dê uma estrela neste repositório se ele economizar seu tempo · 🔔 Acompanhe os releases para novos recursos · 💬 Discussões

Início Rápido · Antes & Depois · Como Funciona · Arquitetura · Site

Antes & Depois

Início Rápido

AXME Code suporta três caminhos de IDE hoje, classificados pelo menor atrito de instalação:

Opção 0: Extensão do Cursor (instalação em 1 clique — recomendado para usuários do Cursor)

Para usuários de Cursor 0.42+ — instale a extensão AXME Code pelo painel de Extensões (Open VSX). A extensão empacota o binário, registra o servidor MCP programaticamente (sem clique manual em Enable), instala hooks de segurança no nível do usuário em ~/.cursor/hooks.json (aplicam-se a todos os projetos da sua máquina) e oferece uma notificação de "Executar configuração" em um clique na primeira vez que você abre um projeto sem .axme-code/.

Cursor → Extensions → search "AXME Code" → Install

Ou carregue lateralmente o .vsix anexado ao último release (Extensions → ... menu → "Install from VSIX...").

Na primeira ativação, um modal pede uma credencial LLM para o auditor de sessão: cole uma chave de API da Anthropic, uma chave SDK do Cursor (cursor.com → Integrações) ou pule o auditor. Se o CLI claude estiver logado (claude login), a extensão usa automaticamente sua assinatura do Claude — sem necessidade de colar.

Opção 1: Plugin do Claude Code (recomendado para usuários do Claude Code)

No Claude Code, execute:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install axme-code@claude-community

Ou pelo terminal:

claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install axme-code@claude-community

O plugin vem com o servidor MCP, hooks de segurança e CLI empacotados juntos; nenhum binário separado para instalar. No primeiro uso em um projeto, basta pedir ao agente para chamar axme_context — o plugin inicializa automaticamente a base de conhecimento nessa sessão.

Opção 2: Binário autônomo

Instale o CLI em todo o sistema (útil se você quiser rodar axme-code fora do Claude Code, por exemplo, para scripts).

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/AxmeAI/axme-code/main/install.sh | bash

Instala em ~/.local/bin/axme-code. Requer Node.js 20+ no PATH (o binário é um bundle Node de arquivo único; o instalador verifica isso). Suporta x64 e ARM64.

Windows (nativo):

irm https://raw.githubusercontent.com/AxmeAI/axme-code/main/install.ps1 | iex

Instala em %LOCALAPPDATA%\Programs\axme-code e o adiciona ao PATH do usuário. Requer Node.js 20+ no PATH. Suporta x64 e ARM64.

Windows via WSL2: se você já vive no WSL2, use o one-liner de instalação Linux dentro da sua distro. Instale Claude Code e axme-code dentro da distro WSL, não no host Windows.

Então, em cada projeto:

cd your-project          # or workspace root for multi-repo
axme-code setup
claude                   # that's it — use Claude Code as usual

axme-code setup faz três coisas:

1. Escaneia seu projeto e constrói a base de conhecimento — oráculo (stack, estrutura, padrões, glossário), extrai decisões, memórias e regras de segurança do seu código, configs, CLAUDE.md e histórico de sessões
2. Instala hooks de segurança que interceptam comandos perigosos antes da execução
3. Configura o servidor MCP nas configurações do Claude Code (.mcp.json)

Após a configuração, toda sessão do Claude Code carrega automaticamente a base de conhecimento completa. Sem configuração, sem etapas manuais.

O Que Você Obtém

Base de Conhecimento Persistente

Seu agente começa toda sessão com contexto completo: stack, decisões, padrões, glossário e um handoff da sessão anterior. Chega de reexplicar sua arquitetura na sessão 47.

Salvaguardas de Segurança (100% Confiáveis)

Os hooks interceptam chamadas de ferramentas antes da execução — não prompts. Mesmo que o agente alucine um motivo para rodar rm -rf /, o hook bloqueia. Isso é aplicação rígida no nível do harness do Claude Code, não uma sugestão em um prompt de sistema.

Bloqueado por padrão:

• git push --force, git reset --hard, push direto para main/master
• rm -rf /, chmod 777, curl | sh
• npm publish, git tag, gh release create
• Escrever em arquivos .env, .pem, .key

Você pode adicionar suas próprias regras personalizadas via axme_update_safety ou editando .axme-code/safety/rules.yaml diretamente.

Extração Automática de Conhecimento

O agente salva descobertas durante o trabalho via ferramentas MCP. No fechamento da sessão, uma checklist estruturada garante que nada seja perdido. Se você apenas fechar a janela — um auditor em segundo plano extrai memórias, decisões e regras de segurança da transcrição completa da sessão.

Espaços de Trabalho Multi-Repositório

Cada repositório tem sua própria base de conhecimento (.axme-code/). Regras no nível do workspace se aplicam a todos os repositórios. Regras específicas de repositório permanecem escopadas. O agente vê contexto mesclado — piso de segurança do workspace + decisões específicas do repositório.

Suporta 14 formatos de workspace: VS Code multi-root, workspaces pnpm/npm/yarn, Nx, Gradle, Maven, Rush, submodules git e mais.

Por que não apenas CLAUDE.md?

CLAUDE.md é ótimo para projetos simples com algumas regras. Mas não escala:

AXME Code complementa o CLAUDE.md — ele lê seu CLAUDE.md existente durante a configuração e extrai decisões e regras dele.

Funciona com Qualquer Cliente MCP

AXME Code é um servidor MCP stdio — todo assistente de codificação de IA compatível com MCP recebe o conjunto completo de ferramentas axme_* (leitura/escrita da base de conhecimento, consultas de segurança, status, worklog).

A entrada do servidor MCP é idêntica em todos os clientes:

{
  "mcpServers": {
    "axme": {
      "command": "axme-code",
      "args": ["serve"]
    }
  }
}

Basta colocá-la no arquivo de configuração MCP do seu cliente:

• Cursor: ~/.cursor/mcp.json ou .cursor/mcp.json (por projeto)
• Windsurf: ~/.codeium/windsurf/mcp_config.json
• Cline: Configurações do VS Code → Cline MCP → cline_mcp_settings.json
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou equivalente

Os hooks de segurança pré-execução, o rastreador de arquivos pós-uso de ferramenta e o auditor de sessão em segundo plano são específicos do Claude Code (eles exigem o sistema de hooks do Claude Code). Em outros clientes, o agente deve chamar as ferramentas AXME explicitamente — mesma base de conhecimento, mesmo armazenamento .axme-code/, apenas sem a camada automática de aplicação.

Consulte docs/MULTI_CLIENT.md para configuração completa por cliente, workarounds de hooks e semântica de clientes concorrentes.

Comparação

Eficiência de tokens

AXME usa ~10× menos tokens por resposta correta que o Mastra com precisão competitiva. O sistema de memória executa apenas 2 chamadas LLM por pergunta (leitor + juiz) — concorrentes executam dezenas (Observer por turno, Reflector periodicamente, construção de grafo, extração de fatos).

Consulte benchmarks/README.md para metodologia completa, detalhamentos por categoria, notas de rodapé e instruções de reprodução.

Como Funciona

Fluxo de Sessão

1. Início da sessão → o agente chama axme_context, carrega a base de conhecimento completa
2. Durante o trabalho → o agente salva descobertas via axme_save_memory, axme_save_decision. Os hooks aplicam segurança em cada chamada de ferramenta.
3. Fechamento da sessão → peça ao seu agente para fechar a sessão → o agente chama axme_begin_close, obtém uma lista de verificação. Revisa a sessão para memórias perdidas, decisões, regras de segurança. Chama axme_finalize_close — o MCP escreve handoff, worklog e extrações atomicamente.
4. Fallback → se você apenas fechar a janela, o auditor em segundo plano extrai tudo da transcrição.
5. Próxima sessão → axme_context retorna tudo acumulado. O handoff diz exatamente onde continuar.

Dica: Você pode salvar a qualquer momento — basta dizer ao agente "lembre disso" ou "salve isso como uma decisão". Você não precisa esperar o fechamento da sessão.

Armazenamento

Todos os dados ficam em .axme-code/ na raiz do seu projeto (ignorado pelo git automaticamente):

.axme-code/
  oracle/           # stack.md, structure.md, patterns.md, glossary.md
  decisions/        # D-001-slug.md ... D-NNN-slug.md (with enforce levels)
  memory/
    feedback/       # Learned mistakes and corrections
    patterns/       # Validated successful approaches
  safety/
    rules.yaml      # git + bash + filesystem guardrails
  backlog/          # B-001-slug.md ... persistent cross-session tasks
  sessions/         # Per-session meta.json (tracking, agentClosed flag)
  plans/
    handoff-<id>.md # Per-session handoff (last 5 kept)
  worklog.jsonl     # Structured event log
  worklog.md        # Narrative session summaries
  config.yaml       # Model settings, presets

Markdown e YAML legíveis por humanos. Sem banco de dados, sem dependências externas.

Plataforma AXME

AXME Code é a camada de ferramentas de desenvolvedor da plataforma AXME — infraestrutura de execução durável para agentes de IA.

axme-code setup [path]       # Initialize project/workspace with LLM scan
axme-code serve              # Start MCP server (called by Claude Code automatically)
axme-code status [path]      # Show project status
axme-code stats [path]       # Worklog statistics (sessions, costs, safety blocks)
axme-code audit-kb [path]    # KB audit: dedup, conflicts, compaction
axme-code hook pre-tool-use  # PreToolUse hook handler (called by Claude Code)
axme-code hook post-tool-use # PostToolUse hook handler
axme-code hook session-end   # SessionEnd hook handler
axme-code audit-session      # Run LLM audit on a session transcript

export AXME_TELEMETRY_DISABLED=1
# or the industry-standard:
export DO_NOT_TRACK=1

Contribuindo

Veja CONTRIBUTING.md para diretrizes.

Licença

MIT

Site · Problemas · Arquitetura · contact@axme.ai