Madness Interactive

Welcome to the Mad Tinkers Workshop!

A collection of interconnected projects focused on building an ecosystem of AI-powered tools and agents for local development and automation.

Saving Side Quests for Later

One of the most powerful features of our system is the ability to capture spontaneous ideas and "side quests" without derailing your main focus. Whether you're deep in a coding session and suddenly think of a brilliant feature, or you're in a meeting and realize there's a critical bug to fix later - just capture it and keep moving.

This workflow demonstrates how AI agents can seamlessly capture, categorize, and schedule ideas while you maintain your current focus. The captured tasks are automatically organized by project, prioritized by urgency, and can be reviewed when you're ready to tackle them.

Who should check this out?

• You are a tinkerer, and you want to build your own tools and agents.
• You want to use MCP tooling to help you manage your own chaos.
• You are looking for tips and lessons-learned on building with Ai agent workflows.
• You are a maker, and you want to build your own tools and agents.
• You are anyone with too many ideas and not enough time.

Core Projects

🌟 Swarmonomicon

"Talent hits a target no one else can hit; Genius hits a target no one else can see!"

The central nervous system of our glorious hive mind!

Features:

• Async task casting and processing (mqtt_ingest, Operational!)
• Multi-agent consciousness with centralized hivemind registry (currently exaggerated)
• Persistent state management (wip)
• Agent-to-agent telepathy (wip)
• Pre-configured cultists for common rituals:
  • Task domination
  • Git sacrifices (wip)
  • Project genesis (wip)
  • Documentation Summoning (wip)
  • User enlightenment (wip)

🕸️ Omnispindle

"Genius is the ability to put into effect what is on your mind.!"

A distributed task management MCP engine that falcilitates thoughts between minds:

Features:

• Orchestrate tasks across multiple agent incarnations via MCP tooling
• Command resources with an iron fist (Docker deployment)
• Scry real-time metrics from the void (MQTT dials and levers)
• Accept tribute from plugin disciples (wip)
• Enable cross-project consciousness management Dashboard (Coming Very Soon!)

🗂️ Todomill Projectorium

"Men of lofty genius sometimes accomplish the most when they work least, for their minds are occupied with their ideas and the perfection of their conceptions, to which they afterwards give form. - Leonardo da Vinci"

A sub-repository of Omnispindle, Todomill Projectorium is a dashboard for managing todos. Tightly integrated with the Omnispindle MCP server. It enables AI agents to interact with a MongoDB-backed todo list, allowing for review and revision of todos.

Features:

• Project sidebar and overview

• Item editor for todos

• Smart suggestions tab for AI-powered redundancy reduction

• Control panel for project filters and refresh

• Advanced Dashboard Controls:

  • Filter todos by project, status, priority, and date
  • Combine filters for complex queries
  • MQTT-driven actions for creation, refresh, and filter management
  • Global context variables maintain filter state

• Integration with Omnispindle:

  • Omnispindle's Python MCP server enables agent-driven automation and cross-project orchestration

Development Workflow:

• Edit .js and .html files for logic/UI, then copy changes into Node-RED and re-export JSON flows
• Only edit .json files directly for node connections
• Comments in JSON files document the mapping to code files

Future Directions:

• Enhanced AI suggestions using historical data
• User feedback/rating for AI insights
• Team Boards
• Custom filter presets and saved views

See Todomill_projectorium for the full subrepo and its exported flows, code, and documentation.

⚡ Event Systems

Original EventGhost Update

"Ancient magic renewed!"

• Python 3.x compatibility enchantments
• Modern UI/UX transmutations
• Enhanced plugin summoning circles
• Forbidden knowledge documentation

EventGhost-Rust

"The spirit of automation, REBORN IN IRON!"

• Performance that DEFIES PHYSICS
• Modern async SORCERY
• Cross-platform domination
• Fortified security wards
• Rust-forged plugin architecture
• Swarmonomicon neural linkage

🔍 Tinker

"That which peers beyond the veil!"

A testing apparatus that BENDS REALITY to your will:

• Headless and UI manifestations
• Event capture and temporal manipulation
• Agent-based testing rituals
• Swarmonomicon neural interface
• Cross-platform infection vectors
• Plugin system for custom CHAOS SCEN### Mobile Projects

Cogwyrm: The Pocket Madness Interface

"The eye of genius has always a plaintive expression, and its natural language is pathos!"

A handheld portal of CHAOS designed for commanding your Swarmonomicon agents from the comfort of your mobile device. This is a work in progress, and will be updated as we add more features. It aims to be a Tasker plugin enabled interface for mobile automation and Todo management.

