Skip to content

Hub de Contexto Universal para Agentes de IA em múltiplas IDEs - Um contexto, infinitos agentes. É um sistema universal de gerenciamento de contexto que sincroniza a inteligência do seu projeto em **todos os agentes de IA para programação** — Cursor, Windsurf, Trae, Claude, Copilot, Gemini, Antigravity e muito mais.

Notifications You must be signed in to change notification settings

anarkaike/ai-agent-ide-context-sync

Repository files navigation

🧠 AI Agent IDE Context Sync

Hub Universal de Contexto e Memória para Agentes de IA em múltiplas IDEs

Está cansado de repetir sempre os padrões, contexto e memória para cada agente de IA? Este é o seu novo aliado. Um contexto, infinitos agentes.

NPM Version License: MIT


🎯 O que é?

AI Agent IDE Context Sync é um sistema operacional universal de gerenciamento de contexto que sincroniza a inteligência do seu projeto entre todos os agentes de IA para código — Cursor, Windsurf, Trae, Claude, Copilot, Gemini, Antigravity e muito mais.

Em vez de manter arquivos separados como .cursorrules, .windsurfrules, .github/copilot-instructions.md e outros específicos de cada IDE, você define seu contexto uma vez e o sistema automaticamente sincroniza para todos os agentes.

Além disso, utiliza o próprio repositório git do projeto, para versionar a memoria, contexto, tasks e atividades de forma persistente para cada uma das personas criadas para os agentes de IA das IDEs.

O Problema

Você está trabalhando em um projeto Laravel + Vue com camadas e padrões definidos. Você tem:

  • .cursorrules para o Cursor
  • .windsurfrules para o Windsurf
  • .github/copilot-instructions.md para o Copilot
  • .trae/rules/project_rules.md para o Trae
  • .claude/instructions.md para Claude Projects

Toda vez que você atualiza sua arquitetura, adiciona um novo padrão ou muda um padrão de código, você precisa atualizar manualmente 5+ arquivos. É um pesadelo.

A Solução

npm install -g ai-agent-ide-context-sync
cd seu-projeto
ai-doc init
ai-doc build

Agora todos os seus agentes compartilham o mesmo cérebro. Atualize uma vez, sincronize em todos os lugares.


✨ Funcionalidades

🔄 Sincronização Universal

Gera automaticamente arquivos de contexto para:

  • Cursor (.cursorrules)
  • Windsurf (.windsurfrules)
  • GitHub Copilot (.github/copilot-instructions.md)
  • Trae (.trae/rules/project_rules.md)
  • Claude Projects (.claude/instructions.md)
  • Gemini CLI (.google/instructions.md)
  • Antigravity (.ai-workspace/cache/compiled/ai-instructions.md)

🧬 Arquitetura Modular

  • Módulos Core: Identidade, Memória, Tarefas, Análise
  • Integrações de Stack: Laravel, Vue, React, Next.js (extensível - implemente suas próprias integrações de stack)
  • Motor de Heurísticas: Aprende padrões automaticamente do seu código e otimiza prompts
  • Sistema Soul: Base de conhecimento portável (exporte/importe seus aprendizados)

🚀 Auto-Evolução

O sistema aprende com suas interações:

  • Padrões de navegação (rotas Laravel, componentes Vue)
  • Otimizações de prompts
  • Padrões de código e anti-padrões
  • Insights técnicos

🌍 Conhecimento Portável

Exporte sua "Soul" (conhecimento acumulado) e compartilhe:

ai-doc soul export
# Cria soul-backup-YYYYMMDD.tar.gz

Importe em outra máquina ou projeto:

ai-doc soul import soul-backup-20260116.tar.gz

📦 Instalação

Instalação Global (Recomendado)

npm install -g ai-agent-ide-context-sync

Inicializar no Seu Projeto

cd seu-projeto
ai-doc init

Isso cria um diretório .ai-workspace/ com:

  • config.yaml (metadados do projeto)
  • personas/ (identidades de agentes IA)
  • tasks/ (rastreamento de trabalho ativo)
  • analysis/ (decisões arquiteturais)

🛠️ Uso

Construir Contexto para Todos os Agentes

ai-doc build

Isso compila seus módulos kernel, integrações de stack e contexto do projeto em um único conjunto de instruções abrangente e sincroniza para todas as IDEs suportadas.

Verificar Status

ai-doc status

Saída:

=== 🔧 AI KERNEL (Global) ===
   Versão: 2.0.0
   Inteligência: 15 heurísticas aprendidas

=== 📁 AI WORKSPACE (Local) ===
   Projeto: sistema-clinica-new
   Path: /caminho/para/seu/projeto/.ai-workspace

Ver Heurísticas Aprendidas

ai-doc heuristics

Exportar/Importar Soul

# Exportar
ai-doc soul export

# Importar
ai-doc soul import soul-backup-20260116.tar.gz

🎨 VS Code Extension

Gerencie visualmente todo o seu AI Kernel diretamente do VS Code!

📦 Instalação

# Via Open VSX (Antigravity, Cursor, Windsurf, VS Code)
code --install-extension junio-de-almeida-vitorino.ai-agent-ide-context-sync-vscode

