bmorphism-ies-env

# bmorphism-ies-env Comprehensive documentation and MCP integration for the 31-tool bmorphism/ies flox environment. **Trit**: 0 (ERGODIC) - Infrastructure coordinator **Environment**: `bmorphism/ies` **Package Count**: 31 tools across languages, utilities, and infrastructure --- ## Overview This skill provides documentation, usage patterns, and MCP tooling for the curated bmorphism/ies flox environment. The environment is optimized for: - Multi-language development (Clojure, Julia, Python, Ruby, JavaScript, Java) - Systems programming and reverse engineering - Data processing and visualization - Cloud infrastructure management - Text editing and language tooling --- ## Environment Manifest ### Programming Languages & Runtimes (8 tools) #### babashka (1.12.209) **Purpose**: Fast-starting Clojure scripting without JVM overhead **Use Cases**: - Shell scripting with Clojure syntax - MCP servers (like flox-mcp-server.bb) - Data pipeline orchestration - CI/CD scripts **Example**: ```bash bb -e "(+ 1 2 3)" # => 6 bb script.clj # Run script ``` **Key Features**: - Instant startup (~10ms) - Built-in libraries: cheshire (JSON), babashka.process, babashka.fs - Native image compilation via GraalVM - SCI (Small Clojure Interpreter) for sandboxing **Documentation**: https://book.babashka.org #### clojure (1.12.3.1577) **Purpose**: Full Clojure runtime with JVM **Use Cases**: - Long-running applications - Libraries requiring JVM features - Performance-critical code - Full ecosystem access **Example**: ```bash clj -M -e "(println \"Hello\")" clj -M:deps tree # View dependency tree ``` **Documentation**: https://clojure.org/guides/getting_started #### julia-bin (1.12.3) **Purpose**: High-performance scientific computing **Use Cases**: - Numerical analysis - Category theory (AlgebraicJulia) - DuckDB integration - ACSet manipulation **Example**: ```julia using Catlab, AlgebraicJulia # Work with ACSets ``` **Integration**: Powers the unworld skill's derivational learning **Documentation**: https://docs.julialang.org #### nodejs (24.12.0) **Purpose**: JavaScript runtime and npm ecosystem **Use Cases**: - Web development - CLI tools - MCP servers (TypeScript) - Build tooling **Example**: ```bash node script.js npm install package npx create-next-app ``` **Documentation**: https://nodejs.org/docs #### python312 (3.12.12) **Purpose**: General-purpose scripting and data science **Use Cases**: - Data processing (pandas, numpy) - Machine learning - MCP servers - System automation **Example**: ```bash python3 -m venv .venv pip install duckdb pandas ``` **Documentation**: https://docs.python.org/3.12/ #### ruby (3.3.10) **Purpose**: Scripting and web development **Use Cases**: - Rails applications - DevOps scripts - Text processing - DSLs **Example**: ```bash ruby -e "puts 'Hello'" gem install bundler ``` **Documentation**: https://www.ruby-lang.org/en/documentation/ #### jdk (21.0.8) / openjdk (21.0.8) **Purpose**: Java development and JVM applications **Use Cases**: - Java applications - Clojure (full JVM) - Scala, Kotlin - Enterprise tooling **Example**: ```bash javac Program.java java Program jshell # REPL ``` **Documentation**: https://docs.oracle.com/en/java/javase/21/ --- ### Text Editors & IDEs (2 tools) #### emacs (30.2) **Purpose**: Extensible, programmable text editor **Use Cases**: - Org-mode literate programming - Lisp development - Email, RSS, everything - MCP integration potential **Key Packages** (likely installed): - `org-mode` - Literate programming - `magit` - Git interface - `lsp-mode` - Language servers - `eshell` - Emacs shell **Example**: ```bash emacs file.org emacsclient -c file.jl # With daemon ``` **Integration**: Works with org-babel-execution skill **Documentation**: https://www.gnu.org/software/emacs/manual/ #### helix (25.07.1) **Purpose**: Modern modal text editor (Rust-based) **Use Cases**: - Fast file editing - Language server protocol (LSP) - Multiple selections - Terminal-native editing **Example**: ```bash hx file.rs hx --health rust # Check LSP status ``` **Features**: - Built-in LSP, DAP, tree-sitter - No plugin system needed - Multiple cursors - Vim-like but different **Documentation**: https://docs.helix-editor.com --- ### Developer Tools (5 tools) #### gh (2.83.2) **Purpose**: GitHub CLI **Use Cases**: - PR management from terminal - Issue tracking - Repo operations - CI/CD inspection **Example**: ```bash gh pr create --title "feat: add feature" gh issue list gh run watch gh repo clone user/repo ``` **MCP Integration**: Could wrap as MCP tool for AI PR creation **Documentation**: https://cli.github.com/manual #### graphviz (12.2.1) **Purpose**: Graph visualization **Use Cases**: - Dependency diagrams - State machines - Category theory diagrams - Data flow visualization **Example**: ```bash dot -Tpng graph.dot -o graph.png neato -Tsvg network.dot -o network.svg ``` **Integration**: Visualize skill dependency graphs, coequalizers **Documentation**: https://graphviz.org/documentation/ #### protobuf (32.1) **Purpose**: Protocol Buffers compiler **Use Cases**: - Serialization schemas - gRPC services - Cross-language data exchange - MCP protocol extensions **Example**: ```bash protoc --python_out=. schema.proto protoc --go_out=. service.proto ``` **Documentation**: https://protobuf.dev #### pkg-config (0.29.2) **Purpose**: Library dependency metadata **Use Cases**: - C/C++ compilation - Linking system libraries - Build system integration **Example**: ```bash pkg-config --cflags --libs sqlite3 pkg-config --modversion gtk+-3.0 ``` **Documentation**: https://www.freedesktop.org/wiki/Software/pkg-config/ #### tree-sitter (0.25.10) **Purpose**: Incremental parsing library **Use Cases**: - Syntax highlighting - Code navigation - AST analysis - Language tooling **Example**: ```bash tree-sitter generate tree-sitter test ``` **Integration**: Used by helix, could power code analysis MCP tools **Documentation**: https://tree-sitter.github.io/tree-sitter/ --- ### Disk Usage Analyzers (4 tools) #### dua (2.32.2) **Purpose**: Fast disk usage analyzer (Rust) **Use Cases**: - Interactive TUI for disk exploration - Fast scanning - Deletion from TUI **Example**: ```bash dua i # Interactive mode dua a /path # Aggregate view ``` **Comparison**: Fastest, interactive, can delete **Documentation**: https://github.com/Byron/dua-cli #### dust (1.2.3) **Purpose**: du + rust = dust (modern du) **Use Cases**: - Tree view of disk usage - Colored output - Quick overview **Example**: ```bash dust # Current dir dust -d 3 # Max depth 3 dust -r # Reverse sort ``` **Comparison**: Best for quick visualizations **Documentation**: https://github.com/bootandy/dust #### gdu (5.32.0) **Purpose**: Go-based disk usage analyzer **Use Cases**: - Fast scanning - TUI interface - Export to JSON **Example**: ```bash gdu # Interactive gdu -n # Non-interactive gdu -o json # Export format ``` **Comparison**: Good balance of speed and features **Documentation**: https://github.com/dundee/gdu #### ncdu (2.9.2) **Purpose**: NCurses disk usage (original) **Use Cases**: - Classic TUI - Stable, reliable - Scriptable **Example**: ```bash ncdu # Interactive ncdu -x # Same filesystem only ncdu -o file # Export ``` **Comparison**: Most mature, scriptable **Documentation**: https://dev.yorhel.nl/ncdu **Recommendation**: Use `dust` for quick checks, `dua` for interactive exploration --- ### Multimedia & Content (3 tools) #### ffmpeg (8.0) **Purpose**: Video/audio processing Swiss Army knife **Use Cases**: - Video transcoding - Audio extraction - Streaming - Format conversion **Example**: ```bash ffmpeg -i input.mp4 output.webm ffmpeg -i video.mp4 -vn audio.mp3 # Extract audio ffmpeg -i input.mp4 -ss 00:01:00 -t 10 clip.mp4 # Clip ``` **Integration**: Could power video processing MCP tools **Documentation**: https://ffmpeg.org/documentation.html #### sox (2021-05-09) **Purpose**: Sound eXchange - audio processing **Use Cases**: - Audio effects - Format conversion - Synthesis - Analysis **Example**: ```bash sox input.wav output.mp3 sox input.wav output.wav tempo 1.5 # Speed up play sound.wav # Play audio ``` **Integration**: Sonification of data (catsharp-sonification skill) **Documentation**: http://sox.sourceforge.net/sox.html #### enchant2 (2.6.9) **Purpose**: Spell checking library **Use Cases**: - Text editors - Document processing - CLI spell check - Multiple dictionary support **Example**: ```bash enchant-lsmod-2 # List backends enchant-2 -l file.txt # Check spelling ``` **Integration**: Text validation in documentation skills **Documentation**: https://abiword.github.io/enchant/ --- ### Infrastructure & Cloud (4 tools) #### google-cloud-sdk (548.0.0) **Purpose**: Google Cloud Platform CLI **Use Cases**: - GCP resource management - Cloud Storage - BigQuery - Kubernetes (GKE) **Example**: ```bash gcloud auth login gcloud compute instances list gsutil cp file.txt gs://bucket/ bq query "SELECT * FROM dataset.table LIMIT 10" ``` **MCP Integration**: Wrap GCP operations as MCP tools **Documentation**: https://cloud.google.com/sdk/docs #### nats-server (2.12.3) **Purpose**: NATS message broker **Use Cases**: - Pub/sub messaging - Service mesh - Event streaming - MCP transport layer **Example**: ```bash nats-server # Start server nats-server -js # With JetStream nats-server -c nats-server.conf # Config file ``` **Integration**: Could power distributed MCP server communication **Documentation**: https://docs.nats.io #### tailscale (1.92.3) **Purpose**: Mesh VPN (WireGuard-based) **Use Cases**: - Secure remote access - Service networking - Exit nodes - MagicDNS