Agentic Tools MCP Companion

Uma extensão do VS Code com interface gráfica para o servidor agentic-tools-mcp, aprimorando o gerenciamento de tarefas e memória.

GitHub

Experimente este MCPPatrocinado

Documentação

Agentic Tools MCP Companion

Uma bela extensão do VS Code que fornece uma interface gráfica abrangente para a funcionalidade do servidor agentic-tools-mcp. Esta extensão permite gerenciar tarefas e memórias diretamente do VS Code com uma interface intuitiva e visual, apresentando metadados aprimorados de tarefas, gerenciamento de prioridades e editores de formulários ricos.

🔗 Ecossistema

Esta extensão do VS Code faz parte de um ecossistema completo de gerenciamento de tarefas e memórias:

🖥️ Extensão do VS Code (este repositório) - Interface gráfica bonita para gerenciar tarefas e memórias
⚡ Servidor MCP - Ferramentas de linha de comando e API para assistentes de IA

💡 Dica Profissional: Use ambos juntos para a experiência de produtividade definitiva! O servidor MCP permite a integração com assistentes de IA enquanto esta extensão fornece uma interface visual.

Recursos

🎯 Gerenciamento Aprimorado de Tarefas com Hierarquia Ilimitada (v0.1.0)

Visualização em Árvore de Hierarquia Ilimitada: Projetos → Tarefas → Subtarefas → Sub-subtarefas → aninhamento de profundidade infinita
Modelo de Tarefa Unificado: Interface de tarefa única suportando aninhamento de profundidade ilimitada com indicadores visuais ricos
Indicadores Visuais por Nível: Ícones e indentação diferentes para cada nível de hierarquia (L0, L1, L2, etc.)
Metadados Aprimorados de Tarefas: Prioridade (1-10), complexidade (1-10), fluxo de status, tags e rastreamento de tempo em todos os níveis
Indicadores Visuais de Status: ⏳ Pendente, 🔄 Em Andamento, 🚫 Bloqueado, ✅ Concluído com exibição de emojis
Distintivos de Prioridade e Complexidade: 🔥 Alta Prioridade (8+), ⚡ Prioridade Média (6+), 🧩 Alta Complexidade (8+)
Editores de Formulários Ricos: Formulários abrangentes com design responsivo e validação
Rastreamento de Tempo: Horas estimadas e reais com precisão decimal
Gerenciamento de Tags: Entrada de tags separadas por vírgula para categorização e filtragem
Operações de Profundidade Ilimitada: Criar, editar, mover e excluir tarefas em qualquer nível de hierarquia
Seleção e Gerenciamento de Pai: Escolha tarefas pai em qualquer nível de hierarquia durante a criação
Reorganização de Hierarquia: Mova tarefas entre quaisquer níveis de hierarquia sem problemas
Dicas de Ferramentas Ricas: Passe o mouse para ver informações completas da tarefa, incluindo caminho de hierarquia e metadados
Migração Automática: Atualização perfeita do antigo modelo de 3 níveis para o modelo de profundidade ilimitada
Atualizações em Tempo Real: Atualização automática quando os dados mudam

📝 Formulários Ricos de Tarefas (Compatível com MCP v1.7.0)

Seleção de Prioridade: Menu suspenso de escala 1-10 com rótulos descritivos (Mais Baixa a Mais Alta)
Estimativa de Complexidade: Menu suspenso de escala 1-10 com descrições claras de complexidade
Gerenciamento de Status: Seleção visual de status com indicadores de emoji
Entrada de Tags: Gerenciamento de tags separadas por vírgula com texto de ajuda
Rastreamento de Tempo: Horas estimadas e reais com suporte a precisão decimal
Design Responsivo: Layout de duas colunas que se adapta a diferentes tamanhos de tela
Validação em Tempo Real: Validação no lado do cliente com mensagens de erro úteis
Texto de Ajuda: Orientação contextual para todos os campos do formulário

🧠 Gerenciamento de Memória

Busca Baseada em Texto: Encontre memórias usando consultas em linguagem natural com pontuação de relevância
Organização por Categoria: Organize memórias por categoria com estrutura baseada em diretórios
Arquitetura de Título + Conteúdo: Campos separados de título (máx. 50 caracteres) e conteúdo detalhado
Armazenamento em Arquivos JSON: Arquivos JSON legíveis para fácil portabilidade e controle de versão

