Ruby error tracking your coding agent can read

Updated 2026-11-13

Runheed accepts events from Sentry SDKs, so a Ruby app reports through sentry-ruby: point its DSN at your Runheed project and your coding agent reads each exception over MCP from Claude Code, Cursor or any MCP client. Tested with sentry-ruby 7.2 on Ruby 3.4. Rails apps add sentry-rails, which uses sentry-ruby underneath.

Set it up

  1. 1.Add the gem (and sentry-rails for a Rails app).

    Gemfileruby
    gem "sentry-ruby"
    # Rails:
    gem "sentry-rails"
  2. 2.Initialize it with the project's Sentry SDK DSN (Projects page, or ask your agent: runheed_list_projects). In Rails this goes in config/initializers/sentry.rb.

    config/initializers/sentry.rbruby
    # RUNHEED_SENTRY_DSN=https://<key>@runheed.com/<number>
    Sentry.init do |config|
      config.dsn = ENV["RUNHEED_SENTRY_DSN"]
      config.environment = ENV.fetch("RAILS_ENV", "production")
      config.release = ENV["GIT_SHA"]
    end
    
    # Anywhere you rescue an error you still want to see:
    begin
      apply_discount(order)
    rescue => e
      Sentry.capture_exception(e)
    end
  3. 3.Connect your agent, then sign in when it asks (other clients: /connect).

    terminalbash
    claude mcp add --transport http runheed https://runheed.com/api/mcp

The npm and PyPI releases are not out yet, so these commands install the same package files straight from runheed.com. Nothing else changes when the registry versions ship.

What it catches

  • Exceptions you report with Sentry.capture_exception(e)
  • Unhandled exceptions in Rails requests and Active Job, through sentry-rails
  • Release and environment from the config

What it does not do

  • Tracing, profiling and check-ins are accepted and dropped: Runheed tracks errors only

Then ask your agent

> what broke in production since the last deploy? fix the top one and resolve it with the commit hash

Connect Runheed first: Claude Code, Cursor or another client. Then see how the agent fixes and resolves an error.

Common Ruby errors

7-day trial, then $29/moOther agents and editorsCancel any time from the billing portal