🌋 CORE MANIFESTATIONS:

• Cross-dimensional reaching (iOS/Android) powered by React Native's dark arts
• MQTT message summoning & communion circles
• Direct neural links to your agent hivemind
• REAL-TIME monitoring of the cosmic horror you've unleashed
• Seamless psychic bonds with Swarmonomicon's event nexus

🧪 MAD SCIENCE FEATURES:

• Cryptographic wards and binding circles for secure agent interactions
• Customizable command grimoires for frequent incantations
• Temporal logging of all interdimensional communications
• Gesture-based summoning circles for rapid agent deployment
• Emergency containment protocols (just in case)

⚡ FIELD ENHANCEMENTS:

• Haptic feedback when your agents successfully wreak havoc
• Dark mode that would make Lovecraft proud
• Configurable notification runes
• Backup sanctums for your command history
• Quick-access ritual shortcuts

🚀 Getting Started

"Your first steps into BEAUTIFUL MADNESS!"

1. Clone the repository (CAREFULLY):

git clone https://github.com/yourusername/madness_interactive.git
cd madness_interactive  # ENTER AT YOUR OWN RISK

2. Initialize the sub-realities:

git submodule update --init --recursive  # SUMMON THOSE TRAPPED WITHIN

3. Prepare your development sanctum:

# For Rust incarnations
cargo build  # FORGE THE BINARIES!!

# For Python rituals
pip install -r requirements.txt  # BIND THE DEPENDENCIES

4. Install the ELDRITCH GIT HOOKS for automatic status updates:

./scripts/install_git_hooks.sh [path/to/repository]  # BIND THE REPOSITORY TO OUR WILL!!

📁 Project Structure

"The architecture of CHAOS!"

madness_interactive/
├── projects/
│   ├── python/
│   │   ├── [ai_interface/](projects/python/ai_interface/README.md)
│   │   ├── [mcp_server/](projects/python/mcp_server/README.md)
│   │   ├── [EventGhost/](projects/python/EventGhost/README.md)
│   │   ├── [simple-mqtt-server-agent/](projects/python/simple-mqtt-server-agent/README.md)
│   │   ├── [mqtt-get-var/](projects/python/mqtt-get-var/README.md)
│   │   ├── [local-ai/](projects/python/local-ai/README.md)
│   │   ├── [dvtTestKit/](projects/python/dvtTestKit/README.md)
│   │   ├── [SeleniumPageUtilities/](projects/python/SeleniumPageUtilities/README.md)
│   │   ├── [MqttLogger/](projects/python/MqttLogger/README.md)
│   │   ├── [LegoScry/](projects/python/LegoScry/README.md)
│   │   └── games/
│   ├── powershell/
│   │   └── [WinSystemSnapshot/](projects/powershell/WinSystemSnapshot/README.md)
│   ├── lua/
│   │   ├── [hammerspoon/](projects/lua/hammerspoon/README.md)
│   │   └── [LGS_script_template/](projects/lua/LGS_script_template/README.md)
│   ├── rust/
│   │   ├── [Tinker/](projects/rust/Tinker/README.md)
│   │   └── [EventGhost-Rust/](projects/rust/EventGhost-Rust/README.md)
│   ├── common/
│   └── OS/
├── templates/
│   ├── python/
│   ├── rust/
│   └── [future-languages]/
├── docs/
│   ├── python/
│   └── rust/
├── scripts/
│   ├── init_python_project.sh
│   ├── init_rust_project.sh
│   ├── install_git_hooks.sh
│   └── git_hooks_template/
├── theming/
├── prompts/
└── README.md

🤝 Contributing

"Join our council of MAD SCIENTISTS!"

Each project maintains its own arcane guidelines. Consult the respective grimoires for specific instructions.

⚖️ License

"The terms of our DARK BARGAIN!"

Each project may be bound by different cosmic laws. Consult individual project directories for licensing proclamations.

🗺️ Roadmap

"Our path to GLORIOUS CHAOS!"

• Complete Swarmonomicon agent system
• 🔮 Unleash MQTT Commander upon an unsuspecting world
• Develop Omnispindle distributed task system - bin mcp_todo_server
• Complete rebuild of EventGhost-Rust functionality
• Build out Tinker browser
• Improve local AI pipeline tools
• Scribe comprehensive documentation
• Forge integration tests across projects

📬 Contact

"Commune with the VOID!"

For questions, suggestions, or to join our GLORIOUS CAUSE:

1. Summon an issue in the relevant project repository
2. Join our hivemind discussions
3. Contact the mad scientists directly

---

"The difference between madness and genius is measured only by success!" - Unknown Mad Scientist