What's New

🚀 Rails MCP Server Integration

ClaudeOnRails now integrates with Rails MCP Server to provide your AI agents with real-time access to Rails documentation and best practices!

✨ Key Features

• Interactive Setup: Just press Y during generation to set up MCP Server
• Enhanced Documentation Access: Agents can query Rails guides in real-time
• Automated Installation: No manual npm/gem commands needed
• Smart Detection: Automatically configures when MCP Server is available

🛠️ Setup

# During generation, you'll be prompted:
rails generate claude_on_rails:swarm
# Press Y to set up Rails MCP Server\!

# Or set up later:
rails claude_on_rails:setup_mcp

# Check status:
rails claude_on_rails:mcp_status

🐛 Fixes

• Fixed RDoc version conflicts during installation
• Improved MCP availability detection
• Added --no-document flag to avoid documentation generation issues

📚 Documentation

• Added comprehensive SETUP.md guide
• Updated README with MCP integration details
• Enhanced all agent prompts with MCP capabilities

💎 Installation

gem 'claude-on-rails', '~> 0.2.0'

Thanks to @mariochavez for the excellent Rails MCP Server!

What's Changed

🐛 Bug Fixes

• Fixed CLAUDE.md overwriting user's existing directives
• Fixed swarm configuration filename (now correctly uses claude-swarm.yml)
• Fixed file reference syntax (now uses @file instead of /file)

🚀 Improvements

• ClaudeOnRails context now stored in .claude-on-rails/context.md
• CLAUDE.md uses file references instead of appending content
• Updated documentation to clarify prompts vs commands
• Fixed all RuboCop linting issues

📋 Requirements

• Updated required Ruby version to 3.3.0
• Moved development dependencies to Gemfile

🔧 Technical Details

The key improvement in this release is that ClaudeOnRails no longer overwrites existing CLAUDE.md files. Instead, it:

1. Creates a separate context file at .claude-on-rails/context.md
2. Uses Claude's file reference syntax (@.claude-on-rails/context.md) to include it
3. Preserves all existing user configuration

This ensures users never lose their custom CLAUDE.md directives when installing or updating ClaudeOnRails.

Full Changelog: v0.1.3...v0.1.4

🛡️ Stability Improvements

This release fixes critical issues that prevented the swarm from starting properly.

Fixed

• Directory Safety: Only create swarm agents for directories that actually exist
  • No more failures when app/services, app/jobs, etc. don't exist
  • Generator checks each directory before including the agent
• Model Compatibility: Fixed model names to work with claude-swarm
  • Changed from claude-3-5-haiku-20250110 to haiku
  • Default model is now opus for better capabilities
• Dynamic Connections: Controllers only connect to services if the directory exists

Improved

• Generator now shows which agents will be created during analysis
• Better error prevention through proactive directory checking
• Cleaner generated YAML with only relevant agents

Example Output

Analyzing Rails project structure...
Project type: Full-stack Rails
Test framework: RSpec

Agents to be created:
  - architect
  - models
  - controllers
  - views
  - tests
  - devops

Upgrade Instructions

bundle update claude-on-rails
rm -f claude-swarm.yml CLAUDE.md && rm -rf .claude-on-rails/
rails generate claude_on_rails:swarm

Note: This is still an experimental release. We're rapidly improving based on user feedback!

🐛 Bug Fix Release

This release fixes critical issues with the Rails generator that prevented proper setup.

Fixed

• Generator now properly requires the claude_on_rails module
• Generated configuration file renamed to claude-swarm.yml (was swarm.yml)
• Removed incorrect orchestrate command references from documentation
• Removed redundant gem installation instructions
• Fixed missing agent prompt templates
• Corrected prompt syntax examples to use > prefix

Added

• Complete prompt templates for all agent types:
  • views (Rails views and frontend)
  • api (RESTful API development)
  • jobs (Background job processing)
  • devops (Deployment and infrastructure)
  • graphql (GraphQL API development)
  • stimulus (Turbo/Stimulus frontend)

Installation

gem 'claude-on-rails', '~> 0.1.2'

Usage

# In your Rails project
rails generate claude_on_rails:swarm
claude-swarm

Note: This is still an experimental release. API and features are subject to change.

🐛 Bug Fix Release

This release fixes the dependency issue that prevented installation.

Fixed

• Corrected the claude_swarm gem dependency name (was incorrectly specified as claude-swarm)
• Updated documentation to clarify installation requirements

Installation

The gem should now install correctly:

gem 'claude-on-rails', '~> 0.1.1'

Thank you to early adopters who reported the installation issue!

Note: This is still an experimental release. API and features are subject to change.

🚧 Experimental Release

This is the first experimental release of ClaudeOnRails. The API and features are subject to change as we refine the framework based on user feedback.

What is ClaudeOnRails?

ClaudeOnRails leverages claude-swarm to create an intelligent team of AI agents specialized in different aspects of Rails development. Instead of manually switching between personas or contexts, you simply describe what you want to build in natural language, and the swarm handles the implementation across all Rails layers.

Key Features

• 🤖 Intelligent Agent Swarm: Specialized agents for models, controllers, views, services, tests, and more
• 🚂 Rails-Aware: Deep understanding of Rails conventions and best practices
• 🔍 Project Analysis: Automatically adapts to your project structure (API-only, full-stack, etc.)
• 💬 Natural Language Interface: Just describe what you want to build
• 🧪 Test-Driven: Automatic test generation for all code
• ⚡ Performance Focus: Built-in optimization capabilities

Installation

group :development do
  gem 'claude-on-rails'
end

Then:

bundle install
rails generate claude_on_rails:swarm
claude-swarm orchestrate

Usage Example

> Create a user authentication system with email confirmation
[The swarm automatically coordinates implementation across all layers]

> Optimize the dashboard - it's loading too slowly
[Performance improvements across models, queries, caching, etc.]

⚠️ Experimental Status

This is an early release. Expect:

• API changes in future versions
• Potential bugs and rough edges
• Need for manual adjustments to generated swarm configs
• Ongoing improvements to agent prompts and coordination

Requirements

• Ruby 2.7+
• Rails 6.0+
• claude-swarm gem
• Claude Code CLI

Feedback

Please report issues and feedback at: https://github.com/obie/claude-on-rails/issues

What's Next?

• Improved agent prompts based on real-world usage
• Better project detection and adaptation
• More specialized agents for common Rails patterns
• Integration with Rails MCP Server for documentation
• Community-contributed agent templates

Thank you for trying ClaudeOnRails! 🚂✨