A r.uby.dev project.

A knowledgeable mruby expert.

Matz can help by answering questions from the mruby guide repository, indexed mruby source code, and mrbgem index. He runs entirely in the terminal and ships as a statically linked, ~3MB binary built on mruby-llm.

He is the perfect aid for mruby development. He encourages you to write code and solve problems and if you get stuck he can help answer questions you might have.

Quick start

Accessible via SSH:

ssh matz@r.uby.dev

1. Download the latest release

fetch https://github.com/0x1eef/matz/releases/download/latest/matz
chmod +x matz

2. Set your DeepSeek API key

export DEEPSEEK_SECRET="sk-..."

3. Run it

./matz

Tools

Matz chains these tools autonomously. The tool surface is limited to hosted mruby guide, mruby source, and mrbgem data; it does not read or write your local filesystem.

Tool	Description	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

• Cooperative task scheduler

  The LLM call runs in a worker task while the event loop keeps the UI responsive.

• Streaming TUI

  Tokens arrive from the API and render incrementally in the chat widget, with live tool-call status.

• Guide integration

  Matz can list, search, and read the mruby guide repository, using guide results as sources for answers.

• mrbgem integration

  Matz can list known mrbgems and read mrbgem metadata when a question involves packages or extensions.

• mruby source integration

  Matz can list, search, and read indexed mruby source files when a question needs implementation details.

• Grounded answers

  The system prompt explicitly forbids using training data. Every answer must be sourced from available tool results. Off-topic questions are gently redirected.

Build from source

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

git clone https://git.home.network/0x1eef/matz.git
cd matz
make

The Makefile expects an mruby checkout at ../mruby. Override with MRUBY_DIR=/path/to/mruby if needed. Run make static for a statically linked binary (~3MB) or make for a dynamically linked one (~2MB).

License

0BSD. See LICENSE.