Ruby Support in Maguyva: Code Graphs for Rails and Ruby Apps

Why Ruby repos are hard for shallow AI tools

Ruby leans on convention and metaprogramming. Methods are generated by attr_accessor, classes reopen in other files, and namespaces nest several modules deep. The readable surface hides which method a call actually reaches, and blunt text search returns every call and perform in the app.

Maguyva gives an agent classes, modules, methods, and their callers as structure, so it can follow a change through the app instead of guessing.

What Maguyva extracts in Ruby

Maguyva covers .rb, .rbw, .rake, and .gemspec files, plus Gemfile and Rakefile. Instance methods and singleton methods (def self.call) are extracted, with singleton methods marked as static. attr_reader, attr_writer, and attr_accessor declarations count as accessor methods, and symbols are qualified by their module and class namespace.

ClassName.new and Namespace::ClassName.new count as instantiation, and receiver typing follows local assignments and @instance_variables, so a call on an assigned object can resolve to its class. The graph also records inheritance, module inclusion, overrides, raise and rescue edges, and reads and writes.

Metaprogramming calls (define_method, send, method_missing, class_eval, and similar), Sorbet T:: type helpers, and common enumerable calls (each, collect, reject, and similar) are filtered from relationships so application code stands out.

Example agent prompts

• “Who calls Billing::ChargeCustomer.call, and from which jobs and controllers?” (find_symbol, then dependency_search incoming)
• “Which models inherit from ApplicationRecord and include Auditable?” (dependency_search)
• “Trace what happens after an order is marked paid.” (get_task_context)

Known limits

• require and load are ordinary method calls in Ruby, so the imports preset in structural_search selects nothing. Use text_pattern_search to list them.
• Methods created at run time with define_method or handled by method_missing are not extracted as symbols, and those calls are filtered as metaprogramming noise.
• Ruby has no decorator syntax, so decorator relationships are marked not applicable.

Next steps

Connect a repository with the quickstart, then check the support matrix on the compatibility page. For other dynamic-language repos, compare the Python guide.