Matz

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

How can I try Matz?

SSH

The quick way is 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

Local

Matz also ships as a small terminal binary. Set a DeepSeek API key and run it locally.

$ fetch https://github.com/4-4BSD/matz/releases/download/latest/matz
$ chmod +x matz
$ export DEEPSEEK_SECRET="sk-..."
$ ./matz

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'

What makes Matz different?

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

How it works

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