Fuse Agents — AI skill for Claude Code

Fuse Agents Plugin

A cross-shell plugin (Bash & Zsh) that automatically fuses AI assistant configuration files (CLAUDE.md, GEMINI.md) into a unified AGENTS.md file with intelligent symlink management.

Features

• 🔍 Auto-detection: Detects CLAUDE.md and GEMINI.md files when you cd into directories
• 🔄 Auto-fusing: Automatically merges files using merge strategy (no prompts)
• 🔗 Intelligent Symlink Management: Creates CLAUDE.md → AGENTS.md symlinks; GEMINI.md is merged/renamed since it can read AGENTS.md directly; no GEMINI.md symlink is created if the file doesn't exist
• 📦 Smart Merging: Combines content from multiple AI assistant files
• 🎯 Zero Configuration: Works out of the box, no setup required

Installation

Option 1: Clone to Shell Plugins (Recommended)

# For Zsh users:
git clone https://github.com/EstebanForge/fuse-agents.git ~/.zsh/plugins/fuse-agents
echo 'source ~/.zsh/plugins/fuse-agents/fuse-agents.plugin.sh' >> ~/.zshrc
source ~/.zshrc

# For Bash users:
git clone https://github.com/EstebanForge/fuse-agents.git ~/.bash/plugins/fuse-agents
echo 'source ~/.bash/plugins/fuse-agents/fuse-agents.plugin.sh' >> ~/.bashrc
source ~/.bashrc

Option 2: Manual Installation

# For Zsh users:
mkdir -p ~/.zsh/plugins/fuse-agents
curl -o ~/.zsh/plugins/fuse-agents/fuse-agents.plugin.sh \
  https://raw.githubusercontent.com/EstebanForge/fuse-agents/main/fuse-agents.plugin.sh
echo 'source ~/.zsh/plugins/fuse-agents/fuse-agents.plugin.sh' >> ~/.zshrc
source ~/.zshrc

# For Bash users:
mkdir -p ~/.bash/plugins/fuse-agents
curl -o ~/.bash/plugins/fuse-agents/fuse-agents.plugin.sh \
  https://raw.githubusercontent.com/EstebanForge/fuse-agents/main/fuse-agents.plugin.sh
echo 'source ~/.bash/plugins/fuse-agents/fuse-agents.plugin.sh' >> ~/.bashrc
source ~/.bashrc

Option 3: Quick Install Script

# Run the installer
# Creates the rc file if missing (works on fresh machines)
curl -fsSL https://raw