fus

Fus

Universal development toolset plugin for Claude Code and Codex.

Project Overview

Fus is a plugin that provides comprehensive skills for software development, covering the full development lifecycle from design to verification. Supports both Claude Code and Codex.

Structure

fus/
├── .claude-plugin/           # Claude Code plugin metadata
├── .codex/                   # Codex config and installation guide
├── .copilot/                 # VSCode Copilot installation guide
├── codex-agents/             # Codex multi-agent configuration (TOML)
├── copilot-agents/           # Copilot custom agents (.md)
├── agents/                   # Agent reference docs (for skills)
├── commands/                 # CLI commands
├── skills/                  # Skill definitions (30+ skills)
├── packages/
│   └── fus-cli/            # Plugin management CLI
└── docs/                    # Documentation

Documentation

• Codex Guide
• Copilot Guide
• Fus CLI Usage
• AGENTS.md / CLAUDE.md Guidance
• AGENTS.md
• CLAUDE.md

Quick Install

For Claude Code

Manual Install

Claude Code Plugin

For Codex (Skills)

Fetch and follow instructions from https://raw.githubusercontent.com/Genuineh/fus/refs/heads/main/.codex/INSTALL.md

For Codex (Multi-Agent)

Copy the Codex config to your project or user directory:

# For project-specific agents
mkdir -p .codex
cp .codex/config.toml .codex/
cp -r codex-agents/ .codex/

# Or for user-wide agents
mkdir -p ~/.codex
cp .codex/config.toml ~/.codex/
cp -r codex-agents/ ~/.codex/

Then enable multi-agent in Codex and restart.

For VSCode Copilot

See .copilot/INSTALL.md for installation.

# Quick install
mkdir -p .github/agents
cp copilot-agents/*.md .github/agents/

Quick Install for Codex

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/Genuineh/fus/refs/heads/main/.codex/INSTALL.md

Modules

• @fus/plugin - Claude Code plugin with agents and skills
• @fus/cli - Plugin management CLI tool

Fus Plugin

Fus provides 30+ skills for full-stack development:

Core Skills

Skill	Description
fus-lead	Task orchestration, workflow management
fus-agents	Agent reference guide
plan	Task planning

Domain Skills

• Documentation (docs-*): docs-general, docs-todo, docs-prds, docs-specs, docs-guide, docs-adr
• Backend (backend-*): backend-principles, backend-database, backend-microservices, backend-queue, backend-api, backend-cache, backend-rust
• Frontend (frontend-*): frontend-general-principles, frontend-tauri-native, frontend-framework-nextjs, frontend-state-management, frontend-styling-twind, frontend-api-integration, frontend-design
• Design (design-*): design-foundations
• Testing (test-*): test-frontend-unit, test-e2e
• Project (project-*): project-rust
• Product (product-*): product-principles, product-ux

Project Guidance

If you use Fus in another repository, keep project-level agent instructions in AGENTS.md and/or CLAUDE.md, and keep them aligned with the detailed guidance in docs/guide/agent-system-guidance.md.

Fus CLI

Fus CLI is used to manage Claude Code plugins.

# Interactive menu
cd packages/fus-cli && node dist/index.js

# Command line
cd packages/fus-cli && node dist/index.js list

Quick Start

Installation

# Clone the repository
git clone https://github.com/your-repo/fus.git

# Navigate to project
cd fus

# Install dependencies
pnpm install

Use in Claude Code

Option 1: Use Plugin Directory

# Set plugin directory when starting Claude Code
claude --plugin-dir .

Option 2: Copy to Claude Code Plugins

# Copy plugin to Claude Code plugins directory
cp -r . ~/.claude/plugins/fus

Use in Codex

See .codex/INSTALL.md for detailed installation instructions.

# Quick install
git clone https://github.com/Genuineh/fus.git ~/.codex/fus
mkdir -p ~/.agents/skills
ln -s ~/.codex/fus/skills ~/.agents/skills/fus

Then restart Codex to discover the skills.

Using the Plugin

Once installed, you can interact with the plugin through natural language:

Use fus-lead Skill

I need to implement a new feature: user authentication system.

The fus-lead skill will:

1. Clarify requirements if needed
2. Help plan and decompose the task
3. Guide you through the appropriate workflow
4. Track progress

Invoke Specific Agent

Use the architect agent to design a microservices architecture for the payment system.

Use the developer agent to implement the user login API endpoint.