SkillAgentSearch skills...

Froxel

Voxel editor in Rust with a GPU path tracer, glTF export with bones, Rhai scripting, and an MCP server for AI agents. Opens MagicaVoxel .vox.

Install / Use

claude mcp add theromis -- npx -y github:theromis/Froxel

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

84/100

Supported Platforms

Claude Code
Claude Desktop

Our assessment of Froxel

Froxel scores 84/100 on our quality scale, 2776th of 4,698 Development & Engineering skills we index.

Its MCP Server is 17 KB long, well organised into 11 sections with 13 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated yesterday, so Froxel is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

Froxel compared with similar skills

All 4 of these similar skills score higher than Froxel; compare them before choosing.

SkillScoreStarsUpdatedFormat
Froxel (this skill)by theromis84101d agoMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install Froxel?
Run claude mcp add theromis -- npx -y github:theromis/Froxel. The install tabs above show the steps for each supported agent.
Which AI agents does Froxel work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is Froxel safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is Froxel still maintained?
The repository was last updated yesterday, so Froxel is actively maintained.
<p align="center"><img src="packaging/icons/hicolor/256x256.png" width="128" alt="Froxel"></p> <h1 align="center">Froxel</h1> <p align="center"> A voxel editor with a path tracer and an MCP server, written in Rust.<br> macOS, Windows, Linux, FreeBSD, Android, and iOS. </p> <p align="center"> <a href="https://github.com/theromis/Froxel/releases/latest"><b>Download</b></a> · <a href="#mcp-let-an-agent-build-models">MCP</a> · <a href="#scripting">Scripting</a> · <a href="#godot-and-blender">Bridges</a> · <a href="#command-line">Command line</a> · <a href="#build-from-source">Build</a> </p>

Froxel editing the frog: tools and palette on the left, the viewport with its skeleton, the inspector and the objects on the right

Froxel opens and saves MagicaVoxel .vox files, edits them with brushes, shapes, and selections, path-traces them on the GPU, and exports glTF with bones and animation clips. An AI agent can drive all of it through the built-in Model Context Protocol server.

Features

  • .vox in and out. Keeps groups, layers, hidden objects, animation frames, and materials (_diffuse, _metal, _glass, _emit). Files saved by Froxel open in MagicaVoxel.
  • Editing. Brush, line, circle, square, box, face fill, generators, mutators, marquee, box select, and flood select. Add, remove, and paint modes. Object mode moves, rotates, mirrors, and flips whole objects. Each stroke undoes in one step.
  • Characters. Bones, rigid binding of objects to bones, poses, and animation clips, saved in the .vox file and exported to glTF.
  • Render mode. A path tracer with sky, sun, metal, glass, and emission. It accumulates on the GPU through wgpu (Metal, Vulkan, DX12) and falls back to the CPU. Denoising is built in.
  • glTF export. .glb with merged coplanar faces, no T-junctions, and a palette texture or vertex colours.
  • Mesh import. A .glb, .gltf, or .obj sculpted in Blender or made by an image-to-3D tool, voxelized solid or as a shell at a cell count or a voxel size in metres, its texture and vertex colours quantized into the palette.
  • Scripts. Objects can carry a sandboxed Rhai script with sliders for its parameters.
  • Bridges. Godot and Blender can drive those sliders and import the mesh live, then bake a standalone scene. See docs/bridges.md.
  • Automation. An MCP server for agents and a command line for batch renders.
<p align="center"><img src="docs/images/turntable.gif" width="320" alt="The frog turning on a turntable, rendered frame by frame with froxel render"></p>

Install

Download the file for your system from the latest release.

