ruvnet/ruflo · error · ProxyNotInstalledError

meta-proxy is not installed. Run: ruflo proxy install

Error message

meta-proxy is not installed. Run: ruflo proxy install

What it means

Error "meta-proxy is not installed. Run: ruflo proxy install" thrown in ruvnet/ruflo.

Source

Thrown at v3/@claude-flow/cli/src/proxy/lifecycle.ts:59

} from './paths.js';

export class ProxyNotInstalledError extends Error {
  constructor() {
    super('meta-proxy is not installed. Run: ruflo proxy install');
    this.name = 'ProxyNotInstalledError';
  }
}

export class ProxyAlreadyRunningError extends Error {
  constructor(public readonly pid: number) {
    super(`meta-proxy is already running (pid ${pid}). Stop it first with: ruflo proxy stop`);
    this.name = 'ProxyAlreadyRunningError';
  }
}

function requireBinary(): string {
  const bin = proxyBinaryPath();
  if (!fs.existsSync(bin)) throw new ProxyNotInstalledError();
  return bin;
}

/** Signal-0 liveness probe — cross-platform in Node, throws if the process is dead. */
function isProcessRunning(pid: number): boolean {
  try {
    process.kill(pid, 0);
    return true;
  } catch {
    return false;
  }
}

export interface ProxyStatus {
  installed: boolean;
  running: boolean;
  pid: number | null;
  stalePidFile: boolean;

View on GitHub (pinned to 6b01dc5a68)

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/proxy/lifecycle.ts:59 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@6b01dc5a68 (2026-08-12). Data as JSON: /api/errors/ea357c3629018150. Report an issue: GitHub.