mtrx-cli 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# `mtrx-cli`
+
+`mtrx-cli` installs the `mtrx` command from npm.
+
+## Install
+
+Global install:
+
+```bash
+npm install -g mtrx-cli
+mtrx help
+```
+
+One-off execution:
+
+```bash
+npx mtrx-cli help
+```
+
+Local project install:
+
+```bash
+npm install --save-dev mtrx-cli
+npx mtrx help
+```
+
+## Requirements
+
+- Node.js 18+
+- Python 3.10+ available as `python3`, `python`, or `py -3`
+
+This npm package is a thin wrapper around the Python CLI bundled in this repo.

package/bin/mtrx.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const path = require('node:path');
+
+const packageRoot = path.resolve(__dirname, '..');
+const pythonPathEntry = path.join(packageRoot, 'src');
+const cliArgs = process.argv.slice(2);
+
+function pythonCandidates() {
+  if (process.platform === 'win32') {
+    return [
+      { command: 'py', prefixArgs: ['-3'] },
+      { command: 'python', prefixArgs: [] },
+      { command: 'python3', prefixArgs: [] },
+    ];
+  }
+  return [
+    { command: 'python3', prefixArgs: [] },
+    { command: 'python', prefixArgs: [] },
+  ];
+}
+
+function probePython(candidate) {
+  const result = spawnSync(
+    candidate.command,
+    [
+      ...candidate.prefixArgs,
+      '-c',
+      'import json,sys; print(json.dumps({"major": sys.version_info[0], "minor": sys.version_info[1]}))',
+    ],
+    {
+      encoding: 'utf8',
+    },
+  );
+
+  if (result.error || result.status !== 0) {
+    return null;
+  }
+
+  try {
+    const version = JSON.parse((result.stdout || '').trim());
+    return { ...candidate, version };
+  } catch {
+    return null;
+  }
+}
+
+function findPython() {
+  let bestUnsupported = null;
+
+  for (const candidate of pythonCandidates()) {
+    const probed = probePython(candidate);
+    if (!probed) {
+      continue;
+    }
+    const { major, minor } = probed.version;
+    if (major > 3 || (major === 3 && minor >= 10)) {
+      return probed;
+    }
+    if (!bestUnsupported) {
+      bestUnsupported = probed;
+    }
+  }
+
+  return bestUnsupported;
+}
+
+function buildEnv() {
+  const env = { ...process.env };
+  const existingPythonPath = env.PYTHONPATH;
+  env.PYTHONPATH = existingPythonPath
+    ? `${pythonPathEntry}${path.delimiter}${existingPythonPath}`
+    : pythonPathEntry;
+  return env;
+}
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+const python = findPython();
+
+if (!python) {
+  fail(
+    'mtrx-cli requires Python 3.10+ in PATH. Install Python 3.10+ and retry.',
+  );
+}
+
+if (python.version.major < 3 || (python.version.major === 3 && python.version.minor < 10)) {
+  fail(
+    `mtrx-cli requires Python 3.10+. Found ${python.command} ${python.version.major}.${python.version.minor}.`,
+  );
+}
+
+const result = spawnSync(
+  python.command,
+  [...python.prefixArgs, '-m', 'matrx.cli.main', ...cliArgs],
+  {
+    stdio: 'inherit',
+    env: buildEnv(),
+  },
+);
+
+if (result.error) {
+  fail(`Failed to launch the Python MATRX CLI: ${result.error.message}`);
+}
+
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "mtrx-cli",
+  "version": "0.1.0",
+  "description": "MATRX CLI for routing Codex and Claude through Matrx",
+  "homepage": "https://mtrx.so",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vinaynarahari/matrx.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vinaynarahari/matrx/issues"
+  },
+  "keywords": [
+    "matrx",
+    "cli",
+    "codex",
+    "claude",
+    "ai"
+  ],
+  "bin": {
+    "mtrx": "bin/mtrx.js"
+  },
+  "files": [
+    "bin/mtrx.js",
+    "src/matrx/__init__.py",
+    "src/matrx/cli/__init__.py",
+    "src/matrx/cli/launcher.py",
+    "src/matrx/cli/main.py",
+    "src/matrx/cli/state.py"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/matrx/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

package/src/matrx/cli/__init__.py

@@ -0,0 +1,2 @@
+"""Launcher CLI for Matrx-managed tool routing."""
+