matz

matz teaches mruby by answering questions from the mruby guide repository, indexed mruby source code, and mrbgem metadata.

Quick start

SSH

The easiest way to try matz is via SSH. No signup. No account. Nothing to install.
If you're not sure what matz is, this is a good way to find out. 🙂

$ ssh matz@r.uby.dev

HTTP

The same mruby reference material is also exposed through JSON endpoints for scripts, terminals, and agents.

##
# List mruby guides
$ fetch -qo - 'https://r.uby.dev/api/guides/index'

##
# Search mruby source
$ fetch -qo - 'https://r.uby.dev/api/mruby/search?q=mrb_gc'

Features

Publically accessible via SSH
matz is available for anyone to use, for free, over SSH.
Focused on mruby
matz treats mruby guides, source code, and mrbgems as first-class reference material.
Grounded answers
Answers must be sourced from available guide, source, and mrbgem tool results.
Terminal-native
matz runs in your terminal, streams output as it works, and exposes the same reference material through HTTP+JSON.
Read-only by design
The public tools inspect hosted mruby material. They do not read or write your local filesystem.
Small deployment model
The local build is a statically linked, self-contained binary with no Node.js, Electron, or browser runtime.

Abilities

matz chains these read-only tools against hosted mruby guide, source, and mrbgem data.

Name	Purpose	Confirmation
`guide-index`	List available mruby guides.	No
`guide-search`	Search the mruby guide repository.	No
`guide-read`	Read guide content by filename.	No
`gem-index`	List known mrbgems.	No
`gem-search`	Search known mrbgems by name.	No
`gem-read`	Read metadata for a known mrbgem.	No
`mruby-index`	List indexed mruby source files.	No
`mruby-search`	Search indexed mruby source files.	No
`mruby-read`	Read an indexed mruby source file.	No
`version`	Report matz's version number.	No

Under the hood

mruby-llm runtime
matz is built on mruby-llm, the mruby port of llm.rb.
Cooperative scheduler
Long-running calls execute in worker tasks while the terminal interface stays responsive.
Guide integration
matz can list, search, and read the mruby guide repository.
mrbgem integration
matz can list known mrbgems and read mrbgem metadata when a question involves packages or extensions.
Source integration
matz can list, search, and read indexed mruby source files when implementation details matter.

Build from source

matz is an mruby gem built with the mruby-llm runtime.

$ git clone https://github.com/4-4BSD/matz.git
$ cd matz
$ make

FAQ

Where does the name "matz" come from?

matz is named in honor of the creator of (m)ruby: Yukihiro "matz" Matsumoto.
It is an independent open source project.
It is not affiliated with or endorsed by him.