lynkr/bin/cli.js

Self-hosted LLM gateway and tier-routing proxy for Claude Code, Cursor, and Codex. Routes across Ollama, AWS Bedrock, OpenRouter, Databricks, Azure OpenAI, llama.cpp, and LM Studio with prompt caching, MCP tools, and 60-80% cost savings.

#!/usr/bin/env node

const path = require("path");
const pkg = require('../package.json');

// Subcommands. Dispatched before server boot so `lynkr usage` / `lynkr trajectory`
// don't start the proxy. Add new subcommands here, not in scattered binaries.
const SUBCOMMANDS = {
  usage:      path.join(__dirname, "lynkr-usage.js"),
  trajectory: path.join(__dirname, "lynkr-trajectory.js"),
};

const sub = process.argv[2];
if (sub && Object.prototype.hasOwnProperty.call(SUBCOMMANDS, sub)) {
  process.argv.splice(2, 1); // drop the subcommand token so the script's own arg parser is happy
  require(SUBCOMMANDS[sub]);
  return;
}

if (process.argv.includes('--version') || process.argv.includes('-v')) {
  console.log(pkg.version);
  process.exit(0);
}

if (process.argv.includes('--help') || process.argv.includes('-h')) {
  console.log(`
${pkg.name} v${pkg.version}

${pkg.description}

Usage:
  lynkr [options]                  Start the proxy server (default)
  lynkr usage [options]            Show AI spend report and tier-routing savings
  lynkr trajectory [options]       Export agent trajectories as JSONL training data

Options:
  -h, --help      Show this help message
  -v, --version   Show version number
  --cluster       Enable cluster mode (multi-core)
  --workers N     Number of worker processes (default: auto)

Environment Variables:
  CLUSTER_ENABLED=true    Enable multi-core cluster mode
  CLUSTER_WORKERS=auto    Worker count (auto = CPU cores - 1)
  See .env.example for all configuration options

Documentation:
  ${pkg.homepage}
`);
  process.exit(0);
}

// CLI flags for cluster mode
if (process.argv.includes('--cluster')) {
  process.env.CLUSTER_ENABLED = 'true';
}
const workersIdx = process.argv.indexOf('--workers');
if (workersIdx !== -1 && process.argv[workersIdx + 1]) {
  process.env.CLUSTER_WORKERS = process.argv[workersIdx + 1];
}

require("../index.js");