ruvnet/ruflo · error · GtBridgeError

COMMAND_NOT_FOUND

COMMAND_NOT_FOUND

Error message

Failed to verify gt installation

What it means

GtBridge.initialize() ran 'gt version' to confirm the gt CLI is installed and usable, and the check came back unsuccessful (binary missing, not executable, or errored). Initialization aborts so later calls fail fast with a clear cause instead of per-command surprises.

Source

Thrown at v3/plugins/gastown-bridge/src/bridges/gt-bridge.ts:374

    this.config = {
      gtPath: config?.gtPath ?? 'gt',
      cwd: config?.cwd ?? process.cwd(),
      timeout: config?.timeout ?? 30000,
      maxBuffer: config?.maxBuffer ?? 10 * 1024 * 1024,
      env: config?.env ?? process.env,
      defaultNetwork: config?.defaultNetwork ?? 'mainnet',
    };
    this.logger = logger ?? defaultLogger;
  }

  /**
   * Initialize the bridge and verify gt is available
   */
  async initialize(): Promise<void> {
    try {
      const result = await this.execGt(['version']);
      if (!result.success) {
        throw new GtBridgeError(
          'Failed to verify gt installation',
          'COMMAND_NOT_FOUND',
          'gt',
          ['version']
        );
      }
      this.initialized = true;
      this.logger.info('Gas Town bridge initialized', {
        gtPath: this.config.gtPath,
        version: result.data,
      });
    } catch (error) {
      if (error instanceof GtBridgeError) throw error;
      throw new GtBridgeError(
        'Failed to initialize Gas Town bridge',
        'COMMAND_NOT_FOUND',
        'gt',
        ['version'],

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Install the required CLI/tool and ensure it is on PATH; re-run the verification command manually to confirm.

When it happens

Trigger: Thrown at v3/plugins/gastown-bridge/src/bridges/gt-bridge.ts:374 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/481c3a2f6ef2df95. Report an issue: GitHub.