lv24-opencode-consilium (Python launcher)

A thin, dependency-free Python launcher for Consilium, the multi-agent review and audit CLI for the OpenCode ecosystem. Consilium itself is a Node.js command-line tool published on npm as lv24-opencode-consilium. This package does not reimplement Consilium and does not bundle Node.js: the consilium and consilium-mcp commands delegate to the npm package through npx.

The npm package remains the canonical distribution. The PyPI package only contains this launcher, so both installation routes run the same engine and stay in lockstep on the same version.

Prerequisites

• Node.js 18 or newer, including npm and npx (nodejs.org). The launcher uses npx to download and run the npm package, so Node.js is required even though the Python package has no runtime dependencies.
• The OpenCode CLI installed and available on PATH (OpenCode docs).
• Network access on first run, or an npm cache that already contains the requested package, because npx may download it.
• Python 3.9 or newer.

Installation

pip install lv24-opencode-consilium

This installs three console scripts:

• consilium and lv24-opencode-consilium — equivalent CLI entry points.
• consilium-mcp — the stdio MCP server.

Upgrade with pip install --upgrade lv24-opencode-consilium.

Usage

consilium --help
consilium "review this repository"
consilium review --model opencode/gpt-5

All arguments are forwarded unchanged to the npm CLI. The child process inherits the terminal, environment, and exit code. You can also run:

python -m lv24_opencode_consilium --help

If npx cannot be found, the launcher exits with code 127 and prints an installation hint. An interrupted run exits with code 130.

MCP server

consilium-mcp starts the same stdio MCP server as the npm consilium-mcp binary. The launcher runs:

npx --yes --package lv24-opencode-consilium@<version> consilium-mcp

Point an MCP client at the console script. Claude Desktop example (claude_desktop_config.json):

{
  "mcpServers": {
    "consilium": {
      "command": "consilium-mcp",
      "args": []
    }
  }
}

Any stdio MCP client works, including OpenCode, Codex, Cursor and VS Code. stdout carries only the JSON-RPC protocol; logs go to stderr. The Node.js and OpenCode prerequisites above apply to this command as well. You can also run it without the console script:

python -m lv24_opencode_consilium.mcp

Version pinning

By default both launchers run the npm package version matching the Python package version (currently 1.12.1). Override it with CONSILIUM_NPM_VERSION to use any npm version or tag:

CONSILIUM_NPM_VERSION=latest consilium --help
CONSILIUM_NPM_VERSION=1.9.0 consilium --help

PowerShell:

$env:CONSILIUM_NPM_VERSION = "latest"; consilium --help

Links

• Main repository and documentation: https://github.com/LevapVeeskela/lv24-opencode-consilium
• Documentation: https://github.com/LevapVeeskela/lv24-opencode-consilium/tree/master/docs
• Issues: https://github.com/LevapVeeskela/lv24-opencode-consilium/issues
• npm package: https://www.npmjs.com/package/lv24-opencode-consilium
• PyPI package: https://pypi.org/project/lv24-opencode-consilium/
• Releases and changelog: https://github.com/LevapVeeskela/lv24-opencode-consilium/releases

License

MIT