ruvnet/ruflo · error

[TeammateBridge] TeammateTool not available. Requires Claude

Error message

[TeammateBridge] TeammateTool not available. Requires Claude Code >= ${MINIMUM_CLAUDE_CODE_VERSION}, found: ${this.claudeCodeVersion ?? 'not installed'}

What it means

Capability check in TeammateBridge.initialize(): after probing the installed Claude Code version, compareVersions found it older than MINIMUM_CLAUDE_CODE_VERSION (or Claude Code is not installed), so TeammateTool is marked unavailable. The bridge still initializes and emits 'initialized' with teammateToolAvailable=false.

Source

Thrown at v3/plugins/teammate-plugin/src/teammate-bridge.ts:361

        this.teammateToolAvailable =
          compareVersions(this.claudeCodeVersion, MINIMUM_CLAUDE_CODE_VERSION) >= 0;
      }
    } catch {
      this.claudeCodeVersion = null;
      this.teammateToolAvailable = false;
    }

    this.initialized = true;

    const versionInfo = this.getVersionInfo();

    this.emit('initialized', {
      claudeCodeVersion: this.claudeCodeVersion,
      teammateToolAvailable: this.teammateToolAvailable,
    });

    if (!this.teammateToolAvailable) {
      console.warn(
        `[TeammateBridge] TeammateTool not available. ` +
        `Requires Claude Code >= ${MINIMUM_CLAUDE_CODE_VERSION}, ` +
        `found: ${this.claudeCodeVersion ?? 'not installed'}`
      );
    }

    return versionInfo;
  }

  /**
   * Get version information
   */
  getVersionInfo(): VersionInfo {
    const missingFeatures: string[] = [];

    if (!this.teammateToolAvailable) {
      missingFeatures.push('TeammateTool', 'team_name', 'launchSwarm');
    }

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Upgrade Claude Code to at least the required minimum version to enable TeammateTool.
2. If upgrade is not possible, disable the teammate bridge feature gracefully.
3. Verify Claude Code is installed and detectable on PATH if the version reads as 'not installed'.

When it happens

Trigger: TeammateBridge initializes on a host whose Claude Code version is below the required minimum or not installed; TeammateTool is unavailable and the bridge reports the found version.

Common situations: See trigger scenarios.

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