| System | File | Notes | |---|---|---| | macOS 11+ (Apple silicon and Intel) | froxel-<version>-macos-universal.dmg | Signed and notarized. Drag Froxel to Applications. | | Windows (x64, x86, ARM64) | froxel-<version>-windows-<arch>.zip | Not signed yet (why). SmartScreen may ask once: choose More info → Run anyway. Windows 11 with Smart App Control on blocks it outright. | | Debian, Ubuntu (x86_64, aarch64, riscv64) | froxel-<version>-linux-<arch>.deb | sudo apt install ./froxel-*.deb adds the menu entry and icon. Needs Vulkan. | | Other Linux | froxel-<version>-linux-<arch>.tar.gz | Needs Vulkan and glibc 2.35 or newer (2.39 for riscv64). | | FreeBSD (x86_64) | froxel-<version>-freebsd-x86_64.tar.gz | | | Android 7.0+ (arm64) | froxel-<version>-android-arm64.apk | Open it on the phone. Android asks once to allow installs from the browser or file manager. | | iOS 16+ simulator | froxel-<version>-ios-simulator.zip | Unzip and drag Froxel.app onto a booted simulator. The device build goes to the App Store. | | Godot 4.3+ plugin | froxel-<version>-godot-addon.zip | Unzip into the project folder. See Godot and Blender. | | Blender 4.2+ add-on | froxel-<version>-blender-addon.zip | Preferences → Add-ons → Install from Disk. |

Every release has a SHA256SUMS.txt. How the builds are signed is in CODE_SIGNING.md.

Try it on the frog, examples/frog.vox, or on the scripted lily pad, tests/fixtures/examples/lily_pad.vox.

Phones and tablets

<img src="docs/images/ios.jpg" width="240" align="right" alt="Froxel on an iPhone: the frog with its skeleton, the file button above, and the tool, mode, colour and undo strip below">

The Android and iOS builds are the same editor with a touch layout. The viewport fills the screen. The strip at the bottom holds the tool, add, remove, and paint, the colour, and undo. The tool settings, the palette, and the files open as sheets above it. The bundled frog and lily pad are under the folder button, and your own files are saved to the app's documents.

  • One finger uses the active tool.
  • Two fingers orbit and pinch to zoom. Three fingers pan.
  • Long-press the colour, then tap a voxel, to pick its colour.

On a tablet 700 points wide or more, the desktop tools and palette sit on the left instead of the strip.

<br clear="right">

Controls

  • Right-drag orbits. Scroll zooms. Space-drag or middle-drag pans.
  • Left-drag uses the active tool.
  • V brush, L line, B box, F face, U mutator, M marquee.
  • T add, R remove, G paint. These three apply in Model mode.
  • Tab switches Model and Object mode.
  • In Object mode, X / Y / Z rotates the active object. Shift flips it.
  • ⌘Z / ⇧⌘Z undo and redo. ⌘C / ⌘X / ⌘V copy, cut, and paste.
  • ⌘N / ⌘O / ⌘S / ⇧⌘S new, open, save, and save as.
  • ⇧⌘E exports a glTF .glb with a palette texture and merged faces.

On Windows and Linux, use Ctrl in place of ⌘.

MCP: let an agent build models

froxel mcp is a Model Context Protocol server. An agent can create objects, place voxels, fill boxes and ellipsoids, set the palette, add bones and clips, run scripts, export .glb, and path-trace a PNG to check its work. The frog in these pictures was built this way.

Add it to Claude Code. On macOS, after installing from the dmg:

claude mcp add froxel -- /Applications/Froxel.app/Contents/MacOS/froxel mcp

Also install the agent skill, skills/froxel/SKILL.md, which tells the agent when and how to use the tools (block out, preview after every step, fit to reference views). Adding the server does not install it: copy the skills/froxel folder into ~/.claude/skills/, or without a clone:

mkdir -p ~/.claude/skills/froxel && curl -fsSL https://raw.githubusercontent.com/theromis/Froxel/main/skills/froxel/SKILL.md -o ~/.claude/skills/froxel/SKILL.md

Or add it to any MCP client's config:

{
  "mcpServers": {
    "froxel": {
      "command": "/path/to/froxel",
      "args": ["mcp"]
    }
  }
}

Then ask for a model:

Build a 16-voxel-tall voxel frog with big eyes and pink cheeks, give it a head and jaw bone, render it from the front, and export it to frog.glb.

froxel mcp works headless, with no window. To watch the edits happen, and let the agent take screenshots and click controls, connect it to an open editor:

