{"id":17032,"library":"metheus-governance-mcp-cli","title":"Metheus Governance MCP CLI","description":"This package provides a command-line interface (CLI) for interacting with the Metheus Governance Micro-Control Plane (MCP). It facilitates tasks such as bootstrapping the environment, managing local chat bot configurations, running health checks, and bridging stdio to the Metheus HTTPS gateway for proxying. The current stable version is 0.2.304, indicating active development. The CLI handles authentication, registration with various AI clients (Codex, Claude, Gemini, Antigravity, Cursor), and local secret management for chat platforms like Telegram, Slack, and KakaoTalk. Its key differentiator is providing a local control plane for Metheus-managed AI governance, allowing for granular configuration of bot roles, AI client bindings, and message routing. While no explicit release cadence is stated, the versioning suggests ongoing updates and enhancements to its capabilities.","status":"active","version":"0.2.304","language":"javascript","source_language":"en","source_url":null,"tags":["javascript"],"install":[{"cmd":"npm install metheus-governance-mcp-cli","lang":"bash","label":"npm"},{"cmd":"yarn add metheus-governance-mcp-cli","lang":"bash","label":"yarn"},{"cmd":"pnpm add metheus-governance-mcp-cli","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package provides a global command-line executable. Functionalities are accessed via shell commands after global npm installation, not via JavaScript `import` statements.","wrong":"import { metheusGovernanceMcpCli } from 'metheus-governance-mcp-cli'","symbol":"metheus-governance-mcp-cli","correct":"metheus-governance-mcp-cli [command] [args]"},{"note":"This is a legacy alias for `metheus-governance-mcp-cli`. While still supported, `metheus-governance-mcp-cli` should be preferred for consistency and future compatibility.","symbol":"metheus-governance-mcp","correct":"metheus-governance-mcp [command] [args]"},{"note":"Subcommands like `doctor` are invoked by appending them to the main CLI executable. Calling 'doctor' directly will result in a 'command not found' error.","wrong":"doctor","symbol":"doctor","correct":"metheus-governance-mcp-cli doctor"},{"note":"The `auth` command handles local Metheus token management. Specific actions like `login` are passed as arguments to the `auth` subcommand.","wrong":"import { auth } from 'metheus-governance-mcp-cli'","symbol":"auth","correct":"metheus-governance-mcp-cli auth login"}],"quickstart":{"code":"npm install -g metheus-governance-mcp-cli@latest\n\n# Run in bootstrap mode to check auth and register clients\nmetheus-governance-mcp-cli\n\n# Alternatively, run end-to-end health checks\nmetheus-governance-mcp-cli doctor\n\n# To log in if your token is missing or expired\nmetheus-governance-mcp-cli auth login\n\n# Example of setting up a local bot environment\nmetheus-governance-mcp-cli bot add my_telegram_bot --provider telegram --role worker","lang":"bash","description":"Installs the CLI globally and demonstrates basic usage for bootstrapping, running health checks, authentication, and adding a new bot."},"warnings":[{"fix":"Prefer using `metheus-governance-mcp-cli` for all commands to ensure future compatibility and align with current best practices.","message":"The legacy command alias `metheus-governance-mcp` is still supported, but new installations and documentation primarily use `metheus-governance-mcp-cli`.","severity":"deprecated","affected_versions":"<0.2.304"},{"fix":"Review and migrate existing Telegram bot configurations to match the new file structure as detailed in the README. Ensure secrets are correctly placed in the per-bot files and global settings in `global.env`.","message":"Configuration files for Telegram bots have been refactored. Global settings now reside in `~/.metheus/telegram-bots/global.env`, while per-bot secrets and server metadata are in `~/.metheus/telegram-bots/<ServerBotName>.env`.","severity":"gotcha","affected_versions":">=0.2.0"},{"fix":"Upgrade your Node.js installation to version 18 or newer using tools like NVM (`nvm install 18 && nvm use 18`) or official installers.","message":"The Node.js version requirement is `>=18.0.0`. Running the CLI with older Node.js versions will result in errors and prevent correct functionality.","severity":"breaking","affected_versions":"<0.2.0"},{"fix":"Ensure local `.env` files only contain bot tokens and local transport options. Avoid adding any project-specific routing metadata to these local files.","message":"Project chat destination identifiers (e.g., `chat_id`, channel names) should not be stored in local environment files (`~/.metheus/*.env`). These are managed server-side by Metheus.","severity":"gotcha","affected_versions":">=0.2.0"}],"env_vars":null,"last_verified":"2026-04-22T00:00:00.000Z","next_check":"2026-07-21T00:00:00.000Z","problems":[{"fix":"Upgrade your Node.js installation to version 18 or newer. For example, using NVM: `nvm install 18 && nvm use 18`.","cause":"Attempting to run the CLI with an outdated Node.js version that does not meet the minimum requirement of 18.0.0.","error":"Error: Node.js version 16.x.x is not supported. Please upgrade to Node.js >=18.0.0."},{"fix":"Run `metheus-governance-mcp-cli auth login` to initiate the authentication process and obtain a valid token.","cause":"The Metheus authentication token required by the CLI is either not present on the system, invalid, or has expired.","error":"Auth token missing or expired. Please log in."},{"fix":"Ensure the package is installed globally using `npm install -g metheus-governance-mcp-cli@latest`. Verify npm's global bin directory is in your PATH.","cause":"The CLI executable is not in your system's PATH, likely due to an incomplete or failed global npm installation.","error":"command not found: metheus-governance-mcp-cli"}],"ecosystem":"npm","meta_description":null}