Krimto

Camada de memória de equipe de código aberto para agentes de codificação de IA. Arquivos Markdown no git, uma hierarquia usuário→equipe→org, um servidor MCP entre fornecedores. Apache-2.0.

Documentação

Krimto

Memória de código aberto para agentes de IA que você possui no git — governada por uma hierarquia real de usuário→equipe→organização, não um banco de dados de fornecedor. Do solo à equipe. Apache-2.0.

License: Apache 2.0 npm CI

A memória do seu agente, como markdown no seu próprio git — sincronizada em todos os editores e máquinas. Diga ao seu agente "lembre-se de X" em qualquer editor e ele salva um fato durável e atribuível; pergunte depois — em um novo chat, um editor diferente ou em outra máquina — e ele recupera a resposta certa. Um comando, sem conta, sem banco de dados de fornecedor: sua memória segue você.

Você é o dono: cada fato é um arquivo markdown simples em um repositório git que você controla — legível, revisável em um PR e seu. Quando um colega entra, essa mesma memória se torna um cérebro de equipe compartilhado, governado por uma hierarquia real user → team → org (o escopo mais específico vence na recuperação) — a única primitiva que nenhuma outra ferramenta de memória oferece. Solo é grátis; a governança é o que você adota ao crescer.

Veja

Um comando npx configura tudo; então seu agente salva um fato no Claude Code e o recupera no Cursor — sem conta, sem banco de dados:

Krimto — save a fact in Claude Code, recall it in Cursor

Três demonstrações curtas — solo (lembre no Claude Code, recupere no Cursor), entre máquinas (escreva, git push, recupere em outro laptop) e equipe (o fato de um colega chega até você; suas notas pessoais permanecem suas).

Como cada memória é apenas um arquivo no seu git, você pode lê-la você mesmo — sem API, sem painel necessário:

$ cat ~/.krimto/user/you@example.com/favorite-color.md
---
id: fct_01KT3BDSYY1KK80SG3S7KBEV58
scope: user/you@example.com
title: Favorite color
author: you@example.com
created: 2026-06-02T05:03:14Z
updated: 2026-06-02T05:03:14Z
tags:
  - personal
source: claude-code
---

User's favorite color is red.

$ git -C ~/.krimto log --oneline -1
8bc5b86 krimto: write batch — 1 fact

Essa é a aposta: a memória do seu agente é markdown simples em um repositório git que você possui — não linhas em um banco de dados de outra pessoa.

Por que Krimto

  • Você é o dono, no seu git. Cada fato é um arquivo markdown em um repositório git que você controla — git log o trilho de auditoria, edite em qualquer editor, revise em um pull request. Sem banco de dados de fornecedor, sem aprisionamento.
  • Hierarquia governada por user → team → org. O conhecimento é escopado a uma pessoa, uma equipe ou toda a empresa, e o escopo mais específico vence na recuperação — uma primitiva imposta pelo servidor que nenhuma outra ferramenta de memória oferece gratuitamente.
  • Segue você em todos os lugares — entre fornecedores, Apache-2.0. Um servidor MCP sincroniza a mesma memória entre Claude Code, Cursor, Codex, Gemini CLI e mais — todos os editores e máquinas. Totalmente open source, sem restrição de serviço gerenciado.

Experimente em 2 minutos (solo, sem conta)

npx @krimto-labs/krimto init

O assistente de configuração detecta seu editor, conecta tudo e ativa a memória automática. Então, em qualquer chat:

"Remember that our staging DB resets every Sunday."

Abra um novo chat e pergunte:

"What do you know about staging?"   → it remembers.

Veja suas notas com krimto notes (terminal) ou krimto ui (painel do navegador). Seus dados ficam em ~/.krimto — a mesma pasta, independentemente do projeto em que você está trabalhando.

Conecte seu agente

krimto init conecta os editores suportados para você. O que conecta automaticamente vs. o que precisa de um passo de copiar e colar:

EditorConfiguração
Cursorconexão automática
Claude Codeconexão automática
Codextrecho manual
Gemini CLItrecho manual

Para conectar qualquer cliente MCP manualmente, aponte-o para o Krimto via stdio:

claude mcp add krimto -- npx -y @krimto-labs/krimto

…ou a forma de arquivo de configuração (Cursor, Codex, Gemini CLI, etc. usam o mesmo formato):

{ "mcpServers": { "krimto": { "command": "npx", "args": ["-y", "@krimto-labs/krimto"] } } }

Por padrão, um agente usa o Krimto apenas quando você pede. Executar krimto init uma vez no seu projeto adiciona uma regra permanente para que ele use o Krimto por conta própria.

Instalar como plugin do Claude Code

Prefere o sistema de plugins do Claude Code? Adicione o marketplace do Krimto e instale diretamente:

/plugin marketplace add krimto-labs/krimto
/plugin install krimto@krimto

Isso agrupa o servidor MCP com as habilidades do Krimto, o comando /krimto-status e os ganchos de memória — sem necessidade de krimto init separado.

Como funciona

Três camadas, uma única fonte de verdade:

  1. Armazenamento — fatos são arquivos markdown em um repositório git (a fonte de verdade; o git é o log de auditoria).
  2. Índice — um índice híbrido SQLite + sqlite-vec (palavra-chave + vetor) para recuperação rápida, com precedência de escopo aplicada no momento da classificação.
  3. Acesso — um servidor de API impõe quem pode ler e escrever em cada escopo (user / team / org).

Modo equipe

Quando você estiver pronto para compartilhar memória com colegas:

npx @krimto-labs/krimto team init

Isso guia você por um e-mail de administrador, o nome da sua organização/equipe, um repositório git remoto compartilhado opcional e convites para colegas — depois imprime um comando de entrada para cada colega:

krimto join --server <url> --key <key>

Colegas podem se conectar a um servidor compartilhado, ou cada um pode executar seu próprio Krimto sincronizado via um repositório git remoto compartilhado. Notas pessoais e de equipe vivem juntas e sincronizam como uma unidade. Volte ao modo solo a qualquer momento com krimto team disband (suas notas são preservadas).

Auto-hospedagem

O Krimto roda em qualquer lugar onde Node 20+ roda.

# HTTP server + browser dashboard at http://localhost:8080
npx @krimto-labs/krimto serve

# or Docker
docker run -d -p 8080:8080 -v ~/.krimto:/data ghcr.io/krimto-labs/krimto:latest

Execute npx @krimto-labs/krimto --help para a superfície completa de comandos.

Roadmap

v0.2 (atual) entrega o núcleo de memória, equipes, o painel web e o servidor MCP entre fornecedores. Próximo: login OAuth e um fluxo de aprovação de pull request (v0.3), depois um Krimto Cloud hospedado (v1.0). Veja ROADMAP.md.

Contribuição e licença

Contribuições são bem-vindas — veja CONTRIBUTING.md e nosso Código de Conduta. Relatórios de segurança: SECURITY.md.

Licenciado sob Apache-2.0. O mesmo código pode ser auto-hospedado por um desenvolvedor solo ou uma empresa — sem barreiras de nível.