BLUX Commander

BLUX Commander — Enterprise Developer & AI Orchestration Cockpit

The bridge between mind and machine. The map that moves.

Overview

BLUX Commander delivers a unified cockpit for orchestrating the BLUX ecosystem. Developers and operators can visualize subsystems, run AI-assisted terminals, and automate workflows across Guard, Lite, Doctrine, Quantum, cA, and Reg components.

Highlights

• Commander Core – Chain BLUX workflows while sharing runtime context.
• Multi-Pane Cockpit – Operate a Textual dashboard with terminal, logs, telemetry, and plugin panes.
• AI Developer Shell – Launch sandboxed Python and system environments.
• Commander API – Expose orchestration endpoints over FastAPI.
• Plugin Framework – Discover, validate, and execute external modules.
• Telemetry Dashboard – Capture metrics via SQLite/JSONL and Prometheus exporters.

Repository File Tree

├── .github
│   └── workflows
│       ├── ci.yml
│       ├── docs.yml
│       └── release.yml
├── .gitignore
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── blux_commander
│   ├── __init__.py
│   ├── cli.py
│   ├── core
│   │   ├── api.py
│   │   ├── commander.py
│   │   ├── config.py
│   │   ├── plugins.py
│   │   ├── shell.py
│   │   ├── telemetry.py
│   │   └── tui.py
│   ├── integrations
│   │   ├── ca.py
│   │   ├── doctrine.py
│   │   ├── guard.py
│   │   ├── lite.py
│   │   ├── quantum.py
│   │   └── reg.py
│   ├── ui
│   │   ├── panels
│   │   │   ├── ai_panel.py
│   │   │   ├── logs_panel.py
│   │   │   ├── plugins_panel.py
│   │   │   ├── telemetry_panel.py
│   │   │   └── terminal_panel.py
│   │   └── themes
│   │       ├── default.tcss
│   │       └── highcontrast.tcss
│   └── web
│       ├── server.py
│       ├── static
│       │   └── assets
│       │       └── style.css
│       └── templates
│           └── index.html
├── docs
│   ├── API.md
│   ├── ARCHITECTURE.md
│   ├── CONFIGURATION.md
│   ├── INSTALL.md
│   ├── INTEGRATIONS.md
│   ├── OPERATIONS.md
│   ├── ROADMAP.md
│   ├── SECURITY.md
│   ├── THEMES.md
│   ├── TROUBLESHOOTING.md
│   └── index.md
├── mkdocs.yml
├── pyproject.toml
├── scripts
│   ├── build_docs.sh
│   ├── gen_filetree.py
│   ├── run_tui_demo.py
│   └── update_readme_filetree.py
└── tests
    ├── fixtures
    ├── test_cli.py
    ├── test_plugins.py
    ├── test_shell.py
    └── test_tui.py

Run python scripts/update_readme_filetree.py to regenerate the tree after modifying the project structure.

Quick Start

pip install -e .[dev]
bluxq cmd status
bluxq cmd dashboard

See the documentation for installation, operations, and integration details.