# Global installation
npm install -g claude-role-library

# Or use directly with npx
npx claude-role-library

# Clone the repository
git clone https://github.com/user/claude-role-library.git
cd claude-role-library

# Install dependencies
bun install

# Run the server
bun run start

# Run in development mode (with hot reload)
bun run dev

# Run all tests
bun test

# Run tests in watch mode
bun test --watch

# Run specific test file
bun test src/schemas/role.test.ts

{
  "mcpServers": {
    "claude-role-library": {
      "command": "npx",
      "args": ["claude-role-library"]
    }
  }
}

{
  "mcpServers": {
    "claude-role-library": {
      "command": "bun",
      "args": ["run", "/path/to/claude-role-library/src/index.ts"]
    }
  }
}

# List all available roles
/roles list

# Search for specific roles
/roles search "code review"

# Apply a role to the current session
/roles use senior-code-reviewer

# Manage favorites
/favorites list
/favorites add senior-code-reviewer

~/.config/claude-role-library/
├── config.yaml           # Global configuration
├── sources.yaml          # External source definitions
├── favorites.yaml        # Favorited roles
└── roles/                # Role definitions
    └── *.yaml

{project}/.claude-role-library/
└── favorites.yaml        # Project-specific favorites