Ou busque por "AI Agent IDE Context Sync" na marketplace da sua IDE.

✨ Funcionalidades da Extensão

👥 Gerenciamento Visual

  • Criar/Editar/Deletar Personas: Interface visual completa
  • Gerenciar Tasks: CRUD completo com drag-and-drop
  • Toggle Checklists: Clique para marcar items como concluído
  • Arquivar Tasks: Organize tasks completadas

🎨 Customização

  • 16 Cores Predefinidas: Paleta vibrante e harmoniosa
  • Color Picker Customizado: Escolha qualquer cor
  • 24 Ícones Emoji: Robôs, animais, símbolos
  • Preview em Tempo Real: Veja mudanças instantaneamente

⏱️ Pomodoro Timer

  • 25min Pomodoro: Modo foco com countdown
  • 5min Break: Timer de pausa curta
  • Duração Customizada: Defina seus próprios minutos
  • Pause/Resume: Controle total sobre o timer
  • Notificações: Alertas quando completar

📊 Dashboard Interativo

  • Gráficos em Tempo Real: Chart.js com doughnut e bar charts
  • Estatísticas: Personas, tasks, taxa de conclusão
  • Auto-refresh: Atualiza a cada 5 segundos
  • Design Moderno: Integrado ao tema do VS Code

🔍 Navegação Rápida

  • Quick Picker (Ctrl+Shift+T): Navegação rápida entre tasks
  • Busca Global (Ctrl+Shift+F): Buscar em tasks e checklists
  • Status Bar: Task ativa com timer

📤 Export

  • Markdown: Agrupado por persona
  • JSON: Dados estruturados
  • Plain Text: Formato simples

🎯 Como Usar

  1. Instale a extensão e o CLI global
  2. Abra seu projeto no VS Code
  3. Clique no ícone AI Agent Sync na sidebar
  4. Initialize Workspace se necessário
  5. Crie personas e comece a trabalhar!

📸 Screenshots

  • Sidebar View: Hierarquia de Personas → Tasks → Checklists
  • Dashboard: Gráficos interativos e estatísticas
  • Customização: Interface visual para cores e ícones
  • Timer: Pomodoro integrado na status bar

🏗️ Arquitetura

~/.ai-doc/
├── kernel/          # Inteligência global (compartilhada entre todos os projetos)
│   ├── modules/     # Core, Identity, Memory, Tasks, Analysis
│   ├── heuristics/  # Padrões auto-aprendidos
│   └── cli/         # Interface de linha de comando
└── soul/            # Base de conhecimento portável
    └── experience/  # Insights de Laravel, Vue, React

seu-projeto/
└── .ai-workspace/   # Contexto local do projeto
    ├── config.yaml
    ├── personas/
    ├── tasks/
    └── analysis/

🎭 Sistema de Identidade

Crie personas de agentes IA com expertise específica:

ai-doc identity create AI-NARUTO

Cada persona tem:

  • Especialidades técnicas
  • Estilo de comunicação
  • Preferências de trabalho
  • Histórico de tarefas
  • Espaço de raciocínio ("Mesa de Raciocínio")

🧪 Motor de Heurísticas

O sistema aprende automaticamente:

  • Padrões de Navegação: "Ao trabalhar com Laravel, sempre verifique routes/web.php primeiro"
  • Otimizações de Prompt: "Use a flag --filter para testes PHPUnit"
  • Padrões de Código: "Multi-tenancy requer filtragem por business_id"

Essas heurísticas são armazenadas em ~/.ai-doc/kernel/heuristics/ e aplicadas em todos os projetos.


🌌 Sistema Soul

A "Soul" é sua sabedoria técnica acumulada:

  • Pitfalls: Erros comuns e como evitá-los
  • Patterns: Soluções arquiteturais comprovadas
  • Insights: Lições aprendidas em produção

Exporte, compartilhe com sua equipe ou importe em uma nova máquina.


📚 Documentação


🤝 Contribuindo

Contribuições são bem-vindas! Por favor, leia nosso Guia de Contribuição primeiro.


📄 Licença

MIT © Junio


🙏 Agradecimentos

Inspirado pela necessidade de uma camada de contexto universal na era do desenvolvimento assistido por IA.

Construído com ❤️ para desenvolvedores cansados de copiar e colar as mesmas instruções em 5 IDEs diferentes.


Pare de se repetir. Comece a sincronizar.

npm install -g ai-agent-ide-context-sync


🧠 AI Agent IDE Context Sync

Universal Context Hub for AI Agents across multiple IDEs

Stop repeating yourself. One context, infinite agents.

NPM Version License: MIT


🎯 What is this?

AI Agent IDE Context Sync is a universal context management system that synchronizes your project's intelligence across all AI coding agents — Cursor, Windsurf, Trae, Claude, Copilot, Gemini, Antigravity, and more.

Instead of maintaining separate .cursorrules, .windsurfrules, .github/copilot-instructions.md, and other IDE-specific files, you define your context once and the system automatically syncs it to every agent.

The Problem

