Quick status snapshot
Git state, doctor health, CI runs, release tag, and last session note — one fast deterministic command.
v2.1.0 · Context Pack Status
Local command intelligence for MQLaunch.
mq-hal turns natural language into safe JSON intents, then routes them to whitelisted local actions — git state, CI status, release readiness, publish quality, doctor summaries, fix planning, session memory, and timelines.
mansys · Zephyr ~/macos-scripts ❯ mq-hal audit HAL Audit ========= Repo: macos-scripts Version: 0.3.9 Overall: needs_review Publish readiness: 16/16 README score: 50/100 Missing: install section, usage section, examples, roadmap Recommendation -------------- Add README sections: install section, usage section, examples, roadmap. Then rerun mqlaunch hal audit.
What it does
mq-hal is the local HAL brain. mqlaunch is the command surface. The bridge stays thin, and Python validates everything before shell actions happen.
Release readiness
Checks VERSION, CHANGELOG, README badge, git cleanliness, CI status, and latest GitHub release before you tag.
Publish & README quality
Runs repo-signal publish-checklist and readme-score. Derives ready / needs_review / not_ready with actionable recommendations.
Git and CI status
Read-only repo-status (branch, dirty state, commits, tags) and ci (GitHub Actions run list) — no side effects.
Natural language to JSON
Ollama/Qwen3 returns structured JSON intents. The router refuses unknown or unsafe actions.
System health summaries
Runs mqlaunch doctor --json, parses the output, and summarizes health status with safe next steps.
Safe repair plans
Creates copy-paste inspection and verification commands. It never executes repairs automatically.
Local JSONL memory
Stores doctor summaries, fix plans, and notes locally in ~/.mq-hal/session.jsonl.
Compact history view
Shows recent HAL events as a terminal-friendly timeline with filters and JSON output.
Architecture
HAL logic belongs in mq-hal. MQLaunch owns the menu and command surface.
User
Runs mqlaunch hal audit, mqlaunch hal release-brief, mqlaunch hal doctor, or a free HAL prompt.
mqlaunch
Displays the terminal UI and delegates through terminal/bridges/hal-bridge.sh.
mq-hal
Parses commands, calls Ollama when needed, validates intents, and runs allowlisted tools.
Local tools
Uses git, GitHub CLI, repo-signal, mqlaunch doctor, selftest, release-check, and local memory.
Common commands
Run directly through mq-hal, or through mqlaunch hal after the bridge is installed.
mq-hal
mq-hal brief mq-hal release-brief mq-hal audit mq-hal repo-status mq-hal ci mq-hal doctor-summary mq-hal fix-doctor mq-hal session mq-hal last mq-hal timeline mq-hal timeline --details mq-hal remember "release looked good" mq-hal memory-path
mqlaunch bridge
mqlaunch hal mqlaunch hal brief mqlaunch hal release-brief mqlaunch hal audit mqlaunch hal repo-status mqlaunch hal ci mqlaunch hal doctor mqlaunch hal fix-doctor mqlaunch hal session mqlaunch hal last mqlaunch hal timeline mqlaunch hal timeline --details mqlaunch hal remember "release looked good"
Install
Designed for local macOS workflows with Ollama and MQLaunch.
# Install Ollama brew install ollama brew services start ollama # Pull model ollama pull qwen3:4b-instruct # Clone mq-hal git clone https://github.com/MCamner/mq-hal.git ~/mq-hal # Link command mkdir -p ~/bin ln -sf ~/mq-hal/bin/mq-hal ~/bin/mq-hal # Test mq-hal --help mq-hal audit --sample mq-hal release-brief --sample
Safety model
Model proposes. Router decides.
The model never runs shell directly. It returns structured JSON. Python validates the intent and only allowlisted local actions can run.
Local first
No cloud memory.
Session Memory stays local in ~/.mq-hal/session.jsonl. Disable memory per command with --no-memory or by setting MQ_HAL_DISABLE_MEMORY=1.