Agentic Tools MCP Companion
About
A VS Code extension with a GUI for the agentic-tools-mcp server, enhancing task and memory management.
Details
- Author
- pimzino
- Categories
- Developer Tools, Project Management, AI, Productivity
Jump to
Development Installation For Contributors Only
- Clone or download this extension repository
- Open the extension folder in VS Code
- Runnpm installto install dependencies
- PressF5to run the extension in a new Extension Development Host window
- Open a workspace folder in the new window
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": ](https://github.com/Pimzino/agentic-tools-mcp)["-y", "@pimzino/agentic-tools-mcp"] } } }
- 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
A VS Code extension with a GUI for the agentic-tools-mcp server, enhancing task and memory management.
A beautiful VS Code extension that provides a comprehensive GUI interface for theagentic-tools-mcpserver 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.
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.
π― 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
- 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-mcpdirectory structure
- Atomic Operations: Safe, atomic file operations prevent data corruption
- Git-trackable: All data can be committed alongside your project code
- VSCode 1.96.0 or higher
- An open workspace folder
- Node.js 18+ (for dependencies)
- 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 - Runnpm installto install dependencies
- PressF5to run the extension in a new Extension Development Host window
- Open a workspace folder in the new window
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"] } } }
- 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
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] β
- π₯ 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
- 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
The extension provides powerful capabilities for organizing your tasks by allowing you to select parents during creation and move items between different parents:
- 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
- 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
- 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
- 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
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
This extension contributes the following settings:
- agentic-tools.autoRefresh: Automatically refresh views when files change (default: true)
- 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
This extension is designed to work seamlessly with theagentic-tools-mcpserver:
- 100% Compatible: Uses identical.agentic-tools-mcpdirectory 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
- 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
- π―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
Agentic Tools MCP Server- The companion MCP server that enables AI assistant integration.
- π§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 withnpm 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
- 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
- Clone the repository
- Runnpm installto install dependencies
- PressF5to run in development mode
- Make changes and test in the Extension Development Host
- Clone both repositories:
git clone https://github.com/Pimzino/agentic-tools-mcp.git git clone https://github.com/Pimzino/agentic-tools-mcp-companion.git
cd agentic-tools-mcp npm install && npm run build
cd agentic-tools-mcp-companion npm install
For issues and questions, please use the GitHub issue tracker.
- πExtension Issues: Report VS Code extension issues atthis repository
- β‘MCP Server Issues: Report MCP server issues atagentic-tools-mcp
- π‘Feature Requests: Use GitHub discussions for feature requests
- πDocumentation: Check theMCP server documentationfor detailed API reference
This project is licensed under the MIT License - see theLICENSEfile for details.
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 theAgentic Tools ecosystem- bringing AI-powered task and memory management to your workflow.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Caches large tool responses to files and returns compact resource links to save LLM context window space.
Hebbian memory for AI agents β learns file access patterns, builds neural pathways, predicts next tools/files, saves tokens
Zero-config session continuity for Claude Code. Auto-captures context via Claude Hooks, provides 24 tools for memory, tasks, solutions, and knowledge graph. Multilingual semantic search (94+ languages).
A persistent development partner that prevents context drift and maintains project memory across all development sessions.
An MCP server for Claude Code CLI that provides persistent session management, entity tracking, and context preservation across development sessions.
Turns your task manager into agent memory: hybrid (RRF) retrieval over TickTick or an Obsidian vault via an adapter contract. MCP server + CLI, no vector DB to maintain.
Provides AI assistants with advanced task management and memory capabilities using local JSON file storage.
Portable, cloud-hosted AI memory you own - structured memories, tasks, goals, and notes that work across Claude, ChatGPT, Gemini, and any MCP client.
FoundersOS - CRM, tasks, finances, feeds, and memory for founders, as an MCP server.
IDE Memory MCP gives AI coding agents a persistent memory layer that works across any IDE supporting the Model Context Protocol. Write project context once β the AI remembers it everywhere.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




