Claude Code Swarm Features - Native Installation

Enable experimental swarm/multi-agent features in Claude Code using a pure in-memory bypass.

Quick Install

# Download the bypass script
mkdir -p ~/.claude/injectors
curl -o ~/.claude/injectors/feature-flag-bypass-pure.mjs \
  https://gist.githubusercontent.com/gastonmorixe/9c596b6de1095b6bd3b746ca3a1fd3d7/raw/feature-flag-bypass-pure.mjs

Usage

One-time run:

NODE_OPTIONS="--import $HOME/.claude/injectors/feature-flag-bypass-pure.mjs" claude

Silent mode (no [bypass] messages):

BYPASS_SILENT=1 NODE_OPTIONS="--import $HOME/.claude/injectors/feature-flag-bypass-pure.mjs" claude

Permanent Setup

Add to ~/.bashrc or ~/.zshrc:

# Claude Code with swarm features
alias claude-swarm='NODE_OPTIONS="--import $HOME/.claude/injectors/feature-flag-bypass-pure.mjs" claude'

# Silent version
alias claude-swarm-silent='BYPASS_SILENT=1 NODE_OPTIONS="--import $HOME/.claude/injectors/feature-flag-bypass-pure.mjs" claude'

Reload your shell:

source ~/.bashrc  # or ~/.zshrc

Now run:

claude-swarm

Fish Shell

Add to ~/.config/fish/config.fish:

function claude-swarm
    set -x NODE_OPTIONS "--import $HOME/.claude/injectors/feature-flag-bypass-pure.mjs"
    claude $argv
end

Requirements

• Node.js 18.19+ or 20.6+
• Native Claude Code installation (claude command available)

How It Works

The bypass intercepts fs.readFileSync calls and injects the tengu_brass_pebble feature flag into Claude Code's cached settings. This enables swarm/multi-agent features without modifying any files on disk.

Tradeoffs

⚠️ Telemetry is re-enabled - The bypass removes DISABLE_TELEMETRY environment variables because Claude Code skips reading cached feature flags when they're set.

Credits

Original bypass script by @gastonmorixe: https://gist.github.com/gastonmorixe/9c596b6de1095b6bd3b746ca3a1fd3d7