🔄 Compatibilidade de Dados e Metadados Aprimorados

Compatível com MCP v1.7.0: Suporte completo para metadados aprimorados de tarefas (prioridade, complexidade, status, tags, rastreamento de tempo)
Compatível com Versões Anteriores: Funciona perfeitamente com dados existentes do agentic-tools-mcp
Aprimoramento Progressivo: Novos campos de metadados são opcionais, tarefas existentes continuam funcionando
Mesmos Formatos de Arquivo: Usa a mesma estrutura de diretório .agentic-tools-mcp
Operações Atômicas: Operações de arquivo seguras e atômicas previnem corrupção de dados
Rastreável por Git: Todos os dados podem ser commitados junto com o código do seu projeto

Requisitos

VSCode 1.96.0 ou superior
Uma pasta de workspace aberta
Node.js 18+ (para dependências)

Instalação

Instalação da Extensão

Abra o VS Code
Vá para a visualização de Extensões (Ctrl+Shift+X)
Pesquise por "Agentic Tools MCP Companion"
Clique em "Instalar"
Abra uma pasta de workspace
A barra lateral "Agentic Tools" aparecerá na Barra de Atividades

Instalação para Desenvolvimento (apenas para contribuidores)

Clone ou baixe este repositório de extensão
Abra a pasta da extensão no VS Code
Execute npm install para instalar as dependências
Pressione F5 para executar a extensão em uma nova janela de Host de Desenvolvimento de Extensão
Abra uma pasta de workspace na nova janela

Configuração Completa (Servidor MCP + Extensão)

Para a experiência completa com integração de assistente de IA:

Instale o Servidor MCP: npm install -g @pimzino/agentic-tools-mcp

Configure o Claude Desktop (ou seu cliente MCP preferido):

{
  "mcpServers": {
    "agentic-tools": {
      "command": "npx",
      "args": ["-y", "@pimzino/agentic-tools-mcp"]
    }
  }
}

Instale esta extensão do VS Code (siga os passos acima)
Aproveite a integração perfeita entre a interface visual e os assistentes de IA!

Uso

Primeiros Passos

Abra um Workspace: A extensão requer uma pasta de workspace aberta
Acesse a Barra Lateral: Clique no ícone "Agentic Tools" na Barra de Atividades
Crie Seu Primeiro Projeto: Clique no botão "+" na visualização de Tarefas
Adicione Tarefas e Subtarefas: Clique com o botão direito em projetos e tarefas para adicionar filhos

Gerenciamento Aprimorado de Tarefas

Árvore Visual de Tarefas com Hierarquia Ilimitada

A extensão exibe suas tarefas com indicadores visuais ricos e profundidade ilimitada:

📁 Project: Website Redesign
├── 🔥⚡ Design mockups (L0: Priority: 8, Complexity: 6) [16h] ⏳
│   ├── ✅ Create wireframes (L1) [4h]
│   ├── 🔄 Design high-fidelity mockups (L1) [8h]
│   │   ├── ⏳ Homepage design (L2) [3h]
│   │   ├── ⏳ Product page design (L2) [3h]
│   │   └── ⏳ Contact page design (L2) [2h]
│   └── ⏳ Create design system (L1) [4h]
│       ├── ⏳ Color palette (L2) [1h]
│       ├── ⏳ Typography rules (L2) [1h]
│       └── ⏳ Component library (L2) [2h]
│           ├── ⏳ Button components (L3) [0.5h]
│           ├── ⏳ Form components (L3) [1h]
│           └── ⏳ Navigation components (L3) [0.5h]
├── 🧩 Backend API (L0: Priority: 7, Complexity: 9) [32h] 🚫
│   ├── ⏳ Database schema (L1) [8h]
│   ├── ⏳ User authentication (L1) [12h]
│   └── ⏳ API endpoints (L1) [12h]
└── ✅ Setup development environment (L0: Priority: 9, Complexity: 3) [4h] ✅

Indicadores Visuais:

