Memoria CLI

CLI oficial para sincronizar memórias de desenvolvimento com o Memoria Bank.

Instalação

Via npm (recomendado)

npm install -g memoria-dev-cli

Via npx (sem instalar)

npx memoria-dev-cli <comando>

Instalação local

# Clone o repositório
git clone <repo-url>
cd cli

# Instale dependências
npm install

# Link global
npm link

Configuração

Após instalar, configure suas credenciais:

memoria login

Você precisará da sua API Key, disponível em: Configurações → Integrações → API Key

Comandos

Autenticação

# Configurar credenciais
memoria login

# Verificar status da conexão
memoria status

# Remover credenciais
memoria logout

Gerenciar Memórias

# Listar memórias
memoria list
memoria ls -n 20  # Mostrar 20 memórias

# Baixar todas as memórias
memoria pull                        # JSON
memoria pull -f claude -o context.md  # Formato Claude

# Criar nova memória (modo interativo)
memoria push -i

# Criar memória diretamente
memoria push -t "Implementar auth" -g "Sistema de login" --files "src/auth.ts"

# Criar com template
memoria push --template feature -t "sistema de notificações"
memoria push --template bugfix -t "login não funciona no Safari"

Templates

# Ver templates disponíveis
memoria templates

Templates:

• feature - ✨ Nova Feature
• bugfix - 🐛 Correção de Bug
• refactor - 🔄 Refatoração
• performance - ⚡ Otimização
• security - 🔒 Segurança
• docs - 📝 Documentação

Sincronização

# Sincronizar arquivo local com o servidor
memoria sync memories.json

# Exportar para Claude
memoria export -o CLAUDE_CONTEXT.md

Formato do arquivo de sync

[
  {
    "task": "Implementar autenticação",
    "goal": "Permitir login com email",
    "files": ["src/auth.ts", "src/components/Login.tsx"],
    "tags": ["auth", "feature"],
    "status": "completed"
  }
]

Integração com Git Hooks

Post-commit hook

# .git/hooks/post-commit
#!/bin/bash
COMMIT_MSG=$(git log -1 --pretty=format:"%s")
FILES=$(git diff-tree --no-commit-id --name-only -r HEAD | tr '\n' ',' | sed 's/,$//')

memoria push -t "$COMMIT_MSG" --files "$FILES" --tags "git-commit"

Pre-push hook

# .git/hooks/pre-push
#!/bin/bash
memoria pull -o .memoria-backup.json
echo "Memórias sincronizadas antes do push"

Workflow Recomendado

1. Início do dia: memoria pull para ter contexto local
2. Durante desenvolvimento: memoria push -i após cada tarefa
3. Fim do dia: memoria export para backup
4. Nova conversa com Claude: Use o arquivo exportado como contexto

Variáveis de Ambiente

# Alternativa ao comando login
export MEMORIA_API_KEY="sua-api-key"

Troubleshooting

"API key não configurada"

Execute memoria login e insira sua API key.

"Erro de conexão"

Verifique sua conexão com a internet e se a API key está correta.

"Permissão negada"

Verifique se você tem permissão de escrita no diretório atual.

Suporte

• Documentação: https://docs.memoria.dev
• Issues: https://github.com/memoria/cli/issues