froxel mcp --connect 127.0.0.1:7979 --launch

--launch opens the window if it is not already running. The full tool list and the connected mode are in docs/mcp.md.

Creatures and other one-off shapes are made by hand sculpting: block out with box and ellipsoid fills, refine single cells, render after every step, and compare with the reference. No script is stored. See docs/hand-sculpting.md.

Scripting

An object can carry a Rhai script. The editor shows a slider for each parameter, and Regenerate rebuilds the voxels. Scripts run in a sandbox with no file, network, or clock access, and saved files keep the voxels, so the .vox still opens in MagicaVoxel.

<img src="docs/images/lily-pad-script.jpg" width="200" align="right" alt="A lily pad generated by tests/fixtures/examples/lily_pad.rhai">
let radius = param_float("radius", 8.0, 3.0, 16.0);
let seed = param_int("seed", 1, 0, 9999);

set_slot(1, [18, 72, 28]);   // a palette colour
// …for each cell inside a wobbly disc:
set(ix, 0, iz, slot);

The whole lily pad is tests/fixtures/examples/lily_pad.rhai. Scripts also have the hand-sculpting tools (tubes, carving, smoothing, breaks, and debris); tests/fixtures/examples/hollow_log.rhai uses all of them, and tests/fixtures/examples/fallen_tree.rhai shapes a fallen tree with loft, deform, and brush. The API is in docs/scripting.md.

Godot and Blender

froxel bridge serves a .vox on 127.0.0.1. A Godot node or the Blender sidebar connects with the printed session file, shows a slider for each script parameter, and imports the model as glTF, bones and clips included. Moving a slider reruns the script. Bake writes an ordinary scene or Blender object that no longer needs Froxel, and headless Godot can bake a list of variants in one go. --bridge PORT serves the open editor instead, so edits in the window show up in the next import.

froxel bridge --input tests/fixtures/examples/lily_pad.vox      # four sliders: radius, notch, direction, seed
froxel --bridge 29771 tests/fixtures/examples/lily_pad.vox
<p align="center"> <img src="docs/images/godot-bridge.jpg" width="49%" alt="The lily pad's script sliders in the Godot inspector"> <img src="docs/images/blender-bridge.jpg" width="49%" alt="The lily pad's script sliders in the Blender sidebar"> </p>

The Godot plugin is godot/addons/froxel_bridge and the Blender add-on is blender/froxel_bridge. Both are in every release since 0.2.0 as froxel-<version>-godot-addon.zip and froxel-<version>-blender-addon.zip. Tested with Godot 4.5 and Blender 5.2. Setup, the variant baker, and the protocol are in docs/bridges.md.

Command line

froxel render path-traces a .vox file to a PNG with no window. The CPU tracer is the default, so a given seed always writes the same image. --gpu uses the wgpu tracer.

froxel render --input examples/frog.vox --output frog.png \
  --width 1440 --height 810 --samples 256 --denoise --gpu \
  --yaw -62 --pitch 16 --distance 0.72

The frog, path-traced in Froxel

That command made this picture. --help lists every option: camera, depth of field, sky, sun, glass mode, and albedo and normal passes. The turntable above is 48 such renders, one every 7.5° of --yaw.

Lily pad, lotus bank, reeds and a letter, rendered with froxel render

froxel preview draws the same .vox as the edit viewport lights it, rasterised on the CPU in a fraction of a second, fitted to the model (or --object) with a margin. docs/preview.md has the flags; MCP preview is the same image. --preset game is the gameplay camera (orthographic, yaw −135, pitch 32; --presets redefines it for a project, --placement-yaw sees an asset placed turned), and several --input files, --variants, or a --reference concept make a labelled contact sheet. --lighting old_pond (or a preset of your own) lights it with a game's sun, ambient, and grade instead of the viewport light. It prints two triangle counts: the unmerged mesh it draws, and what froxel export writes with the export flags given (--merge, --color-atlas).

froxel preview --input model.vox --out preview.png --yaw -35 --pitch 30 --width 1600 --height 800

`froxel compa

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryDevelopment
Updated1d ago
Forks0

Languages

Rust

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info