🔥 Alta Prioridade (8+), ⚡ Prioridade Média (6+)
🧩 Alta Complexidade (8+)
⏳ Pendente, 🔄 Em Andamento, 🚫 Bloqueado, ✅ Concluído
[16h] Exibição de horas estimadas
(L0, L1, L2, L3) Indicadores de nível de hierarquia
Aninhamento de profundidade ilimitada com indentação adequada

Operações de Tarefas

Criar Projeto: Clique no botão "+" no título da visualização de Tarefas
Criar Tarefas Aprimoradas: Formulários ricos com prioridade, complexidade, status, tags e rastreamento de tempo
Editar Itens: Clique com o botão direito em qualquer item e selecione "Editar" para edição abrangente de metadados
Alternar Conclusão: Clique com o botão direito em tarefas/subtarefas e selecione "Alternar Conclusão"
Excluir Itens: Clique com o botão direito e selecione "Excluir" (com confirmação)
Atualizar Visualização: Clique no botão de atualizar para recarregar os dados

Gerenciamento de Pai e Movimentação de Tarefas

A extensão fornece capacidades poderosas para organizar suas tarefas, permitindo selecionar pais durante a criação e mover itens entre diferentes pais:

Seleção de Pai Durante a Criação

Criando Tarefas: Ao criar uma nova tarefa, você pode selecionar a qual projeto ela pertence a partir de uma lista suspensa
Criando Subtarefas: Ao criar uma nova subtarefa, você pode escolher tanto o projeto de destino quanto a tarefa específica dentro desse projeto usando um processo de seleção em duas etapas

Movendo Itens Existentes

Mover Tarefa para Projeto: Clique com o botão direito em qualquer tarefa e selecione "Mover para Projeto" para realocá-la (junto com todas as suas subtarefas) para um projeto diferente
Mover Subtarefa para Tarefa: Clique com o botão direito em qualquer subtarefa e selecione "Mover para Tarefa" para realocá-la para uma tarefa diferente, mesmo entre projetos

Recursos Inteligentes

Movimentos Entre Projetos: Subtarefas podem ser movidas entre tarefas em projetos diferentes sem problemas
Operações em Lote: Ao mover uma tarefa, todas as suas subtarefas são movidas automaticamente com ela
Validação: O sistema previne movimentos inválidos e fornece feedback claro
Diálogos de Confirmação: Movimentos entre projetos são confirmados para prevenir reorganização acidental de dados
Atualização Automática: A visualização em árvore é atualizada automaticamente após movimentos bem-sucedidos

Benefícios

Organização Flexível: Reorganize sua hierarquia de tarefas conforme seu projeto evolui
Reclassificação Fácil: Mova tarefas entre projetos quando as prioridades mudam
Fluxo de Trabalho Eficiente: Não há necessidade de excluir e recriar tarefas quando a estrutura muda
Integridade dos Dados: Todas as relações e status de conclusão são preservados durante os movimentos

Armazenamento de Dados

Todos os dados são armazenados em seu workspace sob .agentic-tools-mcp/:

your-workspace/
├── .agentic-tools-mcp/
│   ├── tasks/
│   │   └── tasks.json      # Projects, tasks, and subtasks
│   └── memories/           # Memory JSON files organized by category
│       ├── general/        # Default category
│       │   ├── memory1.json
│       │   └── memory2.json
│       └── user_preferences/
│           └── settings.json
├── src/
└── package.json

Configurações da Extensão

Esta extensão contribui com as seguintes configurações:

agentic-tools.autoRefresh: Atualizar automaticamente as visualizações quando os arquivos mudam (padrão: true)

Problemas Conhecidos

O monitoramento de arquivos usa polling em vez de eventos nativos do sistema de arquivos
Grandes conjuntos de dados podem impactar o desempenho
A busca de memória diferencia maiúsculas de minúsculas e usa correspondência de texto simples

Arquitetura e Sincronização de Dados

Esta extensão foi projetada para funcionar perfeitamente com o servidor agentic-tools-mcp:

Compatibilidade de Dados

