Bare metal Zig, without the bare metal pain.
rvkit is a CLI/TUI toolchain for Zig developers targeting RISC-V microcontrollers.
No more manual linker scripts, no more fighting your toolchain — just code, build, flash, monitor.
Setting up a bare metal Zig project on RISC-V is painful :
- Manual memory address configuration
- Board-specific linker scripts to write from scratch
- Fragmented toolchain (flash tool here, monitor there)
- No equivalent to Arduino or PlatformIO for Zig
rvkit fixes this. One command to scaffold a ready-to-build project, one command to flash, one command to monitor.
rvkit new --board ch32v003 my_project
cd my_project
# ... write your Zig code ...
rvkit flash
rvkit monitor| Board | Architecture | Flash tool | Status |
|---|---|---|---|
| CH32V003 | RISC-V 32bit (RV32EC) | wlink (WCH-LinkE) | Supported |
| ESP32-C3 | RISC-V 32bit (RV32IMC) | esptool | Experimental — scaffolding only, flash not implemented yet |
More boards coming — including custom Open & Hack boards.
| Command | Description |
|---|---|
rvkit new --board <target> <name> |
Scaffold a new Zig project for the target board |
rvkit build |
Build the project using the Zig toolchain |
rvkit flash |
Flash the firmware to the board |
rvkit monitor |
Open the serial monitor |
rvkit doctor |
Check that required tools are installed |
rvkit boards |
List all supported boards |
Download the binary for your platform from the latest release:
| Platform | Binary |
|---|---|
| Linux x86_64 | rvkit-linux-x86_64 |
| Linux ARM64 | rvkit-linux-aarch64 |
| Windows x86_64 | rvkit-windows-x86_64.exe |
| macOS Intel | rvkit-macos-x86_64 |
| macOS Apple Silicon | rvkit-macos-aarch64 |
Linux / macOS:
chmod +x rvkit-*
sudo mv rvkit-* /usr/local/bin/rvkitWindows:
Rename the file to rvkit.exe, move it to a folder of your choice (e.g. C:\Tools\rvkit\), and add that folder to your PATH.
Linux only: install build dependencies first:
sudo apt install libudev-dev pkg-config # Debian/Ubuntu
sudo dnf install systemd-devel pkg-config # Fedoragit clone https://github.com/karagure/rvkit.git
cd rvkit
cargo install --path clirvkit --versionA project generated by rvkit new looks like this :
my_project/
├── rvkit.toml ← project config (board, flash port, baud rate)
├── build.zig ← Zig build script (preconfigured)
├── src/
│ ├── main.zig ← your code starts here
│ └── start.zig ← startup code: stack, .data/.bss init (generated)
└── linker/
└── ch32v003.ld ← linker script (generated, don't edit)
[project]
name = "my_project"
board = "ch32v003"
# Optional: serial port settings used by `rvkit monitor`
[flash]
port = "/dev/ttyUSB0" # COM3 on Windows
baud_rate = 115200- Do one thing well — scaffold, build, flash, monitor. Nothing more.
- Zero surprise dependencies — rvkit tells you exactly what it needs.
- Your editor, your choice — rvkit does not replace ZLS or your IDE.
- Rust stable only — no nightly, easier to maintain and contribute.
- Linux first — macOS and Windows best-effort support.
- Project scaffolding (CH32V003, ESP32-C3)
- Build integration
- Flash via wlink (CH32V003)
-
rvkit boardscommand - Flash via esptool (ESP32-C3 — experimental, not implemented yet)
- TUI serial monitor (ratatui)
- Template auto-update
- add dev board proposed by community (pico 2)
- Custom Open & Hack boards support
Contributions are welcome ! Please open an issue before submitting a PR.
This project follows the Zig community Code of Conduct.
MIT — see LICENSE
rvkit is built with ❤️ in Rust and Zig by Open & Hack