gleam

Gleam Everything - Comprehensive Claude Code Plugin for Gleam Development

A complete Claude Code plugin providing best practices, patterns, workflows, and expert guidance for Gleam development.

Overview

This plugin equips Claude Code with comprehensive knowledge of Gleam programming, including:

• Official conventions and patterns from the Gleam team
• Best practices for web development, OTP, testing, and deployment
• Specialized agents for architecture, testing, OTP, and web development
• Quick commands for common workflows
• Context-aware guidance for different development scenarios
• Up-to-date information with links to authoritative sources

Features

🎯 Agent Skills (Auto-Invoked)

Claude automatically uses these skills based on context:

• gleam-web-development - Wisp, Mist, Lustre, REST APIs, Parse→Process→Present pattern
• gleam-otp-development - Actors, supervisors, fault tolerance, concurrent applications
• gleam-testing - Unit tests, integration tests, let assert (NOT deprecated should)
• gleam-deployment - Docker, Fly.io, production deployment
• gleam-package-development - Creating and publishing packages to Hex.pm
• gleam-javascript-interop - FFI, NPM packages, browser APIs
• gleam-erlang-interop - BEAM integration, Erlang/Elixir libraries

⚡ Slash Commands

Quick workflows via slash commands:

General:

• /gleam:new-project - Create new project with best practices
• /gleam:test - Run tests with proper configuration
• /gleam:format - Format code
• /gleam:build - Build and handle errors
• /gleam:add - Add dependencies

Backend (Wisp):

• /gleam:web-endpoint - Create web API endpoint with Parse→Process→Present pattern
• /gleam:otp-supervisor - Create OTP supervisor

Frontend (Lustre):

• /gleam:lustre-component - Create reusable UI component
• /gleam:lustre-page - Create new page with Model-View-Update pattern

🤖 Specialized Agents

Delegate complex tasks to specialized agents:

• gleam-architect - Architecture and design decisions
• gleam-test-specialist - Comprehensive test coverage
• gleam-otp-specialist - Concurrent and distributed systems
• gleam-web-specialist - Web APIs and HTTP services

Installation

Recommended: Via Marketplace (Easiest)

Install directly from GitHub using Claude Code's plugin system:

# Install directly from GitHub
/plugin install gleam@github:renatillas/gleam

Verify Installation

Check that Claude Code recognizes the plugin:

# Via CLI
claude plugin list

# Or in Claude Code
/plugin list

You should see gleam in the list.

MCP Integration

This plugin includes the gleam_packages MCP server which provides:

• Search for Gleam packages on hex.pm
• Get package information and documentation
• Browse modules, functions, and types
• Search within packages

The MCP server is automatically configured via .mcp.json and connects to: https://gleam-package-mcp.renata-amutio.workers.dev/

No additional setup required - Claude Code will automatically have access to Gleam package search and documentation!

LSP Integration

This plugin includes Gleam LSP (Language Server Protocol) configuration which provides:

• Go to definition
• Find references
• Hover documentation
• Code diagnostics and errors
• Auto-completion

The LSP server is automatically configured via .lsp.json. Requires gleam to be installed and available in your PATH.

Install Gleam:

# macOS
brew install gleam

# Linux
curl -sSL https://gleam.run/install.sh | sh

# Or download from https://gleam.run/getting-started/installing/

Team Distribution

To require this plugin for your team, add it to your project's .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "gleam": {
      "source": {
        "source": "github",
        "repo": "renatillas/gleam"
      }
    }
  },
  "enabledPlugins": {
    "gleam@gleam": true
  }
}

Team members will be prompted to install the plugin when they trust the project folder.

Validation and Testing

Test the plugin locally before distribution:

# Validate plugin structure and configuration
claude plugin validate .

# Or from within Claude Code
/plugin validate .

# Test locally with --plugin-dir flag
claude --plugin-dir ./gleam-claude-plugin

Usage

For Project-Specific Setup

The plugin works automatically once installed. For project-specific customization, you can create a CLAUDE.md or .claude/CLAUDE.md in your Gleam project root with project-specific information.

Using Slash Commands

After installation, all commands are available under the gleam namespace:

# General commands
/gleam:new-project my_app
/gleam:test
/gleam:format
/gleam:build
/gleam:add wisp

# Backend (Wisp) commands
/gleam:web-endpoint /api/users GET
/gleam:otp-supervisor worker_pool