The Mastermind CLI (scripts/run_mindx.py) provides a comprehensive command-line interface for interacting with the mindX Augmentic Intelligence system. This CLI serves as the primary entry point for orchestrating system evolution, agent deployment, and component management through the MastermindAgent.
Key Features:
cd /path/to/mindX
python scripts/run_mindx.py
System Requirements:
data/config/mindX (Mastermind) >
The CLI operates in an interactive loop, accepting commands until quit or exit is entered.
evolve <directive>Syntax:
evolve <directive_string>
Examples:
evolve Enhance system-wide logging capabilities
evolve Improve error handling across all agents
evolve Add better documentation generation tools
Process Flow:
Output: JSON summary of evolution campaign outcome
deploy <directive>Syntax:
deploy <directive_string>
Examples:
deploy Create a specialized monitoring agent for system health
deploy Deploy agents for automated testing workflow
deploy Initialize agents for continuous integration pipeline
Process Flow:
Output: JSON summary of deployment campaign outcome
introspect <role>Syntax:
introspect <role_description>
Examples:
introspect Senior DevOps Engineer with ML expertise
introspect System Architect focused on microservices
introspect Quality Assurance Specialist for AI systems
Output: Generated persona with characteristics, skills, and behavioral patterns
mastermind_statusSyntax:
mastermind_status
Output:
show_agent_registrySyntax:
show_agent_registry
Output: JSON representation of the agent registry with agent details
analyze_codebase <path> [focus]Syntax:
analyze_codebase <path_to_code> [focus_prompt]
Examples:
analyze_codebase ./tools
analyze_codebase ./core Focus on performance optimization opportunities
analyze_codebase ./agents Identify potential security vulnerabilities
Process Flow:
basegen <path>Syntax:
basegen <path_to_analyze>
Examples:
basegen ./utils
basegen ./core
basegen ./tools
Output: JSON report of documentation generation process
id_listSyntax:
id_list
Output:
id_create <entity_id>Syntax:
id_create <entity_id>
Examples:
id_create test_agent_001
id_create monitoring_service
id_create backup_coordinator
Output:
id_deprecate <public_address> [entity_id_hint]Syntax:
id_deprecate <public_address> [entity_id_hint]
Examples:
id_deprecate 0x1234567890abcdef
id_deprecate 0x1234567890abcdef old_test_agent
Output: Success/failure status of deprecation
coord_query <question>Syntax:
coord_query <your_question>
Examples:
coord_query What is the current system health status?
coord_query Which components need immediate attention?
coord_query How can we improve overall system performance?
Output: LLM-generated response with analysis and recommendations
coord_analyze [context]Syntax:
coord_analyze [optional_context]
Examples:
coord_analyze
coord_analyze Focus on memory usage patterns
coord_analyze Analyze recent error trends
Output: Comprehensive system analysis report
coord_improve <component_id> [context]Syntax:
coord_improve <component_id> [optional_context]
Examples:
coord_improve summarization_tool
coord_improve base_gen_agent Add better error handling
coord_improve memory_agent Optimize storage efficiency
Process Flow:
coord_backlogSyntax:
coord_backlog
Output:
coord_process_backlogSyntax:
coord_process_backlog
Process:
coord_approve <backlog_item_id>Syntax:
coord_approve <backlog_item_id>
Examples:
coord_approve a1b2c3d4
coord_approve 12345678
coord_reject <backlog_item_id>Syntax:
coord_reject <backlog_item_id>
Examples:
coord_reject a1b2c3d4
coord_reject 12345678
agent_create <type> <id> [config_json]Syntax:
agent_create <agent_type> <agent_id> [config_json]
Examples:
agent_create bdi_agent test_agent_001
agent_create monitoring_agent sys_monitor {"interval": 30}
agent_create analysis_agent code_analyzer {"target_path": "./core"}
Process:
agent_delete <id>Syntax:
agent_delete <agent_id>
Examples:
agent_delete test_agent_001
agent_delete old_monitor
Process:
agent_listSyntax:
agent_list
Output:
agent_evolve <id> <directive>Syntax:
agent_evolve <agent_id> <directive>
Examples:
agent_evolve monitor_agent Improve performance monitoring capabilities
agent_evolve test_agent Add comprehensive error logging
agent_sign <id> <message>Syntax:
agent_sign <agent_id> <message>
Examples:
agent_sign test_agent "System status: operational"
agent_sign monitor_agent "Alert: High CPU usage detected"
Output: Cryptographic signature of the message
audit_gemini --test-all|--update-configSyntax:
audit_gemini --test-all
audit_gemini --update-config
Options:
--test-all: Test all available Gemini models--update-config: Update configuration based on audit resultshelpSyntax:
help
Output: Categorized list of all available commands with descriptions
quit / exitSyntax:
quit
exit
Process:
The CLI integrates seamlessly with the BDI parameter processing system:
# User Input
coord_improve summarization_tool Add better error handling
BDI Processing
Context Detection: "summarization_tool" pattern matched
Path Mapping: "summarization" → "tools" directory
Parameter Injection: {"target_component": "summarization_tool", "analysis_context": "Add better error handling"}
Tool Execution: CoordinatorAgent.handle_user_input() with validated parameters
Required environment variables and configuration files:
data/config/.jsondata/memory/ directory structure.env file for private keysKey configuration parameters for optimal performance:
Enable detailed logging for troubleshooting:
# In config files
{
"logging": {
"level": "DEBUG",
"detailed_tracing": true
}
}
# System Health Check Workflow
mastermind_status
show_agent_registry
coord_analyze System health assessment
coord_backlog
coord_process_backlog
Component Improvement Workflow
evolve Improve error handling across all components
coord_improve base_gen_agent Focus on performance optimization
agent_evolve test_agent Add comprehensive monitoring
# Daily Maintenance Routine
id_list
coord_backlog
audit_gemini --test-all
analyze_codebase ./core Performance and security review
This CLI reference is part of the mindX Augmentic Intelligence system. For related information, see BDI Parameter Processing and System Architecture.*