TOOLS_INDEX.md · 10.2 KB
MindX Tools Index
Comprehensive Tool Documentation Index
This document provides a complete index of all tools in the mindX system, with links to detailed documentation for each tool.
Last Updated: 2026-01-11
Total Tools: 31+
📚 Documentation Status
✅ Fully Documented Tools
CLI Command Tool - Meta-tool for executing system CLI commands
Shell Command Tool - Secure shell command execution
Web Search Tool - Google Custom Search integration
Tree Agent - Secure directory navigation
Summarization Tool - LLM-powered text summarization
Note Taking Tool - Agent-specific note management
GitHub Agent Tool - GitHub backup and restore coordination
System Health Tool - System monitoring and health checks
Audit and Improve Tool - Code auditing and improvement
Memory Analysis Tool - Memory pattern analysis
Business Intelligence Tool - Business metrics and KPIs
Augmentic Intelligence Tool - Comprehensive system orchestration and self-improvement
Strategic Analysis Tool - Strategic business analysis and decision support
Agent Factory Tool - Dynamic agent creation with full lifecycle management
Tool Factory Tool - Dynamic tool creation and registry management
Registry Manager Tool - Comprehensive tool and agent registry management with model cards
Registry Sync Tool - Synchronize runtime and persistent registries with cryptographic identities
Tool Registry Manager - Simplified tool registry management
System Analyzer Tool - Holistic system analysis with LLM-powered insights
Optimized Audit Gen Agent - Specialized code auditing with chunking
LLM Tool Manager - LLM tool registry management with model cards
Token Calculator Tool (Robust) - Enhanced token counting and cost calculation
Identity Sync Tool - Comprehensive identity synchronization
User Persistence Manager - Wallet-based user management with signature verification
Prompt Tool - Manages, stores, and executes prompts as first-class infrastructure
Persona Agent - Enables adoption and maintenance of different personas with distinct cognitive patterns
Avatar Agent - Generates avatars for agents and participants using image/video generation APIs, integrated with PromptTool and PersonaAgent
A2A Tool - Enables standardized agent-to-agent communication following the A2A protocol
MCP Tool - Provides Model Context Protocol support for structured context provision to agents
Ollama Cloud Tool - Cloud inference via Ollama (chat, generate, embed, model discovery). Gives any agent access to 120B+ parameter models via Ollama cloud with adaptive rate limiting, 18dp precision metrics, and branch-ready design for peripheral agents. Source: tools/cloud/ollama_cloud_tool.py
Hostinger VPS Agent - VPS management via three MCP channels: SSH (shell access), Hostinger API (restart, metrics, backups), mindX Backend (health, diagnostics, activity). Persistent connection state across sessions. MCP tool registration for agent discovery. Source: agents/hostinger_vps_agent.py, definition: agents/hostinger.vps.agent
📝 Partially Documented Tools
Base Gen Agent - Codebase documentation generator (see base_gen_agent.md)
🔄 Tools Pending Documentation
All major tools have been documented! The following tools have partial documentation or are covered in other documents:
Base Gen Agent - Has existing documentation in base_gen_agent.md (comprehensive)
🗂️ Tool Categories
1. Command Execution Tools
CLI Command Tool - System CLI command execution
Shell Command Tool - Shell command execution with security
2. File System Tools
Tree Agent - Directory navigation and file search
3. Information Retrieval Tools
Web Search Tool - Web search capabilities
Summarization Tool - Text summarization
4. Development Tools
Audit and Improve Tool - Code auditing
Base Gen Agent - Documentation generation
Augmentic Intelligence Tool - Comprehensive development
5. System Management Tools
System Health Tool - Health monitoring
System Analyzer Tool - System analysis
Registry Manager Tool - Registry management
6. Agent Management Tools
Agent Factory Tool - Agent creation
Tool Factory Tool - Tool creation
7. Analysis Tools
Memory Analysis Tool - Memory analysis
Business Intelligence Tool - Business metrics
Strategic Analysis Tool - Strategic planning
8. Version Control Tools
GitHub Agent Tool - GitHub operations
9. Utility Tools
Note Taking Tool - Note management
Token Calculator Tool - Token usage
Identity Sync Tool - Identity management
User Persistence Manager - User data
10. Cognition & Communication Tools
Prompt Tool - Prompt management and execution
Persona Agent - Persona adoption and management
Avatar Agent - Avatar generation for agents/participants
A2A Tool - Agent-to-agent communication protocol
MCP Tool - Model Context Protocol support
📊 Tool Status Matrix
| Tool | Status | Documentation | Tests | Priority |
| CLI Command Tool | ✅ Active | ✅ Complete | ⚠️ Partial | High |
| Shell Command Tool | ✅ Active | ✅ Complete | ⚠️ Partial | High |
| Web Search Tool | ✅ Active | ✅ Complete | ⚠️ Partial | Medium |
| Tree Agent | ✅ Active | ✅ Complete | ❌ None | Medium |
| Summarization Tool | ✅ Active | ✅ Complete | ⚠️ Partial | Medium |
| Note Taking Tool | ✅ Active | ✅ Partial | ⚠️ Partial | Medium |
| GitHub Agent Tool | ✅ Active | ✅ Complete | ✅ Complete | High |
| Base Gen Agent | ✅ Active | ✅ Partial | ⚠️ Partial | High |
| System Health Tool | ✅ Active | ⚠️ Partial | ❌ None | High |
| Memory Analysis Tool | ✅ Active | ⚠️ Partial | ❌ None | Medium |
| Business Intelligence Tool | ✅ Active | ⚠️ Partial | ❌ None | Low |
| Audit and Improve Tool | ✅ Active | ❌ None | ⚠️ Partial | High |
| Augmentic Intelligence Tool | ✅ Active | ❌ None | ⚠️ Partial | High |
| Strategic Analysis Tool | ✅ Active | ❌ None | ❌ None | Medium |
| Registry Manager Tool | ✅ Active | ✅ Complete | ❌ None | Medium |
| Agent Factory Tool | ✅ Active | ✅ Complete | ❌ None | High |
| Tool Factory Tool | ✅ Active | ✅ Complete | ❌ None | High |
| Prompt Tool | ✅ Active | ✅ Complete | ❌ None | High |
| Persona Agent | ✅ Active | ✅ Complete | ❌ None | High |
| Avatar Agent | ✅ Active | ✅ Complete | ❌ None | Medium |
| A2A Tool | ✅ Active | ✅ Complete | ❌ None | High |
| MCP Tool | ✅ Active | ✅ Complete | ❌ None | High |
🔄 Documentation Progress
Completed (29+ tools)
✅ CLI Command Tool
✅ Shell Command Tool
✅ Web Search Tool
✅ Tree Agent
✅ Summarization Tool
✅ Note Taking Tool
✅ GitHub Agent Tool
✅ System Health Tool
✅ Memory Analysis Tool
✅ Business Intelligence Tool
✅ Audit and Improve Tool
✅ Augmentic Intelligence Tool
✅ Strategic Analysis Tool
✅ Registry Manager Tool
✅ Registry Sync Tool
✅ Tool Registry Manager
✅ System Analyzer Tool
✅ Optimized Audit Gen Agent
✅ LLM Tool Manager
✅ Token Calculator Tool (Robust)
✅ Identity Sync Tool
✅ User Persistence Manager
✅ Agent Factory Tool
✅ Tool Factory Tool
✅ Prompt Tool
✅ Persona Agent
✅ Avatar Agent
✅ A2A Tool
✅ MCP Tool
In Progress (1 tool)
🔄 Base Gen Agent (has existing documentation)
Pending (0 tools)
All major tools have been documented!
📖 How to Use This Index
Find a Tool: Use the categories or status matrix to locate tools
Read Documentation: Click on tool names to view detailed documentation
Check Status: Review the status matrix for tool health
Contribute: Add documentation for undocumented tools
🎯 Next Steps
✅ Complete documentation for all tools - DONE!
Add usage examples to all tool documentation
Create integration guides for tool combinations (especially PromptTool + PersonaAgent + AvatarAgent, and A2A + MCP)
Add troubleshooting sections to all documentation
Create test suites for new tools (A2A, MCP, Prompt, Persona, Avatar)
Add integration examples showing A2A + MCP usage patterns
📝 Documentation Standards
All tool documentation should include:
Overview - Purpose and high-level description
Architecture - Design principles and components
Usage - Code examples and common patterns
Configuration - Setup and configuration options
Security - Security considerations and best practices
Limitations - Known limitations and workarounds
Integration - How to integrate with other tools/agents
Examples - Real-world usage examples
Technical Details - Implementation details
Future Enhancements - Planned improvements
🔗 Related Documentation
Tools Registry Reference - Official tools registry
Tools Ecosystem Review - Comprehensive ecosystem overview
BDI Agent Documentation - How agents use tools
Mastermind Agent Guide - Tool orchestration
Note: This index is actively maintained. Tools are being documented and improved systematically. Check back regularly for updates.
Referenced in this document