You're working on a Laravel + Vue project. You have:

  • .cursorrules for Cursor
  • .windsurfrules for Windsurf
  • .github/copilot-instructions.md for Copilot
  • .trae/rules/project_rules.md for Trae
  • .claude/instructions.md for Claude Projects

Every time you update your architecture, add a new pattern, or change a coding standard, you have to manually update 5+ files. It's a nightmare.

The Solution

npm install -g ai-agent-ide-context-sync
cd your-project
ai-doc init
ai-doc build

Now all your agents share the same brain. Update once, sync everywhere.


✨ Features

🔄 Universal Sync

Automatically generates context files for:

  • Cursor (.cursorrules)
  • Windsurf (.windsurfrules)
  • GitHub Copilot (.github/copilot-instructions.md)
  • Trae (.trae/rules/project_rules.md)
  • Claude Projects (.claude/instructions.md)
  • Gemini CLI (.google/instructions.md)
  • Antigravity (.ai-workspace/cache/compiled/ai-instructions.md)

🧬 Modular Architecture

  • Core Modules: Identity, Memory, Tasks, Analysis
  • Stack Integrations: Laravel, Vue, React, Next.js (extensible)
  • Heuristics Engine: Auto-learns patterns from your codebase
  • Soul System: Portable knowledge base (export/import your learnings)

🚀 Auto-Evolution

The system learns from your interactions:

  • Navigation patterns (Laravel routes, Vue components)
  • Prompt optimizations
  • Code patterns and anti-patterns
  • Technical insights

🌍 Portable Knowledge

Export your "Soul" (accumulated knowledge) and share it:

ai-doc soul export
# Creates soul-backup-YYYYMMDD.tar.gz

Import it in another machine or project:

ai-doc soul import soul-backup-20260116.tar.gz

📦 Installation

Global Installation (Recommended)

npm install -g ai-agent-ide-context-sync

Initialize in Your Project

cd your-project
ai-doc init

This initializes the AI workspace and already builds/syncs the initial context for all supported IDEs.

It creates a .ai-workspace/ directory with:

  • config.yaml (project metadata)
  • personas/ (AI agent identities)
  • tasks/ (active work tracking)
  • analysis/ (architectural decisions)

🛠️ Usage

Manually Rebuild Context for All Agents

ai-doc build

ai-doc init already builds the initial context.
Use ai-doc build later whenever you want to rebuild and resync the context after changing rules, architecture, or stack integrations.

This command compiles your kernel modules, stack integrations, and project context into a single, comprehensive instruction set and syncs it to all supported IDEs.

Check Status

ai-doc status

Output:

=== 🔧 AI KERNEL (Global) ===
   Versão: 2.0.0
   Inteligência: 15 heurísticas aprendidas

=== 📁 AI WORKSPACE (Local) ===
   Projeto: sistema-clinica-new
   Path: /path/to/your/project/.ai-workspace

View Learned Heuristics

ai-doc heuristics

Export/Import Soul

# Export
ai-doc soul export

# Import
ai-doc soul import soul-backup-20260116.tar.gz

🏗️ Architecture

~/.ai-doc/
├── kernel/          # Global intelligence (shared across all projects)
│   ├── modules/     # Core, Identity, Memory, Tasks, Analysis
│   ├── heuristics/  # Auto-learned patterns
│   └── cli/         # Command-line interface
└── soul/            # Portable knowledge base
    └── experience/  # Laravel, Vue, React insights

your-project/
└── .ai-workspace/   # Local project context
    ├── config.yaml
    ├── personas/
    ├── tasks/
    └── analysis/

🎭 Identity System

Create AI agent personas with specific expertise:

ai-doc identity create AI-NARUTO

Each persona has:

  • Technical specialties
  • Communication style
  • Work preferences
  • Task history
  • Reasoning workspace ("Mesa de Raciocínio")

🧪 Heuristics Engine

The system automatically learns:

  • Navigation Patterns: "When working with Laravel, always check routes/web.php first"
  • Prompt Optimizations: "Use --filter flag for PHPUnit tests"
  • Code Patterns: "Multi-tenancy requires business_id filtering"

These heuristics are stored in ~/.ai-doc/kernel/heuristics/ and applied across all projects.


🌌 Soul System

The "Soul" is your accumulated technical wisdom:

  • Pitfalls: Common mistakes and how to avoid them
  • Patterns: Proven architectural solutions
  • Insights: Hard-won lessons from production

Export it, share it with your team, or import it on a new machine.


📚 Documentation


🤝 Contributing

Contributions are welcome! Please read our Contributing Guide first.


📄 License

MIT © Junio


🙏 Acknowledgments

Inspired by the need for a universal context layer in the age of AI-powered development.

Built with ❤️ for developers who are tired of copy-pasting the same instructions across 5 different IDEs.


Stop repeating yourself. Start syncing.

npm install -g ai-agent-ide-context-sync

About

Hub de Contexto Universal para Agentes de IA em múltiplas IDEs - Um contexto, infinitos agentes. É um sistema universal de gerenciamento de contexto que sincroniza a inteligência do seu projeto em **todos os agentes de IA para programação** — Cursor, Windsurf, Trae, Claude, Copilot, Gemini, Antigravity e muito mais.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published