100% Compatível: Usa a mesma estrutura de diretório .agentic-tools-mcp
Mesmos Formatos de Arquivo: Arquivos JSON são intercambiáveis entre a extensão e o servidor MCP
Operações Atômicas: Operações de arquivo seguras previnem corrupção de dados
Sincronização em Tempo Real: Alterações feitas no VS Code ficam imediatamente disponíveis para assistentes de IA

Integração de Fluxo de Trabalho

Criar/Editar no VS Code: Use a bela interface gráfica para gerenciar tarefas e memórias
Acesso do Assistente de IA: Assistentes de IA podem ler e modificar os mesmos dados via servidor MCP
Colaboração em Equipe: Compartilhe dados via Git - ambas as ferramentas funcionam com os mesmos arquivos
Backup e Migração: Armazenamento simples baseado em arquivos viaja com seus projetos

Benefícios de Usar Ambas as Ferramentas

🎯 Gerenciamento Visual: Interface gráfica rica para hierarquias complexas de tarefas
🤖 Integração com IA: Deixe os assistentes de IA ajudarem no planejamento de tarefas e gerenciamento de memória
👥 Colaboração em Equipe: Compartilhe listas de tarefas e memórias via controle de versão
📁 Específico do Projeto: Cada workspace tem seus próprios dados isolados
🔄 Sincronização Bidirecional: Alterações em qualquer ferramenta são refletidas na outra

Projetos Relacionados

⚡ Servidor MCP

Servidor MCP Agentic Tools - O servidor MCP companheiro que permite a integração com assistentes de IA.

Recursos Principais:

🔧 Ferramentas MCP Aprimoradas: Conjunto completo de ferramentas de gerenciamento de tarefas e memórias com suporte a metadados ricos
🤖 Ferramentas Avançadas de Agentes de IA: Análise de PRD, recomendações de tarefas, análise de complexidade, inferência de progresso e capacidades de pesquisa
📦 Pacote NPM: Instalação fácil com npm install -g @pimzino/agentic-tools-mcp
🤖 Suporte a Assistentes de IA: Funciona com Claude Desktop, AugmentCode e outros clientes MCP
🔄 Compatibilidade de Dados: 100% compatível com esta extensão do VS Code

Colaboração Perfeita:

Planejamento Humano: Use a extensão do VS Code para planejamento visual de tarefas com metadados ricos
Execução por IA: Agentes de IA acessam dados abrangentes de tarefas e usam ferramentas avançadas
Integração Perfeita: Sincronização em tempo real entre a interface visual e as capacidades de IA
Fluxo de Trabalho Aprimorado: Criatividade humana + inteligência de IA para produtividade ideal

Desenvolvimento

Para contribuir com esta extensão:

Clone o repositório
Execute npm install para instalar as dependências
Pressione F5 para executar em modo de desenvolvimento
Faça alterações e teste no Host de Desenvolvimento de Extensão

Desenvolvimento com o Servidor MCP

Para testar o ecossistema completo:

Clone ambos os repositórios:

git clone https://github.com/Pimzino/agentic-tools-mcp.git
git clone https://github.com/Pimzino/agentic-tools-mcp-companion.git

Configure o servidor MCP:

cd agentic-tools-mcp
npm install && npm run build

Configure a extensão do VS Code:

cd agentic-tools-mcp-companion
npm install

Teste ambas as ferramentas com os mesmos dados do workspace

Suporte

Para problemas e perguntas, use o rastreador de problemas do GitHub.

Obtendo Ajuda

🐛 Problemas da Extensão: Relate problemas da extensão do VS Code em este repositório
⚡ Problemas do Servidor MCP: Relate problemas do servidor MCP em agentic-tools-mcp
💡 Solicitações de Recursos: Use as discussões do GitHub para solicitações de recursos
📖 Documentação: Consulte a documentação do servidor MCP para referência detalhada da API

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar issues e pull requests.

Faça um fork do repositório
Crie sua branch de feature (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add some amazing feature')
Envie para a branch (git push origin feature/amazing-feature)
Abra um Pull Request

Aproveite o gerenciamento de suas tarefas e memórias com o Agentic Tools MCP Companion!

Parte do ecossistema Agentic Tools - trazendo gerenciamento de tarefas e memórias com IA para o seu fluxo de trabalho.