Rafhael Marsigli Logo
aipim — zsh
    ▄▄█▄▄      █████╗ ██╗██████╗ ██╗███╗   ███╗
  ▀▀▀███▀▀▀   ██╔══██╗██║██╔══██╗██║████╗ ████║
     ███      ███████║██║██████╔╝██║██╔████╔██║
   ▄█████▄    ██╔══██║██║██╔═══╝ ██║██║╚██╔╝██║
  ▐███████▌   ██║  ██║██║██║     ██║██║ ╚═╝ ██║
   ▀█████▀    ╚═╝  ╚═╝╚═╝╚═╝     ╚═╝╚═╝     ╚═╝
     ▀█▀      ═════════════════════════════════
$ aipim install --ai claude-code
✓ .project/ scaffolded
✓ CLAUDE.md generated
✓ .gitattributes configured
$ aipim mcp start
→ Rebuilding SQLite...
✓ MCP server running at :3141
$ aipim task next
TASK-007 [P1-M] · Refactor auth middleware · 4h
$

AIPIM

Gerenciador de projetos com event sourcing e servidor MCP. Mantém suas sessões de IA focadas, o orçamento de tokens previsível e o histórico do projeto imutável.

$ npm install -g aipim && aipim install

Funciona com Claude Code, Gemini CLI e Cursor

Toda sessão de IA começa do zero

Toda vez que você abre uma nova sessão, seu agente de IA não sabe o que você construiu ontem. Você cola contexto, re-explica convenções, re-descreve a arquitetura. E se você depende de loops de agentes abertos, a conta de tokens cresce - o modelo fica relendo o que já fez três mensagens atrás.

Em uma migração legada real: 29 tasks, cada uma com 30–100K tokens, cada uma começando com contexto limpo. Algumas em lote, outras isoladas. Mais eficiente que loops de agentes abertos - e o histórico é imutável.

Tasks com Contexto Delimitado

O AIPIM decompõe seu projeto em tasks dimensionadas para caber em uma janela de contexto. Uma task por sessão, /clear entre elas. Sem inchaço de contexto, sem tokens desperdiçados reestabelecendo estado.

  • Orçamento de tokens previsível por task
  • Sessões focadas e rápidas
  • Mais eficiente que loops abertos em projetos longos
  • ADRs e comentários capturados imutavelmente por task

Event Sourcing

Todo o estado vive em events.jsonl, um log append-only. O SQLite é reconstruído a partir desses eventos na inicialização - um modelo de leitura, nunca a fonte da verdade. Você pode reconstruir tudo a partir do log.

  • Trilha de auditoria imutável de todas as decisões do projeto
  • Driver git merge=union - sem conflitos de merge em pushes simultâneos
  • Reconstrua o banco de dados a qualquer momento reproduzindo os eventos
  • Funciona offline - nenhum serviço externo necessário

Servidor MCP

Um servidor Hono local na porta 3141 expõe as ferramentas do projeto diretamente ao Claude Code via JSON-RPC. Sem clipboard, sem copy-paste, sem humano agindo como middleware entre o LLM e o sistema de arquivos.

  • get_next_task, create_task, complete_task, log_decision e mais
  • Active Skills dinâmicos habilitados por projeto via config.toml
  • Skill database: acesso somente leitura ao SQLite para consultas com IA
  • Um comando para registrar: claude mcp add aipim http://localhost:3141/mcp

UI Visual (Svelte 5)

Uma interface web completa servida pelo mesmo processo Hono. Quadro Kanban, timeline de eventos e painel de detalhes de task com editor markdown inline. Tempo real via SSE - mova um card em uma aba, todas as abas atualizam.

  • Kanban drag-and-drop - HTML5 nativo, sem biblioteca
  • Atualizações ao vivo via SSE em todas as abas abertas
  • Editor markdown inline com thread de comentários
  • Timeline de eventos com filtros por tipo, membro e período

Sistema de Skills

Duas camadas complementares de skills. Context Modules injetam diretrizes de codificação diretamente no seu arquivo de instrução de IA. Active Skills adicionam ferramentas MCP dinamicamente por projeto - sem restart necessário.

  • 19 context modules built-in: TypeScript, React, Laravel, Tailwind, Rust, Python e mais
  • Injete com: aipim add skill typescript
  • Idempotente - rodar o comando duas vezes nunca duplica o conteúdo
  • Active skills recarregam na próxima chamada tools/list

Construído com o mesmo rigor que ele ajuda você a aplicar.

238 Testes - unitários + E2E cobrindo todo o CLI e a superfície MCP
107 KB Tarball npm. Zero inchaço. Já inclui a UI Svelte compilada.
19 Skills de codificação built-in: TypeScript, React, Laravel, Tailwind, Rust, Python e mais
MIT Totalmente open-source, para sempre.
Como isso é diferente das ferramentas de task nativas do Claude?
O AIPIM te dá limites explícitos de contexto. Você decide quando limpar e reiniciar. Loops de agentes são poderosos mas acumulam uso de tokens em sessões longas - o modelo fica relendo contextos anteriores. O AIPIM é a alternativa intencional: tasks delimitadas, inícios limpos, histórico imutável.
Funciona com Gemini CLI ou Cursor?
Sim. aipim install --ai gemini gera GEMINI.md. --ai cursor gera .cursorrules. O servidor MCP em si é agnóstico ao editor - qualquer cliente compatível com MCP pode se conectar.
Preciso de uma equipe para usar?
Não. O modo solo funciona imediatamente - nenhum config.toml necessário. O ator padrão é o seu email do git. As funcionalidades de equipe (atribuições, pushes simultâneos, rastreamento de membros) ativam quando você adiciona um config.toml.
E se eu estiver migrando do AIPIM 1.x?
Execute aipim migrate. Ele lê seus backlog/*.md e completed/*.md existentes, sintetiza eventos e reconstrói o SQLite. Seus arquivos markdown originais são preservados.
O banco de dados está protegido de escritas acidentais da IA?
Sim. A Active Skill de banco de dados só permite SELECT, EXPLAIN e PRAGMA. Uma regex rígida no nível do driver bloqueia todas as operações de escrita antes da execução - INSERT, UPDATE, DROP, ALTER e DELETE são todos rejeitados.
E o AIPIM 3.0?
Uma versão cloud-native está em planejamento inicial: 100% open-source, gratuita e MCP-first. O AIPIM 2.x continua com suporte completo.