Agentic Tools MCP Companion

A beautiful VS Code extension that provides a comprehensive GUI interface for the agentic-tools-mcp server functionality. This extension allows you to manage tasks and memories directly from VS Code with an intuitive, visual interface featuring enhanced task metadata, priority management, and rich form editors.

🔗 Ecosystem

This VS Code extension is part of a complete task and memory management ecosystem:

🖥️ VS Code Extension (this repository) - Beautiful GUI interface for managing tasks and memories
⚡ MCP Server - Command-line tools and API for AI assistants

💡 Pro Tip: Use both together for the ultimate productivity experience! The MCP server enables AI assistant integration while this extension provides a visual interface.

Features

🎯 Enhanced Task Management with Unlimited Hierarchy (v0.1.0)

Unlimited Hierarchy Tree View: Projects → Tasks → Subtasks → Sub-subtasks → infinite depth nesting
Unified Task Model: Single task interface supporting unlimited nesting depth with rich visual indicators
Level-Based Visual Indicators: Different icons and indentation for each hierarchy level (L0, L1, L2, etc.)
Enhanced Task Metadata: Priority (1-10), complexity (1-10), status workflow, tags, and time tracking at every level
Visual Status Indicators: ⏳ Pending, 🔄 In Progress, 🚫 Blocked, ✅ Done with emoji display
Priority & Complexity Badges: 🔥 High Priority (8+), ⚡ Medium Priority (6+), 🧩 High Complexity (8+)
Rich Form Editors: Comprehensive forms with responsive design and validation
Time Tracking: Estimated and actual hours with decimal precision
Tag Management: Comma-separated tag input for categorization and filtering
Unlimited Depth Operations: Create, edit, move, and delete tasks at any hierarchy level
Parent Selection & Management: Choose parent tasks at any hierarchy level during creation
Hierarchy Reorganization: Move tasks between any hierarchy levels seamlessly
Rich Tooltips: Hover to see complete task information including hierarchy path and metadata
Automatic Migration: Seamless upgrade from old 3-level to unlimited depth model
Real-time Updates: Automatic refresh when data changes

📝 Rich Task Forms (MCP v1.7.0 Compatible)

Priority Selection: 1-10 scale dropdown with descriptive labels (Lowest to Highest)
Complexity Estimation: 1-10 scale dropdown with clear complexity descriptions
Status Management: Visual status selection with emoji indicators
Tag Input: Comma-separated tag management with helper text
Time Tracking: Estimated and actual hours with decimal precision support
Responsive Design: Two-column layout that adapts to different screen sizes
Real-time Validation: Client-side validation with helpful error messages
Helper Text: Contextual guidance for all form fields

🧠 Memory Management

Text-based Search: Find memories using natural language queries with relevance scoring
Category Organization: Organize memories by category with directory-based structure
Title + Content Architecture: Separate title (50 chars max) and detailed content fields
JSON File Storage: Human-readable JSON files for easy portability and version control

🔄 Data Compatibility & Enhanced Metadata

MCP v1.7.0 Compatible: Full support for enhanced task metadata (priority, complexity, status, tags, time tracking)
Backward Compatible: Works seamlessly with existing agentic-tools-mcp data
Progressive Enhancement: New metadata fields are optional, existing tasks continue to work
Same File Formats: Uses identical .agentic-tools-mcp directory structure
Atomic Operations: Safe, atomic file operations prevent data corruption
Git-trackable: All data can be committed alongside your project code

Requirements

VSCode 1.96.0 or higher
An open workspace folder
Node.js 18+ (for dependencies)

Installation

Extension Installation

Open VS Code
Go to Extensions view (Ctrl+Shift+X)
Search for "Agentic Tools MCP Companion"
Click "Install"
Open a workspace folder
The "Agentic Tools" sidebar will appear in the Activity Bar

Development Installation (for contributors only)

Clone or download this extension repository
Open the extension folder in VS Code
Run npm install to install dependencies
Press F5 to run the extension in a new Extension Development Host window
Open a workspace folder in the new window

Complete Setup (MCP Server + Extension)

For the full experience with AI assistant integration:

Install MCP Server: npm install -g @pimzino/agentic-tools-mcp

Configure Claude Desktop (or your preferred MCP client):

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

Install this VS Code extension (follow steps above)
Enjoy seamless integration between visual interface and AI assistants!

Usage

Getting Started

Open a Workspace: The extension requires an open workspace folder
Access the Sidebar: Click the "Agentic Tools" icon in the Activity Bar
Create Your First Project: Click the "+" button in the Tasks view
Add Tasks and Subtasks: Right-click on projects and tasks to add children

Enhanced Task Management

Visual Task Tree with Unlimited Hierarchy

The extension displays your tasks with rich visual indicators and unlimited depth:

📁 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] ✅

Visual Indicators:

🔥 High Priority (8+), ⚡ Medium Priority (6+)
🧩 High Complexity (8+)
⏳ Pending, 🔄 In Progress, 🚫 Blocked, ✅ Done
[16h] Estimated hours display
(L0, L1, L2, L3) Hierarchy level indicators
Unlimited depth nesting with proper indentation

Task Operations

Create Project: Click the "+" button in the Tasks view title
Create Enhanced Tasks: Rich forms with priority, complexity, status, tags, and time tracking
Edit Items: Right-click any item and select "Edit" for comprehensive metadata editing
Toggle Completion: Right-click tasks/subtasks and select "Toggle Completion"
Delete Items: Right-click and select "Delete" (with confirmation)
Refresh View: Click the refresh button to reload data

Parent Management & Moving Tasks

The extension provides powerful capabilities for organizing your tasks by allowing you to select parents during creation and move items between different parents:

Parent Selection During Creation

Creating Tasks: When creating a new task, you can select which project it belongs to from a dropdown list
Creating Subtasks: When creating a new subtask, you can choose both the target project and the specific task within that project using a two-step selection process

Moving Existing Items

Move Task to Project: Right-click any task and select "Move to Project" to relocate it (along with all its subtasks) to a different project
Move Subtask to Task: Right-click any subtask and select "Move to Task" to relocate it to a different task, even across projects

Smart Features

Cross-Project Moves: Subtasks can be moved between tasks in different projects seamlessly
Batch Operations: When moving a task, all its subtasks move with it automatically
Validation: The system prevents invalid moves and provides clear feedback
Confirmation Dialogs: Cross-project moves are confirmed to prevent accidental data reorganization
Automatic Refresh: The tree view updates automatically after successful moves

Benefits

Flexible Organization: Reorganize your task hierarchy as your project evolves
Easy Reclassification: Move tasks between projects when priorities change
Efficient Workflow: No need to delete and recreate tasks when structure changes
Data Integrity: All relationships and completion status are preserved during moves

Data Storage

All data is stored in your workspace under .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

Extension Settings

This extension contributes the following settings:

agentic-tools.autoRefresh: Automatically refresh views when files change (default: true)

Known Issues

File watching uses polling instead of native file system events
Large datasets may impact performance
Memory search is case-sensitive and uses simple text matching

Architecture & Data Synchronization

This extension is designed to work seamlessly with the agentic-tools-mcp server:

Data Compatibility

100% Compatible: Uses identical .agentic-tools-mcp directory structure
Same File Formats: JSON files are interchangeable between extension and MCP server
Atomic Operations: Safe file operations prevent data corruption
Real-time Sync: Changes made in VS Code are immediately available to AI assistants

Workflow Integration

Create/Edit in VS Code: Use the beautiful GUI to manage tasks and memories
AI Assistant Access: AI assistants can read and modify the same data via MCP server
Team Collaboration: Share data via Git - both tools work with the same files
Backup & Migration: Simple file-based storage travels with your projects

Benefits of Using Both Tools

🎯 Visual Management: Rich GUI for complex task hierarchies
🤖 AI Integration: Let AI assistants help with task planning and memory management
👥 Team Collaboration: Share task lists and memories via version control
📁 Project-Specific: Each workspace has its own isolated data
🔄 Bidirectional Sync: Changes in either tool are reflected in the other

⚡ MCP Server

Agentic Tools MCP Server - The companion MCP server that enables AI assistant integration.

Key Features:

🔧 Enhanced MCP Tools: Complete set of task and memory management tools with rich metadata support
🤖 Advanced AI Agent Tools: PRD parsing, task recommendations, complexity analysis, progress inference, and research capabilities
📦 NPM Package: Easy installation with npm install -g @pimzino/agentic-tools-mcp
🤖 AI Assistant Support: Works with Claude Desktop, AugmentCode, and other MCP clients
🔄 Data Compatibility: 100% compatible with this VS Code extension

Perfect Collaboration:

Human Planning: Use VS Code extension for visual task planning with rich metadata
AI Execution: AI agents access comprehensive task data and use advanced tools
Seamless Integration: Real-time sync between visual interface and AI capabilities
Enhanced Workflow: Human creativity + AI intelligence for optimal productivity

Development

To contribute to this extension:

Clone the repository
Run npm install to install dependencies
Press F5 to run in development mode
Make changes and test in the Extension Development Host

Development with MCP Server

For testing the complete ecosystem:

Clone both repositories:

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

Set up the MCP server:

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

Set up the VS Code extension:

cd agentic-tools-mcp-companion
npm install

Test both tools with the same workspace data

Support

For issues and questions, please use the GitHub issue tracker.

Getting Help

🐛 Extension Issues: Report VS Code extension issues at this repository
⚡ MCP Server Issues: Report MCP server issues at agentic-tools-mcp
💡 Feature Requests: Use GitHub discussions for feature requests
📖 Documentation: Check the MCP server documentation for detailed API reference

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Enjoy managing your tasks and memories with Agentic Tools MCP Companion!

Part of the Agentic Tools ecosystem - bringing AI-powered task and memory management to your workflow.

Agentic Tools MCP Companion

Pimzino

Agentic Tools MCP Companion

🔗 Ecosystem

Features

🎯 Enhanced Task Management with Unlimited Hierarchy (v0.1.0)

📝 Rich Task Forms (MCP v1.7.0 Compatible)

🧠 Memory Management

🔄 Data Compatibility & Enhanced Metadata

Requirements

Installation

Extension Installation

Development Installation (for contributors only)

Complete Setup (MCP Server + Extension)

Usage

Getting Started

Enhanced Task Management

Visual Task Tree with Unlimited Hierarchy

Task Operations

Parent Management & Moving Tasks

Parent Selection During Creation

Moving Existing Items

Smart Features

Benefits

Data Storage

Extension Settings

Known Issues

Architecture & Data Synchronization

Data Compatibility

Workflow Integration

Benefits of Using Both Tools

Related Projects

⚡ MCP Server

Development

Development with MCP Server

Support

Getting Help

License

Contributing